micasa

Keybindings

Complete reference of every keybinding in micasa, organized by mode.

Global (all modes)#

KeyAction
ctrl+qQuit (exit code 0)
ctrl+cCancel in-flight LLM operation
ctrl+oToggle mag mode for numeric values

Movement#

KeyAction
j / downMove row down
k / upMove row up
h / leftMove column left (skips hidden columns)
l / rightMove column right (skips hidden columns)
^Jump to first column
$Jump to last column
gJump to first row
GJump to last row
d / ctrl+dHalf-page down
u / ctrl+uHalf-page up
pgdownFull page down
pgupFull page up

Tabs and views#

KeyAction
b / fPrevious / next tab
B / FFirst / last tab
tabToggle house profile
DToggle dashboard

Table operations#

KeyAction
sCycle sort on current column (none -> asc -> desc -> none)
SClear all sorts
tProjects tab: toggle hiding settled projects (completed + abandoned)
/Jump to column (fuzzy find)
cHide current column
CShow all hidden columns

Row filtering#

KeyAction
nToggle pin on current cell value (preview: dim non-matching rows)
NToggle filter activation (hide/show non-matching rows)
ctrl+nClear all pins and deactivate filter

Actions#

KeyAction
enterDrill into detail view, follow FK link, or preview notes
oOpen selected document with OS viewer (Docs tab only)
iEnter Edit mode
@Open LLM chat overlay
?Open help overlay
escClose detail view, or clear status message

Edit mode#

Movement#

Same as Nav mode, except d and u are rebound:

KeyAction
j/k/h/l/g/GSame as Nav
ctrl+dHalf-page down
ctrl+uHalf-page up
pgdown/pgupFull page down/up

Data operations#

KeyAction
aAdd new entry to current tab
AAdd document with extraction (Docs tab only)
eEdit current cell inline (date columns open calendar picker), or full form if cell is read-only
dToggle delete/restore on selected row
xToggle visibility of soft-deleted rows
pEdit house profile
uUndo last edit
rRedo undone edit
escReturn to Nav mode

Chat overlay#

Press @ from Nav or Edit mode to open the LLM chat. The overlay captures all keyboard input until dismissed. See the LLM Chat guide for full details.

Text input#

KeyAction
enterSubmit query or slash command
up / ctrl+pPrevious prompt from history
down / ctrl+nNext prompt from history
escHide chat overlay (session is preserved)
ctrl+sToggle SQL query display

Model picker#

When typing /model , an autocomplete picker appears:

KeyAction
up / ctrl+pMove cursor up
down / ctrl+nMove cursor down
enterSelect model (pulls if not downloaded)
escDismiss picker

Form mode#

KeyAction
tabNext field
shift+tabPrevious field
ctrl+sSave form
escCancel form (return to previous mode)
1-9Jump to Nth option in a select field

File picker#

When a form field opens a file picker (e.g., A on the Docs tab):

KeyAction
j / downMove down the file list
k / upMove up the file list
h / left / backspaceNavigate to parent directory
enterOpen directory or select file
g / GJump to first/last entry

The picker title shows the current directory path.

Dashboard#

When the dashboard overlay is open:

KeyAction
j/kMove cursor down/up through items
J / shift+downJump to next section
K / shift+upJump to previous section
g/GJump to first/last item
eToggle expand/collapse current section
EToggle expand/collapse all sections
enterJump to highlighted item in its tab
DClose dashboard
b/fDismiss dashboard and switch tab
?Open help overlay (stacks on dashboard)

Date picker#

When inline editing a date column, a calendar widget opens instead of a text input:

KeyAction
h/lMove one day left/right
j/kMove one week down/up
H/LMove one month back/forward
[/]Move one year back/forward
enterPick the highlighted date
escCancel (keep original value)

Note preview#

Press enter on a notes column (e.g., service log Notes) to open a read-only overlay showing the full text. Any key dismisses it.

Extraction overlay#

When a document extraction is in progress or complete, an overlay shows per-step progress (text, OCR, LLM) with a tabbed operation preview. The overlay has two modes. See the extraction pipeline guide for details.

Pipeline mode#

KeyAction
j / kNavigate between extraction steps
enterExpand/collapse current step logs
xEnter explore mode (when operations are available)
aAccept results (when extraction is done with no errors)
rRerun LLM step (when LLM step is complete)
escCancel extraction and close overlay

Explore mode#

KeyAction
j / kNavigate rows in the active table
h / lNavigate columns
b / fSwitch between table tabs
g / GJump to first/last row
^ / $Jump to first/last column
aAccept results
xReturn to pipeline mode
escReturn to pipeline mode

Help overlay#

KeyAction
escClose help
?Close help