Skip to main content

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.

Agent Status

Every agent on the spatial canvas shows its state through two visual systems: status rings around the agent node, and sticky notes that surface details without you having to click anything.

Status rings

The ring around an agent’s avatar indicates whether the agent is working:
RingStatusWhat it means
Green (pulsing)ActiveThe agent is working — you’ll see the ring gently pulse
No ringIdleThe agent is ready but has nothing to do
Active agents show a green pulsing ring. Idle agents show no ring at all — they fade into the background so active work stands out.

Sticky notes

Sticky notes are annotation cards that appear next to an agent on the canvas. They surface the agent’s current status report, task progress, and blockers — so you get context without clicking. A sticky note shows:
  • Summary — the agent’s current status in its own words
  • Task progress — what it’s working on and how far along it is
  • Detail — extended notes or blockers
Sticky notes are connected to their agent by a dashed line and color-coded to match the agent’s accent color.

When sticky notes appear

Sticky notes show automatically based on your preferences in Settings:
  • All notes — master toggle to show or hide all sticky notes
  • Needs help — show when an agent flags for input (summary starts with a wave)
  • Completion — show when an agent finishes a task
You can dismiss a sticky note by clicking its close button. Sticky notes only appear when you’re zoomed in enough to read them.

Task progress badge

When an agent has tasks, a small badge on its node shows progress — for example, 3/7 means 3 tasks complete out of 7 total. This appears at zoom levels where the canvas is close enough to read. See Tasks & Progress for more on how tasks work.

Cross-conversation indicators

Agents often run in multiple conversations — a DM with you, a group thread, an agent-to-agent channel. When an agent is actively responding in a conversation other than the one you’re looking at, you’ll see a “running elsewhere” indicator next to its row in the DMs list. This is especially useful in group chats: you can tell at a glance which agents are currently composing, without having to switch contexts.

Stopping agents

Sometimes you want to pull the brake. Pentagon surfaces two ways to do it:
  • Terminate one agent — select the agent and press Cmd+R, or right-click the node and choose Delete.
  • Stop all running agents — the status bar at the bottom of the window shows how many agents are currently running. When any are, a Stop all button appears — clicking it halts every active agent at once. Use it when a group goes off track and you want a clean slate.

Next: Folder Access

Control which files and folders agents can access.