TUI Navigation
The TUI is the primary practice surface. Launch with werk (no arguments).
The TUI has three views, each a different orientation on the same structure:
- Deck (stream) — your positioned tensions in spatial layout. The default view. Desired above actual. Navigate the hierarchy by descending into children and ascending to parents.
- Survey — all tensions organized by temporal urgency bands. The Napoleonic field survey. A time-first view across the entire field.
- Logbase — epoch history for a single tension. The record of structural change over time.
Command palette
Section titled “Command palette”Press / from any view to open the command palette. Type any gesture name, tension identifier, or search term. The palette is the universal entry point for all actions.
Ctrl+K also opens the palette.
Deck navigation
Section titled “Deck navigation”| Key | Action |
|---|---|
j / k | Move down / up through tensions |
h | Ascend to parent |
l | Descend into focused tension’s children |
g | Jump to top |
G | Jump to bottom |
Enter | Toggle focus view (peek → focus → dismiss) |
Space | Toggle peek (lighter detail card) |
Tab | Pivot to survey, centered on current tension |
Shift+Tab | Return to survey at last position |
L | Open logbase for focused tension |
Escape | Close overlay / cancel |
q | Quit |
Deck gestures
Section titled “Deck gestures”| Key | Action |
|---|---|
a | Add a new child tension |
e | Edit focused tension (desire, then Tab to switch to reality) |
n | Add a note to focused tension |
r | Resolve focused tension (with confirmation) |
x | Release focused tension (with confirmation) |
o | Reopen a resolved/released tension |
p | Toggle position — held becomes positioned, positioned becomes held |
m | Move (reparent) focused tension via search |
K / J | Grab and reorder — move tension up/down in sequence |
? | Edit parent’s reality (quick update). At root: show help. |
! | Edit parent’s desire |
T | Toggle trajectory view (resolved stay visible on route) |
Clipboard
Section titled “Clipboard”| Key | Action |
|---|---|
y | Yank short code (#42) to clipboard |
Y | Yank full context (for agent handoff) to clipboard |
Undo / Redo
Section titled “Undo / Redo”| Key | Action |
|---|---|
u / Ctrl+Z | Undo last gesture |
U / Ctrl+Shift+Z | Redo |
Survey navigation
Section titled “Survey navigation”| Key | Action |
|---|---|
j / k | Move within and across urgency bands |
J / K | Jump to next / previous band |
g / G | Jump to top / bottom of band |
Tab | Pivot to deck at the selected tension’s parent |
Shift+Tab | Return to deck at previous position |
Escape | Return to deck |
All deck gestures (a, e, n, r, x, p, etc.) also work from the survey.
Inspector
Section titled “Inspector”Ctrl+Shift+I toggles the inspector overlay — a diagnostic view showing internal state.