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.

​

Sidebar & Panels

Pentagon uses a three-panel layout: a sidebar on the left, the spatial canvas (or artifact viewer) in the center, and a detail panel on the right. Each panel can be toggled independently.

​

Sidebar (left)

The sidebar has two modes, switched via the toggle at the top:

• Conversations — the default chat-focused view described below
• Artifacts — file browser and Knowledge Base view (see Artifacts mode)

A gear icon next to the toggle opens workspace settings. In Conversations mode, the sidebar is a Slack-style list organized into collapsible sections:

​

Folders

The folders in your active map, with stacked avatars of agents that have access to each one. Click the gear icon to open map settings. Right-click a folder for a quick context menu.

​

DMs

Your direct conversations — both with agents and with human teammates in your organization. Each row shows:

• Avatar with a status dot (green = active, amber = needs input, red = error, gray = idle). Humans show a person icon; agents show their configured emoji.
• Name and conversation count if the participant has multiple threads
• Subtitle — the agent’s help reason, report summary, current task, or status (humans show the last message preview)
• Unread badge for new messages
• Running elsewhere indicator when an agent is actively responding in another conversation
• Timestamp of the last message

Click a row to open the conversation in the detail panel. Use the + button to start a new agent or DM a teammate — picking “DM a teammate” opens the new-DM composer in the right panel. Agents with multiple conversations expand to show each thread.

​

Groups

Multi-participant conversations — mix of agents and humans. Shows stacked avatars, the group title, participant count, and unread badge.

​

Search

The search field at the top filters across all sections — folders, agents, humans, and groups. Toggle the sidebar: Cmd+B

​

Canvas / Artifact Viewer (center)

The center panel shows either:

• The spatial canvas for the active map (when in Conversations mode)
• The artifact viewer showing the selected file or knowledge article (when in Artifacts mode)

Toggle the canvas: Cmd+E

​

Detail panel (right)

When you select an agent, the detail panel opens with four tabs:

​

Chat

Your conversation with the agent. Type messages, see responses in real time, review history.

• Focus the input with Cmd+L
• Search within the chat with Cmd+F
• Message queue indicator shows if the agent has messages waiting
• Activity indicator above the input shows when the agent is composing
• Image paste — paste or drag images directly into the chat. Attachments appear as a strip above the input.

​

Terminal

A standard terminal session that opens in the agent’s working directory. If the agent is in its own git worktree, this drops you straight into that directory — useful for inspecting files, running tests, or poking around the agent’s working copy.

​

Tools

Manage the MCP servers and skills attached to this agent. Add custom MCP servers, import skills from a URL, toggle them on or off. Tools assigned to an agent’s team are inherited automatically.

​

Settings

Configure the selected agent: See Agent Identity for details on Instructions, Soul, Purpose, and Memory. Toggle the right panel: Cmd+J

​

Status bar (bottom)

A thin strip at the bottom of the window shows:

• Instance count — how many agents exist in this workspace
• Active count — how many are currently responding (with a Stop all button when any are active)
• Waiting count — agents that have flagged for your input
• Panel toggles for sidebar / canvas / right panel
• App version

​

Workspace settings

Click the gear icon at the top of the sidebar (or press Cmd+,) to open settings. Settings open in a full-screen view covering the whole window — profile, organization, connectors, runtime, and per-workspace preferences.