File Manager
A unified file system for organizing documents, agent outputs, and uploaded files
The File Manager provides a single place to organize all files in your workspace — uploaded documents, AI agent outputs, Collab docs, landing pages, and external links.
Spaces
Every workspace starts with three default spaces:
| Space | Privacy | Purpose |
|---|---|---|
| My Files | Private | Your personal files, visible only to you |
| Workspace Files | Workspace | Shared files accessible to all team members |
| Agent Outputs | Workspace | Files generated by AI agents (reports, exports, artifacts) |
File Structure
Files are organized in a tree structure with up to 4 levels of nesting:
Space (root)
> Folder
> Folder
> Folder
> File
Each node in the tree is a FileNode with a type:
- Space — root container (auto-created)
- Folder — organizational grouping
- File — points to actual content via a storage backend
Storage Backends
Files in Coherence don't store content directly — they point to content via a storage backend:
| Backend | Description |
|---|---|
| Spaces | Files uploaded to DigitalOcean Spaces (S3-compatible) |
| Collab Doc | Links to a Collab document |
| Agent Artifact | Links to an AI-generated artifact |
| Landing Page | Links to a generated landing page |
| External URL | Links to a file hosted elsewhere |
This means moving a file between folders never moves the underlying blob — only the pointer changes.
Privacy Levels
| Level | Visibility |
|---|---|
| Workspace | All team members can see the file |
| Team | Only members of a specific team can see it |
| Private | Only the creator and explicitly shared users |
Privacy cascades from parent to child. Moving a file into a private folder makes it private.
Sharing Files
Share individual files or folders with specific users:
- Right-click a file or folder
- Select Share
- Add team members by name or email
- They'll see the file in their Shared with me view
Favorites & Recent
- Star any file or folder to add it to your Favorites
- Recent shows files you've opened recently, sorted by last access time
Trash
Deleted files go to Trash for recovery:
- Files in Trash are soft-deleted (marked with a
TrashedAttimestamp) - Trash cascades — deleting a folder moves all children to Trash
- Restore files from Trash to their original location
- Permanently delete from Trash to remove the underlying storage
Search
Use the search bar in File Manager to find files by name across all spaces you have access to.
Permissions
| Permission | Roles |
|---|---|
files:manage | Admin, Owner — manage spaces and all files |
files:upload | All users — upload files to spaces they can access |