# Artifacts

> Charts, tables, pages and diagrams the agent makes for you, right in the chat.

Source: https://sesh.codes/docs/artifacts/

When an answer is easier to see than to read, an agent can make you an **artifact**: a chart, a table, a comparison, a mockup or a summary of results. It shows in the chat, and you can open it full size on any of your devices.

## Ask for one

Ask in plain words:

- "Chart the bundle size by route."
- "Put the three options side by side in a table, and let me pick one."
- "Mock up the settings page as a page I can look at."

The agent makes it with Sesh's tools, which are on by default. See [Agents that start sessions](https://sesh.codes/docs/agents-that-start-sessions.md#turn-them-on-or-off) to check.

## What you see

- **A card in the chat**, where the agent made it, with its title, its version and **Open**.
- **Open buttons under the reply.** When the turn ends, an **Open *title*** button for each artifact it made or changed sits under the agent's last reply, so you don't have to scroll back up.
- **The Artifacts menu** in the session's toolbar lists all of the session's artifacts, newest first.

On a Mac or iPad with room for both, **Open** puts the artifact in a column beside the chat, so you can keep talking about it. **Open Here** in its bar moves it to where the chat is, and **✕** closes it. On iPhone, or in a window too narrow for both, it shows where the chat is, full width; go back to the chat with the back button, or <kbd>Esc</kbd> on the Mac.

When the agent updates an artifact, it changes in place and its version goes up.

## Two kinds

| Kind | What it is |
|---|---|
| **Native** | Text, tables, bar and line charts, images and code, drawn with Sesh's own controls in your theme's colors. Looks at home on the Mac, iPhone and iPad. |
| **Page** | A web page the agent wrote, for what native parts can't show, like an interactive mockup. It follows your light or dark appearance. |

Pages are locked down. A page can't load anything from the internet or any address, can't keep anything after you close it, and can't go to another page.

## Answer from an artifact

Some artifacts have buttons, like "Go with B". Clicking one sends that choice to the agent as a message. If the agent is working, it waits in line like any message.

Click an image to see it full size. On iPhone and iPad, tap it.

## Diagrams in replies

Agents often draw diagrams as Mermaid code. Sesh shows those as diagrams in the reply, flowcharts, sequence diagrams and the rest. Switch between **Diagram** and **Code** above it.

## Good to know

- Artifacts are kept with the session on its machine. When the machine is offline, the card says so and shows the artifact once it's back.
- On Apple Watch, a session lists the titles of its artifacts. Open them on your iPhone or Mac.
- A session can hold up to 50 artifacts, each up to 2 MB.
- A dev server the agent starts is a different thing: open it with the globe. See [Dev servers](https://sesh.codes/docs/dev-servers.md).
