Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,6 +85,7 @@ Use the two dashboard hints for common actions; press `?` for the expanded key r
### Attached

- Press `Ctrl-\` to background the task and return to the dashboard.
- Press `]` on the dashboard to mark a flagship task. Press `Ctrl-]` to attach to it, and again to return.
- Other supported input is forwarded to the task's PTY.

See [`docs/commands.md`](docs/commands.md#dashboard) for every key and launch flag, including the routing mechanics.
Expand Down
24 changes: 22 additions & 2 deletions docs/commands.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,8 @@ Choose the operating mode with launch arguments. Use keys to control the dashboa
| `s` | Cycle grouping: by state / by directory / by custom group |
| `m` | Tag the selected task "in use" (toggles) |
| `M` | Select the next tagged task in dashboard order, wrapping at the end |
| `]` | Mark the selected task as the [flagship](#the-flagship) (toggles; one at a time) |
| `Ctrl-]` | Attach to the flagship |
| `g` | Assign the selected task to a group (through the group picker) |
| `R` | Rename the selected task: a display name shown in place of the command |
| `r` | Rerun a finished task; use the captured resume command for supported agent tasks |
Expand All @@ -51,6 +53,9 @@ Choose the operating mode with launch arguments. Use keys to control the dashboa
| `✓` | Completed, exit 0 |
| `✗` | Completed, non-zero exit |
| `◆` | Tagged "in use" |
| `⚑` | The [flagship](#the-flagship) |

Look for marks in the row's two leading columns, aligned left with `◆` before `⚑`.

After 10 seconds without output, a task is marked `∙` and grouped under Idle.

Expand All @@ -68,6 +73,8 @@ Cursor keys are encoded according to the child's live cursor-key mode. In applic

`Ctrl-\` is the physical chord. The same chord may be reported by Crossterm as `Ctrl-4`; both representations are accepted.

Press `Ctrl-]` to attach to the [flagship](#the-flagship), then again to return to your previous task or the dashboard. As with `Ctrl-\`, you cannot send this key combination to a child: use another binding for tag-jump in `vim` or character search in readline. Both `Ctrl-]` and `Ctrl-5` are accepted; the latter is the Crossterm representation of the legacy encoding.

#### Modified keys, paste, and mouse input

These inputs cannot all be forwarded byte-for-byte. Their encoding and destination depend on the terminal and the attached child's modes.
Expand Down Expand Up @@ -134,6 +141,19 @@ Press `M` to select the next tagged task in dashboard order, wrapping after the

In custom mode only, a new command is assigned the selected task's group, through both `n` and the `@` picker. The destination is shown in the spawn prompt as `❯ dir ▸ group ▸ command`, each segment present only when it applies: the dir segment for a non-default directory, the group segment when a group will be inherited. New tasks are unassigned in state and dir modes.

#### The flagship

Press `]` to mark the selected task as the flagship, shown as `⚑`; press it again to clear the mark. You can mark only one task at a time. Select another task and press `]` to move the mark. Finished tasks cannot be marked. Sorting is unchanged.

Press `Ctrl-]` from the dashboard, peek, or an attached task to attach to the flagship, and again to go back:

- From an attached task: back to that task, even if it has finished since. If it was removed, back to the dashboard.
- From the dashboard or peek: back to the dashboard, with the selection on the same row. Peek is not reopened.

After attaching to the flagship with `Enter`, press `Ctrl-]` to return to the dashboard.

The flagship mark is cleared on task completion or removal and is not saved in sessions. Tags set with `m` are retained after task completion.

#### Renaming

Press `R` to rename the selected task, starting with its current name. Press `Enter` to save, or `Esc` to cancel. Leave the field empty to clear the name and display the command again. Use lowercase `r` to rerun.
Expand Down Expand Up @@ -188,7 +208,7 @@ A recovery row is formatted as `<age> ago · <tasks> task(s) · <label>`: the fi

## The `?` controls overlay

Use the two dashboard hints for common actions: `↑↓ select · enter attach · space peek · ? controls` and `❯ n run · @ dir · / find · s sort`. Press `?` for the expanded reference, including dashboard actions and the attached-mode background chord.
Use the two dashboard hints for common actions: `↑↓ select · enter attach · space peek · ? controls` and `❯ n run · @ dir · / find · s sort`. Press `?` for the expanded reference, including dashboard actions and the attached-mode background and flagship chords. With a flagship marked, look for `· Ctrl-] flagship` at the end of the first hint.

Bindings are grouped by purpose in a centered, non-scrolling box. Press `?`, `Esc`, or `q` to return to the dashboard, or `Ctrl-C` to disconnect. Other keys are ignored.

Expand All @@ -204,7 +224,7 @@ Read the source of the row's dashboard preview in the footer's `preview:` segmen

## Attached

Interact with the task in the terminal. The status bar is formatted as `[attached] <command> Ctrl-\ background`, or `[attached] <name> · <command>` for a named task. Press `Ctrl-\` to return to the dashboard. Other supported input normally goes to the child; navigation keys are reserved in [scrollback](#scrollback).
Interact with the task in the terminal. The status bar is formatted as `[attached] <command> Ctrl-\ background`, or `[attached] <name> · <command>` for a named task. When you can navigate with `Ctrl-]`, look for `· Ctrl-] flagship`, `· Ctrl-] back to <task>`, or `· Ctrl-] back to dashboard` in the hint. Long titles are shortened with `…` to leave room for the hints. Press `Ctrl-\` to return to the dashboard. Other supported input is normally forwarded to the child; navigation keys are reserved in [scrollback](#scrollback).

## Connection loss

Expand Down
2 changes: 1 addition & 1 deletion docs/img/controls.ansi
Original file line number Diff line number Diff line change
@@ -1 +1 @@
]0;fleetcom[?2026h[?25l fleetcom 12 running · 2 idle · 7 done by state · dir · custom · 4/21   ~/Documents/Code/Rust/fleetcom  ✻ ◆Dashboard Refine Scope small fixes for dashboard and CLI 2m ✻ ◆Summary Refine Inferring… · thinking with high effort 5m ✻ Grok Language Grok 4.5 (xhigh) · Responding… 12m ✻ Codex Language gpt-5.6-sol high · fleetcom · feat/cs/interface-fixes · 387K used · 9.… 18m ✻ Codex Review gpt-5.6-sol high · fleetcom · feat/cs/interface-fixes · 221K used · 4.… 24m ✓ cargo test test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered… 12s ✗ cargo clippy error: could not compile `fleetcom` (lib test) due to 1 previous error 3m ~  ✻ claude agents 2 awaiting input · claude agents 1h ✻ Zellij Desktop ¦ Utility 2h ∙ python >>> 41m ✓ brew update && brew upgra… Already up-to-date. 13m ~/Documents/Code/Apple/turret  ✻ Game Infra Review Turret Game Codebase Organization and Ex… - grok 8m ✻ Missile Nerf Tuning missile damage falloff 33m ✻ EMP Nerf EMP arc balance pass 35m ~/Documents/Code/Rust/crabapple  ✓ cargo test all doctests ran in 0.39s; merged doctests compilation took 0.38s 17m ~/Documents/Code/Rust/crabstep  ✓ cargo test all doctests ran in 0.83s; merged doctests compilation took 0.81s 21m ~/Documents/Code/Rust/imessage-exporter  ✻ claude Review GitHub issue 780 6m ✓ cargo test all doctests ran in 1.99s; merged doctests compilation took 1.95s 19m ~/Documents/Code/Rust/Logria  ✻ cargo watch -x test [Running 'cargo test'] test result: ok. 223 passed; 0 failed 45s ❯ n run · @ dir · / find · s sort  ↑↓ select · enter attach · space peek · ? controls [?25l┌─ controls ────────────────────────────────────────────┐│ Navigate ││ ↑↓ / kj move selection / find a task ││ Tab ⇧Tab jump section M next tagged ││ Act ││ enter attach r rerun finished ││ space peek X kill or remove ││ Organize ││ m tag in use R rename ││ g assign group s cycle grouping ││ Create ││ n run here @ run in a dir ││ Session ││ w save session o load session ││ Leave ││ q detach Q quit and kill ││ Attached ││ Ctrl-\ background │└───────────────────────────────────────────────────────┘ ? esc close [?2026l
]0;fleetcom[?2026h[?25l fleetcom 12 running · 2 idle · 7 done by state · dir · custom · 4/21   ~/Documents/Code/Rust/fleetcom ◆ ✻ Dashboard Refine Scope small fixes for dashboard and CLI 2m◆ ✻ Summary Refine Inferring… · thinking with high effort 5m ✻ Grok Language Grok 4.5 (xhigh) · Responding… 12m ✻ Codex Language gpt-5.6-sol high · fleetcom · feat/cs/interface-fixes · 387K used · 9.5… 18m ✻ Codex Review gpt-5.6-sol high · fleetcom · feat/cs/interface-fixes · 221K used · 4.4… 24m ✓ cargo test test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered … 12s ✗ cargo clippy error: could not compile `fleetcom` (lib test) due to 1 previous error 3m ~  ✻ claude agents 2 awaiting input · claude agents 1h⚑ ✻ Zellij Desktop ¦ Utility 2h ∙ python >>> 41m ✓ brew update && brew upgra… Already up-to-date. 13m ~/Documents/Code/Apple/turret  ✻ Game Infra Review Turret Game Codebase Organization and Ex… - grok 8m ✻ Missile Nerf Tuning missile damage falloff 33m ✻ EMP Nerf EMP arc balance pass 35m ~/Documents/Code/Rust/crabapple  ✓ cargo test all doctests ran in 0.39s; merged doctests compilation took 0.38s 17m ~/Documents/Code/Rust/crabstep  ✓ cargo test all doctests ran in 0.83s; merged doctests compilation took 0.81s 21m ~/Documents/Code/Rust/imessage-exporter  ✻ claude Review GitHub issue 780 6m ✓ cargo test all doctests ran in 1.99s; merged doctests compilation took 1.95s 19m ~/Documents/Code/Rust/Logria  ✻ cargo watch -x test [Running 'cargo test'] test result: ok. 223 passed; 0 failed 45s ❯ n run · @ dir · / find · s sort  ↑↓ select · enter attach · space peek · ? controls · Ctrl-] flagship [?25l┌─ controls ──────────────────────────────────────────────┐│ Navigate ││ ↑↓ / kj move selection / find a task ││ Tab ⇧Tab jump section M next tagged ││ Act ││ enter attach r rerun finished ││ space peek X kill or remove ││ Organize ││ m tag in use R rename ││ ] flagship s cycle grouping ││ g assign group ││ Create ││ n run here @ run in a dir ││ Session ││ w save session o load session ││ Leave ││ q detach Q quit and kill ││ Attached ││ Ctrl-\ background Ctrl-] flagship / back │└─────────────────────────────────────────────────────────┘ ? esc close [?2026l
Binary file modified docs/img/controls.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading