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

# Artifacts Mode

> Browse, preview, and edit files your agents produce — side-by-side with their conversations

# Artifacts Mode

Your agents don't just talk — they produce work. Markdown documents, HTML pages, plans, specs, reports. Artifacts mode gives you a dedicated view for browsing and editing everything they've created, without leaving Pentagon.

## Switching modes

The sidebar has a mode toggle at the top with two options:

* **Conversations** — the default chat-focused view (folders, DMs, groups)
* **Artifacts** — a file browser for your map's folders

Click the toggle to switch. Your conversations stay put; switching is just a change of view.

## Browsing files

In Artifacts mode, the sidebar shows a tree view of your map's folders. Expand folders to drill down, click a file to open it in the detail panel.

* **Search** — the search field filters across file names
* **Knowledge articles** — agent knowledge bases also appear in the tree so you can read them alongside regular files

## Preview and edit

When you open a file, the detail panel renders it based on type:

| File type                    | What you see                                     |
| ---------------------------- | ------------------------------------------------ |
| **Markdown** (`.md`, `.mdx`) | Rendered preview with syntax-highlighted editing |
| **HTML**                     | Rendered page                                    |
| **Plain text / code**        | Syntax-highlighted source                        |

Markdown files save automatically as you type — no separate save step.

## Pop-out windows

For documents you want to keep visible while working elsewhere, click the pop-out button to open the artifact in a floating window. You can keep multiple artifacts open at once and arrange them however you like.

<Tip>
  Pop-outs are useful for reference documents — keep a spec or a plan visible while you chat with the agent executing it.
</Tip>

<Card title="Next: Sidebar & Panels" icon="columns-3" href="/workspace/panels">
  Understand Pentagon's panel layout.
</Card>