Skip to content

Keybindings cheat sheet

The TUI's footer always shows the bindings for the current view — there's no separate help screen. This page is the grep-friendly version of that footer, expanded across every tab and overlay.

Globals

These work from any tab. Inside an overlay, q and digits still quit / switch tabs (the overlay closes on the way out); esc is overlay-routed so it closes the overlay first.

KeyAction
14Switch to tab N (Board, Features, Docs, History). Digits beyond the tab count fall through to the active view.
qQuit. Always.
ctrl-cQuit. Always.
escClose the active overlay; quit if no overlay is open.

Note

tab / shift-tab are not global — views use them to cycle their own inner panes (e.g. description ↔ comments ↔ attachments inside the card overlay).

Board tab

KeyAction
h / l (or left / right)Move between columns.
j / k (or down / up)Move between cards in the focused column.
g / homeJump to the first card.
G / endJump to the last card.
enterOpen the focused card's detail overlay.
cOpen the column-visibility picker.
fOpen the feature filter picker.
HHide the focused column (refuses if it's the last visible one).
dToggle the inline detail pane.
rReload from the database.
qQuit.

Card overlay (open with enter on a card)

Cycles through three inner panes — description, comments, attachments — via tab / shift+tab. Bindings depend on which pane is focused.

KeyAction
tab / shift+tabNext / previous pane (description ↔ comments ↔ attachments).
j / k (or down / up)Scroll within the active pane (or move selection on the attachments pane).
g / homeJump to top.
G / endJump to bottom.
pgdown / spaceScroll down 10 lines (description / comments).
pgupScroll up 10 lines (description / comments).
enter (description)Close the overlay.
enter (comments)Open all comments full-screen.
enter (attachments)Open the focused attachment (a document jumps to the Docs tab; PR URLs print).
escClose the card overlay.

Comment overlay (full-screen comments view)

KeyAction
j / k (or down / up)Scroll.
pgdown / spaceScroll down 10 lines.
pgupScroll up 10 lines.
g / homeTop.
G / endBottom.
escBack to the card overlay.

Column picker (open with c)

KeyAction
j / kMove selection.
spaceToggle the focused column (refuses to hide the last visible one).
aShow all columns.
nMinimal — keep only the first state column visible (matches the in-app footer's n minimal).
escClose the picker.

Feature picker (open with f)

KeyAction
j / kMove selection.
spaceToggle the focused feature.
aShow all features.
nIsolate — hide every feature except the focused one.
escClose the picker.

Features tab

KeyAction
j / k (or down / up)Move between features.
g / homeFirst feature.
G / endLast feature.
enterOpen the focused feature's overlay.
rReload.
qQuit.

Feature overlay

KeyAction
j / k (or down / up)Scroll.
pgdown / spaceScroll down 10 lines.
pgupScroll up 10 lines.
g / homeTop.
G / endBottom.
esc / enterClose.

Docs tab

KeyAction
j / k (or down / up)Move between documents.
enterOpen the focused document in the full-screen reader.
rReload.
qQuit.

Doc overlay

KeyAction
j / k (or down / up)Scroll.
pgdown / spaceScroll down 10 lines.
pgupScroll up 10 lines.
g / homeTop.
G / endBottom.
esc / enterClose.

Cross-tab note: when a card's Linked documents attachment is opened (via enter on the attachments pane), the TUI jumps to the Docs tab with that file selected and remembers the original tab so esc returns you there.

History tab

KeyAction
j / k (or down / up)Scroll.
pgdown / spaceScroll down 10 lines.
pgupScroll up 10 lines.
g / homeTop.
G / endBottom.
rReload.
qQuit.

Source of truth

These bindings are pulled from the Help() methods on each view in internal/tui/ of the upstream repo. If the footer disagrees with this page, the footer wins — and that's a bug to file.

bacio · v0.1 · MIT