The dashboard
cones shows native sessions and recent runs, including sessions started elsewhere. No configuration file is needed. Full reference: dashboard.md.
Navigation
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.
| Key | Action |
|---|---|
| ↑ ↓ | Select rows. Up past the first table reaches the menu. |
| enter | Open the selection; with text in the composer, submit it as an instruction. |
| shift+enter | Open the selection fullscreen; with text, insert a line break. |
| tab → | Enter the pane. |
| ctrl+e | Unfold every column value under the row: agent, usage, time, process, source and reply. |
| ctrl+z | Return from a viewer or screen to the list. |
| ctrl+\ | Toggle the pane; in a focused screen, switch split and fullscreen. |
| ctrl+o | Model, effort and provider for the selected harness. |
| ctrl+d | Start the coordinator for the selected folder. |
| ? | List the current keys. ctrl+g opens Help from anywhere. |
| esc twice, ctrl+c twice | Quit, 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.
| State | Display |
|---|---|
active | Animated bar, working |
blocked | Yellow bar, input |
idle | Dim low bar, idle |
done | Green check, done |
failed | Red cross, failed |
stopped | Dim low bar, stopped |
| Unknown | - |
States come from the harness. A harness that reports none shows -. Where each state comes from.
| Key | Action |
|---|---|
| ctrl+x twice | Stop or remove, using the harness's own stop. |
| ctrl+s | Group by state or folder. |
| ctrl+f | Filter. :attention shows input requests and unread completions; :unread completions alone. |
| ctrl+h | Show or hide history. |
| ctrl+n | Rename a Claude, Codex, pi or OpenCode session through the harness's own rename. |
| ctrl+y | Fork a conversation. |
| ctrl+l | Place a session in tags or groups above the folders. |
| ctrl+t | Pin a session above every group. |
| ctrl+b | Reorder a row inside its group. |
| ctrl+r | Refresh 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:
- Words: a passage must contain at least two of the query's words, or its only word. Needs no model.
- Meaning: a local MiniLM model compares the query with passages and marks results
≈. First use downloads about 90 MB. Text and queries stay on the machine. English works best.
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 viewer | Behavior |
|---|---|
| ctrl+z | Return to the list, including with a draft. |
| tab / ← | Return from a recognized empty native editor; otherwise passed to the client. |
| ctrl+c | Quit confirmation in agent viewers; interrupt in shell viewers. Use esc to interrupt an agent turn. |
| Other keys | Passed through, including esc and shift+tab. |
| Paste | Native 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.
Jobs, config and help
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.