Keyboard & mouse

Summary

The thread view reads a plan or reply as one thread with discussions pinned to its text. Mark text with the mouse or the keyboard, type to comment, and send with cmd+enter. These keys belong to the view and are not rebindable.

Plans and replies open in the thread view. Press the menu's keybinds entry to see this list in the terminal.

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
escdrop the mark

A drag that leaves a block on its blank line below marks to the end of that block; the next block joins the mark once the pointer reaches its text.

Commenting

InputWhat it does
typeopen a comment on the mark, or on the word under the caret
cmd+option+mopen a comment on the mark
enterreply to the comment under the caret
tabfold or unfold the discussion under the caret
cmd+] / cmd+[jump to the next or previous comment
ctrl+qquit

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
click elsewheresave 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.

Ghostty and cmd+enter
Ghostty binds cmd+enter to fullscreen by default. Add keybind = super+enter=unbind to its config, or send with ctrl+enter.

The session

Letters type a comment, so everything that acts on the review as a whole sits on a ctrl chord.

InputWhat it does
ctrl+enteropen the submit card (with no comment open)
ctrl+eedit the plan in $EDITOR
ctrl+sshare the plan
ctrl+rcycle the review rail: expanded, compact, hidden

The rail and curation

Option plus a letter drives the review rail and the curation of the plan.

InputWhat it does
option+n / option+pfocus the next or previous card
option+eedit the focused card in place
option+backspacedelete the focused card
option+rrename a collaborator
option+xcut the block under the caret
option+urestore the last cut
option+w / option+swiden or narrow the rail

The tree

The rail's Tree tab shows the session's history: revisions, comments, checkpoints, and branches, with the path you are on bright and the current tip marked. Option plus a letter walks it; the buttons under the tree reach the same primitives with the mouse, and clicking a selected row goes there.

InputWhat it does
option+tshow or hide the tree
option+n / option+pselect the next or previous entry (while the tree shows)
option+ggo to the entry: switch to its branch, or move back to it
option+bstart a branch at the tip
option+llabel the tip as a checkpoint
option+ffork the path into a new session
option+hfork and hand off: share the fork

Moving the tree is the owner's; a collaborator reads it. A move back asks for an optional summary of what you leave behind.

Diff reviews

Diff reviews keep the diff sheet and the rebindable keys of the [keys] table.