cones.

The dashboard

cones shows native sessions and recent runs, including sessions started elsewhere. No configuration file is needed. Full reference: dashboard.md.

The header counts working, input, idle and done sessions. A green ✉ before a title marks an unread completion; viewing the session clears it. Input requests stay until the harness reports them resolved. ! stale means a read failed, and the previous rows stay visible with the error until a refresh succeeds.

KeyAction
↑ ↓Select rows. Up past the first table reaches the menu.
enterOpen the selection; with text in the composer, submit it as an instruction.
shift+enterOpen the selection fullscreen; with text, insert a line break.
tab →Enter the pane.
ctrl+eUnfold every column value under the row: agent, usage, time, process, source and reply.
ctrl+zReturn from a viewer or screen to the list.
ctrl+\Toggle the pane; in a focused screen, switch split and fullscreen.
ctrl+oModel, effort and provider for the selected harness.
ctrl+dStart the coordinator for the selected folder.
?List the current keys. ctrl+g opens Help from anywhere.
esc twice, ctrl+c twiceQuit, within 1.5 seconds.

Sessions

Sessions group by folder or by state. Linked Git worktrees sit under their repository's heading with a ⑂ mark. A job's run sits among the sessions in its folder, titled ◆ JOB.

StateDisplay
activeAnimated bar, working
blockedYellow bar, input
idleDim low bar, idle
doneGreen check, done
failedRed cross, failed
stoppedDim low bar, stopped
Unknown-

States come from the harness. A harness that reports none shows -. Where each state comes from.

KeyAction
ctrl+x twiceStop or remove, using the harness's own stop.
ctrl+sGroup by state or folder.
ctrl+fFilter. :attention shows input requests and unread completions; :unread completions alone.
ctrl+hShow or hide history.
ctrl+nRename a Claude, Codex, pi or OpenCode session through the harness's own rename.
ctrl+yFork a conversation.
ctrl+lPlace a session in tags or groups above the folders.
ctrl+tPin a session above every group.
ctrl+bReorder a row inside its group.
ctrl+rRefresh now.

Sessions in other terminals

Where cones reads the harness's conversation, the preview shows it as it is written, and enter says watch. ctrl+y offers take over here: it stops the client in its own terminal, waits for it to exit and resumes the conversation in a pane, in the session's own folder. A harness with no readable conversation says own terminal, and that terminal is the only way in.

Fork a conversation

ctrl+y asks where the fork goes. The first row is the native fork, for live or past Claude, Codex, pi and OpenCode conversations: a new identity in the same folder, with no instruction sent.

Any other row starts a new session on another harness, in the same folder. Its first prompt is the last 40 messages, as cones show prints them (at most 64 KB), plus the transcript's path. It carries no tool results beyond their names and inputs, no system prompt and no hidden reasoning. Forks do not create worktrees.

History and search

ctrl+h shows past conversations below the live list, newest first, 50 per page. Typing searches titles, folders, harnesses, ids and conversation text. shift+tab switches mode:

enter resumes in the recorded folder and native home. History has no delete action. In a focused preview, c copies the last response, a code block or session details. From a Claude or Codex history preview, → opens the context inspector, which lists what the conversation recorded; unreported token counts stay unknown.

Viewers and hosting

Quitting or crashing the dashboard leaves hosted shells, pi, OpenCode, experimental launchers and interactive Claude forks running. Reopen with the same state directory and enter reconnects to the process and its draft. One dashboard may attach to a host at a time. Host crashes and machine restarts end these processes; their history stays resumable where the harness provides it. Claude background sessions and Codex daemon threads keep their native ownership.

In a native viewerBehavior
ctrl+zReturn to the list, including with a draft.
tab / ←Return from a recognized empty native editor; otherwise passed to the client.
ctrl+cQuit confirmation in agent viewers; interrupt in shell viewers. Use esc to interrupt an agent turn.
Other keysPassed through, including esc and shift+tab.
PasteNative bracketed paste. An empty paste becomes ctrl+v for image paste.

The mouse works on every screen: the wheel scrolls what is under the pointer, a drag selects and copies, and dragging the divider resizes the pane. alt+m hands the mouse to the terminal and back.

Composer

Type an instruction and press enter to launch in the selected folder. shift+tab cycles through enabled harnesses, then terminal for a shell. Instructions shorter than 4 characters start nothing. ctrl+v pastes clipboard images as [Image #n] markers, which expand to file paths at launch.

+ add folder is the last row. Type a path; tab completes it like a shell. A path that does not exist asks first, then is created. Pinned folders from the folders setting appear as suggestions.

Up past the first table reaches the menu: jobs lists scheduled jobs and their runs with a wizard for new ones, config edits settings and saves each change immediately, and help is searchable with the same word and meaning modes as history. Key bindings are built in; there is no runtime override file. See jobs.