> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryreplicas.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Canvas

> Files agents drop into the workspace for you to view in the dashboard.

The **Canvas** is a directory the agent can drop files into and have them appear, typed and clickable, in the dashboard provenance pane. Use it for plans, design docs, HTML reports, and small media. Markdown files written here show up the same way [Plan Mode](/features/workspaces/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 **Media**, **Subagents**, and **Terminal**. 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**, and each file retains the **5MB** per-item limit below.

The Canvas replaces the older `~/.replicas/plans/` directory; the dashboard, 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

| Extension                                        | Kind     | Pill  |
| ------------------------------------------------ | -------- | ----- |
| `.md`, `.markdown`                               | markdown | Plan  |
| `.html`, `.htm`                                  | html     | Page  |
| `.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.svg` | image    | Image |
| `.mp4`, `.webm`, `.mov`                          | video    | Video |
| `.mp3`, `.wav`, `.ogg`                           | audio    | Audio |

Clicking an item opens it in the main viewport: markdown renders with the same Plan viewer, HTML renders inside a sandboxed iframe, and media plays inline.

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](/admin/data-retention) is enabled.

## Size limits

Each item is capped at **5MB**. Folder selections are additionally capped at **50 files** and **50MB** total. For anything larger (screen recordings, big screenshots, generated videos) agents are guided to fall back to [`replicas media upload`](/features/cli), which uploads the file to Replicas storage and shares it back as an inline embed plus a dashboard deep-link in chat. You'll see the artifact in the chat reply and the workspace's **Media** artifact tab instead of in Canvas, while Canvas stays small enough to stream on every dashboard fetch.

## API

The Canvas is exposed by the [API](/features/api#canvas):

* `GET /v1/replica/{id}/canvas` lists items
* `GET /v1/replica/{id}/canvas/{filename}` reads one item