The terminal UI
wisp tui is wisp full screen in your terminal. It shows the same tasks as the app, live, and does what the app
does: start tasks, follow them, answer questions, review changes. Nothing is polled; every key answers at once.
wisp tuiIt talks to the wisp server like the app and the CLI do, and starts it if it isn’t running.
The screen
- Tasks, on the left, in the same sections as the app.
- The open task: its live transcript, step by step, with its state in the header.
- A side pane: the changes (d) or the Thread pane with the task’s Notes (t).
- The composer at the bottom, and a status bar under it.
Tab moves between zones. [ and ] narrow or widen the focused one (or drag its border). The mouse works too. Press ? for the keys at any time.
Keys
| Where | Keys | What it does |
|---|---|---|
| Everywhere | Ctrl-K or : | Command palette: tasks, views, commands, settings |
| Everywhere | ? | This help (j k scroll it on a small screen) |
| Everywhere | Tab, Shift-Tab | Next zone. In the composer: cycle the mode, Plan → Edits → Full auto |
| Everywhere | g then c a m s , h t | Go to crew, automations, machines, My Stuff, settings, history, tasks |
| Everywhere | [ ] | Narrow or widen the focused zone |
| Everywhere | Ctrl-C, q | Quit (q outside the composer) |
| Tasks | j k, ↑ ↓ | Move |
| Tasks | Enter, l | Open the task |
| Tasks | n | New task |
| Tasks | i | Reply to the selected task |
| Tasks | / | Search |
| The task | i, Enter | Write (the composer) |
| The task | j k | Move between steps |
| The task | Space | Open or close the step (a tool call, a diff) |
| The task | o | Open in its harness (Claude Code, Codex…), back here after |
| The task | 1–9 | Answer the question with that choice |
| The task | y, a, n | Allow, always allow, or deny a tool |
| The task | Esc | Interrupt the running turn |
| The task | d | The changes pane (diffs). Again: close it |
| The task | t | The Thread pane: the task’s Notes and how worn it is. Again: close it |
| The task | s | Stop |
| The task | PgUp PgDn, G | Scroll; to the end (and follow) |
| Composer | Enter | Send (queued while a turn runs) |
| Composer | Alt-Enter, Ctrl-J | New line |
| Composer | @ | Mention a task, crew member, machine, My Stuff item or file |
| Composer | / | A command: /btw, /fork, /stop, or any wisp command as /<plugin> <verb> (/ship ship, /goal set --text "…") |
| Composer | ↑ | History, in an empty box |
| Composer | Ctrl-E | Edit in $EDITOR |
| Composer | Alt-↑ Alt-↓, Ctrl-S | Reorder the queued follow-up; send it now |
| Composer | Esc | Leave the composer (interrupts when it’s empty and a turn runs) |
| Views | j k | Move |
| Views | a letter | The row’s action (shown in the view’s footer) |
| Views | r | Reload |
The palette
Ctrl-K (or :) finds anything by name: a task, a view, a setting, or any wisp command. Commands show by their title with the words you’d type in the CLI at the right, for example Add a computer · machines add.
Commands with /
In the composer, any CLI command runs as /<plugin> <verb> …, with the same words and flags as wisp <plugin> <verb> …. As you type, the line under the box shows how to use it.
/machines add --name studio --address me@studio/goal set --text "all tests pass"/runtime set-mode --mode planWhen the command acts on a task, the open task is the one it acts on, unless you give an id. With no task open it asks you for one.
Views
g and a letter opens a view: a table over the same data as the app’s screens. The footer lists the letters for the selected row.
| View | Go | Row actions |
|---|---|---|
| Crew | g c | n new member, a give a job, c check in, w wake, p pause, u resume, x remove |
| Automations | g a | f fire, t test |
| Machines | g m | c connect, x disconnect |
| My Stuff | g s | l launch, d remove |
| Settings | g , | |
| Repo history | g h |
g t goes back to your tasks. Plugins can add views of their own the same way.