# Agent Artifacts

> An agent can show you what it just built (a dashboard, a chart, a report, a one-page HTML file) without you hunting for a file path in the terminal.

- Area: Desktop, mobile and web
- Plans: All plans
- Last checked against the product: 2026-11-05
- Web page: https://agentsroom.dev/docs/agent-artifacts

## What it does

An agent can show you what it just built (a dashboard, a chart, a report, a one-page HTML file) without you hunting for a file path in the terminal. When it is ready, a block appears above the agent's message box with the title of the page. One click opens it in a preview, and the page also joins the project's **Documents** list, with its earlier versions kept.

It works with every CLI that has an MCP client, so you get the same "artifact" experience with Claude Code, Codex, Gemini and the others, all on your own computer.

**Video (1:19):** [Agent artifacts, shown in the real app](https://youtu.be/4mkiFIGS_6Q). A Claude Code agent builds a dashboard, the block appears above its message box, a click opens the page, a correction updates it, the old version stays in Documents, then a Codex agent does the same.

## Where to find it

- **The block**: above the message box of the agent that presented the page ("Document shown by this agent"), with the title, the file name, the time ("just now") and a **Dismiss** cross.
- **The list**: right panel > **Documents**. The tab appears after the first presented document, and its pill shows how many documents the project has. See [Documents Panel](https://agentsroom.dev/docs/documents-panel.md).
- **Phone**: the same block above the message box in the agent's terminal.

## How to use it

1. In the agent's conversation, ask for the page, for example "build a dashboard of last week's sales as one HTML file and show it to me".
2. When the block appears above the message box, click it: the **Documents** tab comes forward (the right panel opens if it was folded) and the preview opens on the page.
3. Ask for a correction. When the agent presents the same file again, the block updates and the list keeps the previous version.
4. In **Documents**, hover the line: **Pin to the top**, **Versions** (unfolds Version 2, Version 1…, each one clickable, read-only) and **Remove from the list**.

**Dismiss** removes the block only. The document stays in **Documents**.

Each agent has one block: a new document replaces the previous block, and the previous document stays in the list.

If you are looking at another agent or another window, you get a banner (a click does the same as the block) and, depending on your notification settings, a push on your phone. Nothing opens on its own: the preview only opens on your click.

The help icon at the top of the **Documents** tab ("Watch the video tutorial on YouTube") opens the video.

## Settings

- `uiElements.rightPanel.tabDocuments` (global, Settings > Interface elements, "Documents"): shows or hides the Documents tab. When it is hidden, a click on the block still opens the preview in place.

## Agent tools (MCP)

- `view_present`: shows a file to the user as a block above the agent's message box and adds it to Documents (`path`, optional `title`, which defaults to the file name). It accepts HTML, images and SVG, PDF, Markdown, CSV and TSV; other files are refused with the list of accepted types. A file that contains a secret is refused. See [AgentsRoom MCP](https://agentsroom.dev/docs/agentsroom-mcp.md).

Agents are told to present what they deliver with this tool. If an agent only writes the file name in its answer, a file name in bold or italics in the conversation view still opens with a click.

## Providers

Every CLI connected to the AgentsRoom MCP server can present a page, and the list records the provider and model that really ran. Aider has no MCP client: it keeps the file path in its answer.

## Mobile

Same block above the message box, same words. A tap opens the viewer. A tap on the push opens the agent's terminal with the same page on top. There is no count badge on the phone: Documents is a line of the project's **…** menu. Dismissing the block on the phone does not remove it from the computer; dismissing it on the computer removes it from the phone.

## Limits

- The phone receives the page as one file and loads no neighbouring files (images, CSS, scripts, data). Ask the agent to put everything in one HTML file. The desktop loads neighbouring files from the page's folder, but not from above it (`../`).
- The block lives in memory and does not survive an app restart; the line in **Documents** stays.
- A project hosted over SSH with a local checkout: the agent writes on the host, the file does not exist on your computer, and the tool answers that it cannot find it.
- There is no share link: the page stays on the computer that holds it.
- A script inside a previewed HTML page is not isolated from your local files: only open pages from agents you trust.
- Desktop tested on macOS; nothing in the feature depends on the OS.

## Common questions

- **How do I see the page my agent built?** Ask it to "show it to me". A block appears above its message box: click it, the page opens in a preview and is kept in **Documents**.
- **I closed the block, is the page lost?** No. **Dismiss** only removes the block. Open the **Documents** tab in the right panel.
- **The agent wrote a file but no block appeared.** It did not call `view_present`. Ask it to show the file; with Claude Code, the tool may need to be loaded first, and the agent is told to look for it.
- **Can I see an older version after a correction?** Yes: in **Documents**, hover the line, then **Versions**.
- **Does it work with Codex or Gemini?** Yes, with every CLI that has an MCP client. Not with Aider.
- **Images are missing on my phone.** The phone loads only the page itself. Ask the agent for a single self-contained HTML file.
- **Is there a video that shows it?** Yes, a 1:19 video of the real app: https://youtu.be/4mkiFIGS_6Q

## Related

- [Documents Panel](https://agentsroom.dev/docs/documents-panel.md): the list where every presented page is kept, with pins and versions.
- [File Preview](https://agentsroom.dev/docs/file-preview.md): the preview that opens the page.
- [AgentsRoom MCP](https://agentsroom.dev/docs/agentsroom-mcp.md): the server that provides `view_present`.
- [Conversation View](https://agentsroom.dev/docs/conversation-view.md): where the block and clickable file names appear.
