--- title: "Consumer Brain — AVCodex Docs" description: "Consumer Brain — AVCodex documentation for AV integrators, programmers, and ops teams." lang: en json-ld: --- [](/) Solutions [Pricing](/pricing)[The Signal](/blog)[Resources](/resources) Learn [Free AI Assessment](/scorecard)[Get Started →](/pricing) [Documentation Home](/docs) Guides Getting Started - [The Alchemist Copilot](/docs/guides/the-alchemist-copilot) - [Choosing a Model](/docs/guides/choosing-a-model) - [Skills & Templates](/docs/guides/skills-and-templates) - [Pricing & Usage](/docs/guides/pricing-and-usage) - [Understanding Tokens](/docs/guides/understanding-tokens) - [Maximize AVCodex Capabilities](/docs/guides/maximize-avcodex-capabilities) Knowledge & Memory - [How Knowledge Sources Work](/docs/guides/how-knowledge-sources-work) - [Knowledge Retrieval Settings](/docs/guides/knowledge-retrieval-settings) - [User Memory](/docs/guides/user-memory) - [Consumer Brain](/docs/guides/consumer-brain) Agent Capabilities - [Image Recognition](/docs/guides/image-recognition) - [Image Generation](/docs/guides/image-generation) - [Video Generation](/docs/guides/video-generation) - [Deep Research and Deep Thinking](/docs/guides/deep-research-and-deep-thinking) - [Heartbeat (Proactive AI Outreach)](/docs/guides/heartbeat-proactive-ai-outreach) - [Database Connections](/docs/guides/database-connections) - [Agent-to-Agent Links](/docs/guides/agent-to-agent-links) - [Message Tagging](/docs/guides/message-tagging) - [Lead Generation Forms](/docs/guides/lead-generation-forms) - [Multilingual Apps](/docs/guides/multilingual-apps) - [Understanding Evaluations](/docs/guides/understanding-evaluations) Design & Experience - [Style Studio](/docs/guides/style-studio) - [Component Studio](/docs/guides/component-studio) - [HQ Profile](/docs/guides/hq-profile) - [Multiplayer Chat](/docs/guides/multiplayer-chat) - [Circles](/docs/guides/circles) - [Desktop Agent](/docs/guides/desktop-agent) Voice & Phone - [Phone Numbers](/docs/guides/phone-numbers) - [Outbound Calling](/docs/guides/outbound-calling) - [Voice Cloning](/docs/guides/voice-cloning) Publish & Share - [Embed Chat Widget](/docs/guides/embed-chat-widget) - [Custom Domains](/docs/guides/custom-domains) - [PWA Installation](/docs/guides/pwa-installation) - [AVCodex Sites](/docs/guides/avcodex-sites) - [Embed on Kajabi](/docs/guides/embed-on-kajabi) - [How to Use AVCodex with Claude Code](/docs/guides/how-to-use-avcodex-with-claude-code) Monetization & Access - [Selling Access](/docs/guides/selling-access) - [Consumer Monetization](/docs/guides/consumer-monetization) - [Access Control](/docs/guides/access-control) - [Bring Your Own Auth](/docs/guides/bring-your-own-auth) - [Clever SSO for Schools](/docs/guides/clever-sso-for-schools) Analytics & Operations - [Analytics & Chat History](/docs/guides/analytics-and-chat-history) - [Performance Dashboard](/docs/guides/performance-dashboard) - [Programmatic Usage Stats](/docs/guides/programmatic-usage-stats) - [Session Lifecycle Webhooks](/docs/guides/session-lifecycle-webhooks) - [Audit Logs](/docs/guides/audit-logs) Teams & White-Label - [Team Management](/docs/guides/team-management) - [Enterprise Whitelabel](/docs/guides/enterprise-whitelabel) Alchemist Platform - [Alchemist Tickets](/docs/guides/alchemist-tickets) - [Alchemist Getting Started](/docs/guides/alchemist-getting-started) - [Alchemist Working with Tickets](/docs/guides/alchemist-working-with-tickets) - [Alchemist Local Development](/docs/guides/alchemist-local-development) Alchemist Operations - [Alchemist Environment Variables](/docs/guides/alchemist-environment-variables) - [Alchemist Deploys and Domains](/docs/guides/alchemist-deploys-and-domains) - [Alchemist Self-Healing](/docs/guides/alchemist-self-healing) Alchemist API & Automation - [Alchemist API Keys](/docs/guides/alchemist-api-keys) - [Alchemist MCP Server](/docs/guides/alchemist-mcp-server) - [Alchemist Pipeline Configuration](/docs/guides/alchemist-pipeline-configuration) - [Alchemist Pipeline Permutations](/docs/guides/alchemist-pipeline-permutations) Developer Platform - [Building Custom MCP Servers](/docs/guides/building-custom-mcp-servers) - [Consumer OAuth for Custom MCP Servers](/docs/guides/consumer-oauth-for-custom-mcp-servers) AVCodex MCP Server - [Overview](/docs/guides/overview) - [MCP Reference](/docs/guides/mcp-reference) - [Setup & Installation](/docs/guides/setup-and-installation) - [Authentication](/docs/guides/authentication) - [Tools Reference](/docs/guides/tools-reference) - [Common Workflows](/docs/guides/common-workflows) - [Rate Limits](/docs/guides/rate-limits) Custom Actions Pro Actions API Builder API Agentic Commerce (ACP) Integrations [Docs](/docs)/ Guides / Knowledge & Memory # Consumer Brain Last updated · MAR 2026 · [Read as Markdown](/docs/guides/consumer-brain.md) Persistent file storage for the users of your AVCodex agent. Files survive across chat sessions and across agents in your workspace, so a tech, programmer, or client never starts from zero. Consumer Brain gives every user a persistent file space tied to their account. Files generated during a chat (a redrawn signal-flow diagram, a Q-SYS Lua snippet the agent produced, a punch list export) are saved automatically. Users can browse, organize, and pull those files into new conversations. > **Warning:** Consumer Brain requires a Studio Pro plan or higher. ## [What It Does# ](#what-it-does) Feature Description **Persistent storage** Files survive across multiple chat sessions. **File browser** Slide-out panel with search, sort, and folder organization. **Inline preview** View images, PDFs, CSV, JSON, and text without downloading. **Drag into chat** Reference a stored file in a new conversation by dragging it into the input. **Auto-save** Files produced by code execution are saved automatically. **Cross-agent access** Authenticated users see files from sibling agents in the same workspace. ## [Enabling Consumer Brain# ](#enabling-consumer-brain) **1\. Enable Persistent Storage** Open your agent's **Build** page, scroll to the **Code Execution** section, and toggle on **Enable Persistent Storage**. **2\. Configure Retention (optional)** Set **File Retention Days** to auto-delete after a window. Default is 0 (files live forever). A managed-services AV firm might set 365 days for client-facing agents and unlimited for internal programmer agents. **3\. Set Storage Limits (optional)** Set **Max Storage Per User** to cap each user. Default is 0 (unlimited). ## [How Users Use It# ](#how-users-use-it) ### [File Browser# ](#file-browser) Users open a slide-out storage panel from the chat interface. They can: - Browse files with search and sort. - Create folders (for example "BOS-HQ Refresh", "ACME Hospital", "Reusable Q-SYS Modules"). - Rename and delete files. - Preview inline (images, PDFs, spreadsheets, text). - Drag a file into the chat input to reference it in a new conversation. ### [Automatic File Saving# ](#automatic-file-saving) When the agent generates a file during a chat (a CSV of all rooms with mismatched firmware, a Markdown punch list, a generated Crestron SIMPL# stub), it lands in persistent storage automatically. The user does not have to download and re-upload it next time. ### [Cross-Agent File Sharing# ](#cross-agent-file-sharing) When users authenticate across multiple agents in the same workspace, they see files from sibling agents: - Cross-agent files show a badge indicating which agent created them. - Cross-agent files are **read-only** (rename and delete only on the original agent). - Fact-based memories from sibling agents automatically augment the system prompt. A field-tech who used the AV-helpdesk agent yesterday and switches to the project-management agent today can drag yesterday's commissioning notes into the new chat without leaving the platform. \#### Controlling Cross-Agent Sharing **Workspace level:** - In **HQ Settings -> Consumer Context**, toggle **Consumer Sharing** on or off for the whole workspace. **Per-agent level:** - Each agent can opt out via **Consumer Sharing Opt-Out**. - When opted out, files from that agent are not visible to users in other agents. ## [Storage Billing# ](#storage-billing) Consumer Brain storage is metered as part of your plan's usage: - Storage is measured in MB-months. - Only applies to authenticated users on Studio Pro or higher. - Free and lower tiers do not include persistent storage. ## [Troubleshooting# ](#troubleshooting) **Files not being saved?** - Verify **Enable Persistent Storage** is on in Build -> Code Execution. - Check the user has not exceeded the storage quota. **Cross-agent files not showing?** - Verify **Consumer Sharing** is on at the workspace level. - Confirm the agent has not opted out. - The user must be signed in to both agents. **File preview not loading?** - Large files take a moment. - Signed URLs expire after one hour. Refresh the page if a download link is stale. - Some binary formats do not support inline preview. > **Note:** Consumer Brain is part of the persistent storage system. Files generated during code execution are automatically saved when persistent storage is on. \*AVCodex · Your AV expertise. Amplified by AI.\* Was this helpful? [Edit this page →](#) [ Previous User Memory ](/docs/guides/user-memory)[ Next Image Recognition ](/docs/guides/image-recognition) On this page - [What It Does](#what-it-does) - [Enabling Consumer Brain](#enabling-consumer-brain) - [How Users Use It](#how-users-use-it) - [File Browser](#file-browser) - [Automatic File Saving](#automatic-file-saving) - [Cross-Agent File Sharing](#cross-agent-file-sharing) - [Storage Billing](#storage-billing) - [Troubleshooting](#troubleshooting) [](/) The AI platform built exclusively for professional AV. Build, deploy, and sell AI tools that understand your industry. ### Platform - What You Can Build - Templates - [Pricing](/pricing) ### Services - [Done-For-You](/pricing) - [Academy](/academy) - [Contact](/contact) ### Company - About - [The Signal](/blog) - [Docs](/docs) - [LinkedIn](#) © 2026 AVCodex. A Future Ready Holdings Inc. product. SOC 2 Type II Certified · HIPAA Compliant