> ## Documentation Index > Fetch the complete documentation index at: https://panopticon-cli.com/llms.txt > Use this file to discover all available pages before exploring further. # Agents page > See what is running, what needs you and what is waiting at /agents; browse finished agents in History # Agents page Open `/agents` to see what your agents are doing right now. The **Live** view lists only work that is running or waiting: what is running and making progress, what needs you, and what is waiting in the pipeline. Finished work is in **History**, one link away in the top bar. The Agents page is an experimental surface. Turn on **Settings → Experimental features** to see it in the navigation. ## Live The top bar counts the rows: `● 2 live ◐ 1 need you ○ 3 waiting`. A zero count is dimmed. When something needs you, that count is the loudest thing on the bar; click it to jump to the section. The list has three sections, in this order: | Section | What is in it | | - | - | | **Needs you** | Something only you can move: a question, a permission prompt, a plan to approve, an agent you paused, a broken agent, or a PR ready to merge. The oldest wait is first. | | **Live** | Agents running a turn now, in the order they started, so rows stay put while agents work. When nothing runs, the section says **Nothing running right now.** | | **Waiting** | Work waiting on something you can name: in review, changes requested, CI running or failed, or held by Overdeck. The most recent activity is first. | Sessions with nothing to wait on (idle with no known blocker, or stopped) are not counted. They fold into one line at the bottom, `▸ 14 idle sessions · History`; click it to list them in place. The page remembers whether it is open. When nothing is running or waiting, the list is the whole page: one message, **Nothing is running or waiting. Finished work is in History.**, followed by the idle footer if any sessions are idle — never a preview pane alongside it. Each row says in words why it is where it is: | Reason | Meaning | | - | - | | **question waiting** | The agent asked you a question. The question shows under the row. | | **permission prompt** | The agent waits for you to allow a tool. | | **plan approval** | The agent waits for you to approve its plan. | | **paused by you** | You paused it. Your reason shows under the row. | | **API error or usage limit** | The provider, not the agent, is failing — including a conversation whose last turn ended in a provider error (billing, a usage limit) even though the session itself now looks idle. | | **stuck · idle ``** | The issue's work agent sat idle with unpushed commits past the stuck threshold. | | **ready to merge** | The PR is approved with green checks and waits for you to merge. | | **``**, **thinking**, **working** | The agent is running a turn: the row names the tool it is calling, with the tool's own description under it when it has one — for example, running `Bash`, the second line reads `Bash · Commit WI-7`. A working subagent keeps its parent from reading quiet: **quiet ``** replaces the age, never shows alongside it, once the whole row — the agent and every subagent under it — has been silent five minutes. | | **running on Fly** | The agent runs on a Fly machine, whose terminal is there. | | **held by Overdeck** | Overdeck paused it (a scheduler yield or another machine pause). | | **CI failed** | The PR's checks failed. The work agent gets the failure, not you. | | **changes requested**, **in review**, **CI running** | The PR is in the review pipeline. | | **idle — no known blocker** | The agent is alive but idle and nothing known is blocking it (in the idle line). | | **agent stopped** | The agent's pane is gone (in the idle line). | An issue's agent is named by its issue id and title; the role shows only when it is not `work`. The second line is the reason, then what the agent is doing or waiting on, then how long ago. A subagent shows as a `↳` line under the agent that started it, with `●` while it works; after three, the row says `+N more`. A gauntlet [lane](/reference/lanes) shows as a `↳` line under the conversation that launched it: `↳ i · `, with its report badge (`DONE`, `BLOCKED` or `FAILED`), under a lanes toggle on that row. Every lane line shows; the three-line cap applies to subagents only. A critic or verifier lane shows one indent deeper, directly under the builder it judges, with its verdict badge (`PENDING` until it files one). A lane that needs you also gets its own row in **Needs you**. A lane whose launcher is not on the page keeps its own row. A handoff or fork successor always keeps its own row, with a `continues ← #` link to the conversation it continues, so a live successor never hides under an ended predecessor. Click a row to preview it: the right pane shows its header, its issue and PR, and its live transcript, and the list stays in view. Use `↑` / `↓` to move the selection. **Open** (on the row you hover or select), `Enter` or a double-click goes to the agent's live session in its project's Command Deck, or to the conversation. Drag the divider to resize the panes; the sizes are remembered. The panel button in the top bar hides the preview pane and brings it back. A conversation's own Agents rail (its subagent list) starts collapsed in this preview, independent of whatever you left it at on the conversation's own page. ## What the colors mean Each row has one color, the same on both views: | Color | State | | - | - | | Blue | **Live**: a machine is running a turn. Running is blue, never green. | | Amber | **Needs you**: waiting for you to answer, approve, unpause or merge. | | Red | **Stuck or broken**: stuck, an API error, or CI failed. | | Grey | **Waiting** and idle: held, in review, idle or stopped. In History, remote agents are grey too. | | Emerald | **Done**: a subagent, worker or external agent finished. | ## History **History** (`/agents?view=history`) lists every agent Overdeck knows about, finished ones included: work, review, plan and strike agents, workers, `pan spawn` panes, your conversations, the subagents they started, and external agents that other tools launched (for example Codex-plugin jobs). The page has three panes. Pick a place on the left, pick an agent in the middle, and read it on the right. Drag the dividers to resize the panes, and drag the left pane closed to hide it. **Live** in the top bar goes back. ### The three panes | Pane | What it shows | | - | - | | **Locations** (left) | **Local** and, when an agent runs on Fly, **Remote (Fly)**. Under each: your projects, then each issue (newest number first) and one **Conversations** group for work that has no issue. The numbers on the right are live agents of all shown (hover for the words). | | **Agents** (middle) | Every entry under the selected place. A subagent or worker sits indented under the agent or conversation that spawned it. When its parent lives somewhere else, the row says **spawned by** that parent instead. Each row shows the id, role, harness, model and — for Overdeck agents — reasoning effort with its source (for example `xhigh (role)`), last activity and age. | | **Detail** (right) | The entry's header (id, harness, model, effort, state, when it started and was last active, cost when known, and a **Spawned by** link), the issue's state, PR, checks and branch with the issue's actions, and the transcript. | Lanes nest under the conversation that launched them, and handoff and fork successors nest under their predecessor; a lane shows ` i` before its label and a successor shows a `continues ← #` link. A critic or verifier lane nests under the builder it judges, not under the conversation that launched it, and carries its verdict. History shows at most two levels of nesting. A deeper row keeps its place under its real parent's group but renders at the second level, with the marker `↳ continued from ` naming its real parent. Conversations keep their composer in the detail pane. A subagent's transcript is read-only: it has no input channel of its own. So is an external agent's: its row says **external**, and the detail pane says which tool launched it. See [Workers — Externally spawned agents](/reference/workers#externally-spawned-agents). Agents and issue nodes show the issue's title after its id (`work · PAN-3920 · Agents page as a directory`). Hover any truncated id, model, branch or title to see it in full. ### The time window History always lists everything that is live. Stopped and finished entries stay for **24h** by default; switch the toggle above the tree to **7d** to look back a week. The note under the toggle says which window is on. An agent that spawned something still in the window stays listed so you can see where the child came from. ### Keyboard | Key | Action | | - | - | | `↑` / `↓` | Move the selection in the focused pane | | `←` / `→`, `Tab` / `Shift+Tab` | Move between the panes | | `Enter` | On a place, focus its list; on a row, focus its detail | | `/` | Focus the **Filter agents** box (matches label, id, harness, model and role) | The selection is kept in the address bar (`?node=…&entry=…&window=168`), so a link opens the same view. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.