keyboard-shortcuts

Keyboard Shortcuts

Complete hotkey reference for all Pour TUI screens. Source: src/tui/dashboard.rs, src/tui/form.rs, src/tui/configure.rs.

Dashboard

The main screen reached by running pour with no arguments.

Key Action
Up / Down Navigate module list
Enter Launch selected module
e Open module settings configurator for selected module
v Open vault settings configurator
n Add a new module
r Refresh transport (re-probe API connection)
o Open vault in Obsidian (fires obsidian:// URL)
q Quit
? Toggle help overlay
Ctrl+Up Move selected module up in dashboard order
Ctrl+Down Move selected module down in dashboard order

Form (module Entry screen)

Reached by launching a module from the dashboard or via pour <module>.

General Navigation

Key Action
Up Move to previous visible field
Down / Tab Move to next visible field
Shift+Tab Move to previous visible field
Enter Confirm field / open overlay / submit (on submit row)
Esc Close active overlay; from submit row exits to dashboard

Text Fields

Key Action
Printable characters Append to input
Backspace Delete character before cursor
Left / Right Move cursor
Home Cursor to start of line
End Cursor to end of line

Textarea Fields (editor overlay)

Key Action
Enter Open overlay editor (when overlay closed)
Esc Close overlay editor
Left / Right Cycle callout type (when overlay is closed and callout is configured)
t Edit callout title inline (when focused on textarea row, overlay closed)

Select Fields (dropdown overlay)

Key Action
Enter Toggle dropdown open/closed; confirm selection when open
Up / Down Cycle options while open
Left / Right Cycle options inline when dropdown is closed
Esc Close dropdown without confirming
Printable characters Filter options (dynamic_select with allow_create = true)
Backspace Trim search buffer (dynamic_select with allow_create = true)

Composite Array Fields (table overlay)

Key Action
Enter Open table editor overlay
Arrow keys Navigate cells
Tab Advance to next cell
Enter (in table) Add new row
Delete Delete current row
s Save current rows as a per-field preset
l Open the per-field preset picker
p Quick-cycle to the next saved per-field preset
Esc Close table overlay

Per-field Preset Picker (composite overlay)

Appears when l is pressed inside a composite_array editor with at least one saved preset.

Key Action
Up / Down Move selection
Enter Apply selected preset (replaces existing rows)
Ctrl+D Delete selected preset
Esc Cancel and close picker

Preset Row

Key Action
Left / Right Cycle through saved presets (and <none>)
Ctrl+Left Reorder selected preset backward
Ctrl+Right Reorder selected preset forward
s (on preset row) Save current form values as preset (name prompt appears)
Ctrl+S (any non-editing context) Save current form values as preset
d (on preset row, real preset selected) Delete selected preset (y/n confirmation)

Delete Confirmation Dialog

Key Action
y / Y Confirm delete
n / N / Esc Cancel

Configure (module and Vault settings)

Reached via e (module settings) or v (vault settings) from the dashboard.

Settings List Navigation

Key Action
Up / Down Navigate settings rows
Enter Edit selected setting (text/identifier starts editing; path opens vault browser; select cycles options)
e Start freetext editing on any field (including Path and Identifier)
s Save settings and return to dashboard (not available in New Module mode)
d Delete the entire module (ModuleSettings only; y/n confirmation)
? Open placeholder help overlay (Path fields only)
Esc Cancel / return to previous screen

New Module Mode

Key Action
Ctrl+S Save the new module definition
Esc Cancel and discard the new module

Freetext Edit Mode (active when Editing a Field value)

Key Action
Printable characters Append to edit buffer
Backspace Delete character before cursor
Left / Right Move cursor
Up / Down Navigate lines (list editor for options arrays)
Enter Confirm edit
Esc Cancel edit, restore original value
Ctrl+S Save settings while in edit mode

Field List (sub-screen within Module settings)

Key Action
Up / Down Navigate fields
Ctrl+Up Reorder field upward
Ctrl+Down Reorder field downward
n Add a new field
d Delete selected field (y/n confirmation)
Enter Open field editor for selected field
Esc Return to module settings

Sub-field List (within a composite_array Field editor)

Key Action
Up / Down Navigate sub-fields
Ctrl+Up Reorder sub-field upward
Ctrl+Down Reorder sub-field downward
n Add a new sub-field
d Delete selected sub-field
Enter Open sub-field editor
Esc Return to field editor

Browse (vault Directory browser)

Opened from path fields inside the configurator.

Key Action
Up / Down Navigate directory entries
Enter Select entry (descend into directory or confirm file)
Backspace Go up one directory level
Esc Cancel and return to configurator

Preset name Overlay

Appears when saving a preset.

Key Action
Printable characters Type preset name
Backspace Delete character
Enter Confirm name and save preset
Esc Cancel

Help Overlay

Opened via ? from the dashboard or path-field configurator.

Key Action
? / Esc Close help overlay