Workspaces
A workspace is a directory on the filesystem that serves as an agent’s home. It’s where agents read and write files, and where you can upload documents for agents to work with. Each workspace provides persistent file storage that survives across conversations.
What workspaces are for
Section titled “What workspaces are for”- Storing files that agents create or modify
- Uploading documents for agents to process
- Providing persistent storage across conversations
- Giving each agent a filesystem boundary it operates within
Workspace structure
Section titled “Workspace structure”Each user has workspace storage at the path configured by FRONA_STORAGE_WORKSPACES_PATH (default: data/workspaces). Within this path, workspaces are organized by user.
Agents access workspace files through the read_file and produce_file tools, as well as the cli tool when file operations are needed.
File operations
Section titled “File operations”| Operation | How |
|---|---|
| Upload a file | Through the chat interface or API |
| Read a file | Agent uses read_file tool |
| Create a file | Agent uses produce_file or cli tool |
| Browse files | Through the workspace UI |
Workspaces vs Spaces
Section titled “Workspaces vs Spaces”Workspaces and Spaces are completely separate concepts. A workspace is about files and filesystem storage. A space is about grouping chats that share context. They don’t depend on each other.