Skip to main content
The Canvas is a directory the agent can drop files into and have them appear, typed and clickable, in the app provenance pane. Use it for plans, design docs, HTML reports, and small media. Markdown files written here show up the same way Plan Mode plans always have; Plan Mode is just one workflow that uses the Canvas.

​
Location

~/.replicas/canvas/ on the workspace VM. Files are listed in the Canvas tab at the bottom of the right-side provenance pane, beside Subagents and Terminal. Nested folders appear as expandable rows. Uploaded media appears in the expandable media folder. The agent’s live task checklist appears in chat as it is updated. Non-image files attached in chat are saved directly to ~/.replicas/canvas/ and appear in the Canvas tab. Click the paperclip menu in the chat composer, then choose Attach folder to attach a directory. Folder-relative paths are preserved under Canvas. Each folder selection is limited to 50 files and 50MB, with a 25MB limit per file. The Canvas replaces the older ~/.replicas/plans/ directory; the app, engine, and CLI all ship together, so existing workspaces pick up the new path on their next sandbox boot with no migration needed. If you have agents or scripts hard-coded against ~/.replicas/plans/, point them at ~/.replicas/canvas/ going forward.

​
Supported kinds

Clicking an item opens it in the main viewport. Markdown and Mermaid files have Raw and Formatted views. HTML renders inside a sandboxed iframe, PDFs and images render inline, and media plays in place. For uploaded images in the media folder, use the zoom buttons beside Download to scale the preview from 25% to 200%. To link a self-contained HTML page from a pull request, upload the same file with replicas media upload <page.html> --name "<name>" --access organization and use the printed Forge link. The page requires Replicas sign-in and membership in the workspace organization; public access is not supported for HTML. See the Media API for authenticated download and inline-preview URLs. Hovering a row in the Canvas list also reveals a download button on the right, so you can pull the original file out of the workspace without first opening it. Canvas items remain available after the workspace sleeps when Data Retention is enabled.

​
Size limits

Each item is capped at 25MB. Folder selections are additionally capped at 50 files and 50MB total. Items over 5MB remain available to the agent but cannot be previewed or downloaded through Canvas. Use replicas media upload to share larger media as an inline embed plus an app deep-link in chat; the artifact appears in the chat reply and the media folder in Canvas.

​
API

The Canvas is exposed by the API:
  • GET /v1/replica/{id}/canvas lists items
  • GET /v1/replica/{id}/canvas/{filename} reads one item