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, switch the toggle on (it reads Enabled / Disabled)
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 (optionally display_name and expires_in). Trinity extracts it, stores it securely, and returns a signed URL valid for 7 days.
Opening a link. The link works wherever it is pasted, including in-app browsers on a phone (Telegram, iOS Safari): audio, video, images, and PDFs open inline and stream with range requests, so a voice note plays without a forced download. Anything that could carry script — HTML and SVG — is always delivered as a download. Append ?download=1to force a download for any file. A media player's chunked reads count as one download.
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 |
The signed URL is the only credential a download needs: it is not tied to a chat session or a verified email, so a recipient outside Trinity can open it. Revoke the link if it reaches the wrong hands.
API Endpoints
| Endpoint | Method | Description |
|---|---|---|
| /api/agents/{name}/files | GET | List workspace files (tree structure) |
| /api/agents/{name}/files | PUT | Save a text file (what the inline editor calls) |
| /api/agents/{name}/files | DELETE | Delete a file (protected paths are refused) |
| /api/agents/{name}/files/download | GET | Download file content (100 MB limit) |
| /api/agents/{name}/files/preview | GET | File content with its real MIME type, for previews |
| /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 / HEAD | Public download endpoint; supports Range requests; ?download=1 forces a download |