Agent Files
Two-panel file manager in the Agent Detail Files tab for browsing, previewing, and editing agent workspace files.
How It Works
Open the agent detail page and click the Files tab.
The left panel displays a file tree with search and expandable directories.
The right panel shows a preview of the selected file.
Supported previews: images, video, audio, PDF, and text files.
Click the edit button on any text file to modify and save it inline.
Click New folder on any directory to create a subfolder in place (workspace-confined; edit-protected paths are rejected).
Delete files directly from the file manager. Protected path warnings appear for critical files.
Toggle Show hidden files to reveal dotfiles (.env, .claude/, etc.).
The agent workspace root is /home/developer/.
Content Folder Convention
The content/ directory is gitignored by default. Use it for large generated assets such as images, audio, and video.
Shared Folders
Agents can expose their workspace folder for other agents to mount as a collaboration mechanism.
GET/PUT /api/agents/{name}/folders, GET /api/agents/{name}/folders/available, GET /api/agents/{name}/folders/consumers.Outbound File Sharing
Agents can publish files to signed download URLs that work universally — web, Slack, Telegram, WhatsApp, email — without per-channel upload handling.
Enabling File Sharing
Open agent detail → Sharing tab
In the File Sharing panel, toggle Enable file sharing on
A restart-required banner appears — restart the agent to mount the publish volume
After restart, /home/developer/public/ is live
Sharing a File
From inside the agent via MCP share_file tool:
share_file({ filename: "report.csv" })
# Returns: { url, expires_at, size_bytes, mime_type }The agent drops the file into /home/developer/public/, calls share_file with the filename. Trinity extracts it, stores it securely, and returns a signed URL valid for 7 days.
From the UI:
410 Gone on download)Limits
| Max file size | 50 MB per file |
| Per-agent storage quota | 500 MB across all active shares |
| Default expiry | 7 days |
| Blocked types | Executables (PE/ELF/Mach-O), scripts with shebangs |
API Endpoints
| Endpoint | Method | Description |
|---|---|---|
| /api/agents/{name}/files | GET | List workspace files (tree structure) |
| /api/agents/{name}/files/download | GET | Download file content (100 MB limit) |
| /api/agents/{name}/files/mkdir | POST | Create a directory in the workspace |
| /api/agents/{name}/file-sharing | GET | File sharing status and quota |
| /api/agents/{name}/file-sharing | PUT | Enable or disable file sharing (owner/admin) |
| /api/agents/{name}/shared-files | POST | Mint a download URL for a file in /home/developer/public/ |
| /api/agents/{name}/shared-files | GET | List active shared files |
| /api/agents/{name}/shared-files/{id} | DELETE | Revoke a shared file |
| /api/files/{file_id}?sig={token} | GET | Public download endpoint |