Each agent has its own isolated workspace on the filesystem. This is where the agent reads and writes files. Workspaces persist across conversations, so files created in one session are available in future sessions.

How storage is organized

Frona keeps two separate file areas:

• Agent workspaces at data/workspaces/{agent_id}/. Each agent has its own directory. Agents write files here using CLI, Python, or Node.js tools, and expose them to you using the produce_file tool.
• User files at data/files/{username}/. This is where your uploaded files live. When you upload a file in chat, it goes here.

Agents can read from both areas using virtual paths, if they have permission:

• user://username/report.pdf to read a file you uploaded
• agent://agent_id/output.csv to read a file another agent created

Uploading files

When you upload a file in the chat (drag and drop or the attachment button), it's stored in your user file area. You grant the agent permission to read it, and the agent can then access it during the conversation.

How agents create files

Agents create files in their own workspace using code execution tools (shell, Python, Node.js). When an agent wants to share a file with you, it uses the produce_file tool, which makes the file available as a downloadable attachment in the chat.

Browsing files

Use the workspace UI to browse files in an agent's workspace. You can:

• View the file list and directory structure
• Upload files
• Download files the agent created

Workspace layers

Agent workspaces have two layers:

1. Primary layer (read/write). The agent's own directory where it stores files.
2. Shared layer (read-only). Default files that ship with built-in agents, like prompt templates.

When an agent reads a file, it checks the primary layer first. If the file isn't there, it falls back to the shared layer. Writes always go to the primary layer. This lets agents customize defaults without modifying the originals.

Special files

Some files in the workspace have special meaning:

File	Purpose
AGENT.md	Custom agent instructions/prompt
HEARTBEAT.md	Checklist for heartbeat wake-ups

Next steps

• Working with Files. Details on file tools available to agents.
• Spaces. Shared conversation context (separate from workspaces).
• Creating & Configuring Agents. Agent settings and configuration.