> ## 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

> See what every agent is doing at a glance from the spatial canvas

# 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:

| Ring                | Status | What it means                                           |
| ------------------- | ------ | ------------------------------------------------------- |
| **Green** (pulsing) | Active | The agent is working — you'll see the ring gently pulse |
| **No ring**         | Idle   | The 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](/workflow/tasks) 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.

<Card title="Next: Folder Access" icon="folder-open" href="/agents/folder-access">
  Control which files and folders agents can access.
</Card>
