Keyboard and mouse

Summary

Review Threads with direct keyboard and mouse controls.

Plans and replies open in the Thread view. Open Keybinds from the menu to see this list in the terminal.

Two modes: type and nav

The thread has two modes, and the footer always says which one you are in.

  • Type is the default. A letter opens a comment on the mark, or on the word under the caret. This is the primary act, so it needs no key to reach.
  • Nav is where the structural commands live. Press esc to enter it; the footer switches to the nav commands. Now a bare letter runs a command instead of typing. Press c (or just start typing) to return to type mode.

esc always heads toward nav, so it never strands you: from typing it enters nav, and in nav it drops the mark or a focused comment without leaving. There is no leader chord and no modifier - a plain letter reaches cueloop through any terminal, so there is no setup.

The footer lists only the commands the surface under the caret can run. The Welcome tab and a file opened from the Project tree have no review behind them, so their nav mode offers c comment and z fold; any other letter types.

Marking text

A mark is a character-precise stretch of text. It can start in the middle of a word and run across wrapped lines and across blocks - from the tail of a paragraph into the bullets under it.

InputWhat it does
clickplace the caret
dragmark from the press to the pointer, across blocks
double-clickmark the word under the pointer
← / →move the caret by word; it flows across blocks
shift+← / shift+→hold a mark from the caret
↑ / ↓move the caret by block
escenter nav mode; in nav, drop the mark

Commenting

InputWhat it does
typeopen a comment on the mark, or on the word under the caret
enterreply to the comment under the caret
escenter nav mode

Inside a comment:

InputWhat it does
cmd+entersend (ctrl+enter works where the terminal keeps cmd)
enternew line, kept as typed
backspace on an empty draftdismiss the draft; the mark stays
/the actions palette
escdismiss the draft
click awaysave the draft

A comment on a mark that spans blocks anchors to the whole stretch: its quote carries the text of every block it covers, and the card sits under the last one.

Press esc first (the footer switches to the nav commands), then a bare letter.

InputWhat it does
ccomment on the mark (returns to type)
eedit the plan body in the inline editor
sshare the plan
enteropen the submit card
n / pfocus the next or previous comment
xcut the block under the caret
urestore the last cut
rrename a collaborator
backspacedelete the focused comment
zfold or unfold the comment under the caret

The session commands also have Ctrl accelerators you can press without leaving type mode: cmd+enter (or ctrl+enter) opens the submit card, ctrl+e edits, and ctrl+s shares. Nav mode is the discoverable path; these are the shortcut.

Panes and focus

The workbench has four panes: Threads, Thread, Changes, and Project. One pane owns the keyboard at a time; click a pane to focus it, or press tab (shift+tab for the previous) to cycle. Only the focused pane responds to its keys, so moving through the Threads sidebar never moves the caret in the editor. While a comment composer is open, tab belongs to the composer (it accepts the highlighted / palette entry); save or dismiss the draft to cycle panes again.

Diff reviews

A diff review reads the diff sheet in the Thread pane. Enter nav mode with esc, then act on the row or file under the caret.

InputWhat it does
xreject the change under the caret
urestore the last rejection
ccollapse the file to its band
dsplit or stacked layout (when wide)
kstart the guided walk

In the guided walk, ] and [ step through the files and esc leaves it.

Session history

The session's history - revisions, checkpoints, and branches - is carried behind these nav-mode commands. They act on the current path:

InputWhat it does
ggo to the entry: switch to its branch, or move back
bstart a branch at the tip
llabel the tip as a checkpoint
ffork the path into a new session
hfork and hand off: share the fork

These are the owner's; a collaborator reads.

Quit

ctrl+q quits from anywhere - the one chord cueloop keeps, since terminals deliver it reliably and it never collides with a multiplexer prefix.