Skip to content
Docs0.9GitHubInstall

Using itIn the terminal: overview

Overview

The overview: agents in four lanes, Needs you, Working, Ready, and Ended today, with a question and an approval that can be answered on their cardsThe overview: agents in four lanes, Needs you, Working, Ready, and Ended today, with a question and an approval that can be answered on their cards

The overview shows your agents as a dashboard of four lanes: Needs you (a question or an approval, the longest waiting first), Working, Ready, and Ended today. Press w in the chooser, or Alt+w in tmux to open it in a popup. It is the dashboard plugin’s page, which the chooser, the web client, and the iPhone app each draw with their own pieces.

Each card shows the agent’s title, what it asks, does, or last said, its project’s colour, its provider, its team, the schedule that started it, and how long ago it last changed. The header says how many need you and work, and holds the search; under it, the filters narrow the lanes by project, provider, or team, and notices list schedules that failed and project files that wait on you. Along the bottom, the strip shows the next scheduled runs and today’s tasks. Below 100 columns, one lane shows at a time under tabs with their counts.

Other plugins’ pages sit beside the overview as tabs along the top. A page opens on its first card, else its first notice. A page without lanes, such as Changes, scrolls as one column: the arrows move through its rows and, in a diff, line by line. Esc goes back through the pages opened from others.

Key Action
↑/↓, j/k The previous or next card in its lane, or what lies above or below
←/→, h/l The card at the same place in the next lane that has cards; narrow, the next lane
Home / End, PageUp / PageDown The lane’s first or last card / five cards on; on a page without lanes, its top or bottom / a screenful
Enter Open the agent’s pane; an ended agent’s history entry, to restore it; a notice’s schedule or project, a button, or a strip part; fold or open a diff’s file
1–9 Answer the selected card’s question by its option, or its approval: 1 approves, 2 denies
/ Search the page; Enter keeps the search, Esc clears it
f The filters: Enter or Space picks an option, Ctrl+u clears them all
i Message the agent, with the same guards as the apps
S / x / s Stop it / close its terminal (an agent outside tmux has none) / schedule it, confirmed as in the tree
R Rename the agent; every app shows the name
d Mute or unmute the agent (muted agents show nf-fa-bell_slash, fallback ⊘)
a, Menu, Shift+F10 The card’s actions menu, each item with its key if it has one: Interrupt (only while it runs), Open, Message, Rename, Schedule, Project color, Mute or unmute, Stop, Close, then the plugins’ chat menu items, such as Changes, then the page’s own, such as Show team
←/→ on a diff’s file, ] / [ Fold it / open it; the next / previous file
m, M Mark the selected diff line or file for its agent (on a line, move to take more, then m again for the note) / send the marks with a message (Changes)
c Choose the card’s project colour: arrows move between the 12, Enter applies it everywhere, Esc keeps the old one
Tab / Shift+Tab The next / previous plugin page
? The overview’s keys
Esc, q, w Clear the search, then back to the page this one opened from, or close the popup

A question with one pick and no more steps, or an approval, shows its answers on its card when selected; anything else opens in its pane. With the mouse, click to select, click a selected card to open it, and right-click a card for its actions.

The web client's overview dashboard

The overview dashboard on an iPhone

The web client with no chat open, and the iPhone and iPad apps’ Overview, show your agents as a dashboard of four lanes: Needs you (a question or an approval, the longest waiting first), Working, Ready, and Ended today. An agent moves to its lane by itself as its state changes. Each card shows the agent’s title, its question, approval, tool call, or last reply, its project’s colour, its provider, how far it is through its Progress, its team (Manages N, or its manager), the schedule that started it, and how long ago it last changed.

Answer a question or approve and deny right on its card; a question with more steps or a note opens its chat. Click or tap a card to open its chat; hover (or hold, on iPhone) for its other actions. Narrow the lanes by project, provider, or search. The strip along the bottom shows the next scheduled runs, today’s tasks, and usage.

On the web, ←/→ move between lanes and ↑/↓ between cards, Enter opens the chat, / searches, 1–3 pick an option of a question in focus, and a/d approve or deny. On an iPhone the lanes are pages: swipe between them, or tap their names; Coming up, at the end of Needs you, lists the next runs and today’s tasks.

The Overview comes from the dashboard plugin ([plugins.dashboard], in the example config). With it off, the web client opens on the chat list, and the chooser’s overview says to turn it on.