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 `<age>`	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.
`<tool>`, 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 `<age>` 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 shows as a ↳ line under the conversation that launched it: ↳ <role letter> <lane key> i<n> · <state>, 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 ← #<id> 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 <role letter> <lane key> i<n> before its label and a successor shows a continues ← #<id> 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 <parent> 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. 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.

​Agents page

​Live

​What the colors mean

​History

​The three panes

​The time window

​Keyboard