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
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
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

Dashboard#

When the dashboard overlay is open:

KeyAction
j/kMove cursor down/up through items
g/GJump to first/last item
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.

Help overlay#

KeyAction
escClose help
?Close help