diff --git a/README.md b/README.md index ced75a5..79e45ca 100644 --- a/README.md +++ b/README.md @@ -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. diff --git a/docs/commands.md b/docs/commands.md index e58bbd1..1590d18 100644 --- a/docs/commands.md +++ b/docs/commands.md @@ -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 | @@ -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. @@ -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. @@ -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. @@ -188,7 +208,7 @@ A recovery row is formatted as ` ago · task(s) ·