Keybindings

Keybindings

Global Keybindings

Key	Action	Context
Enter	Send message / Confirm	REPL, modals
Ctrl+C	Cancel stream; 2nd press exits	Global
Esc	Close modal / Go back	Selectors, modals
Ctrl+P	Open command palette	Global
Ctrl+Q	Open quick actions	Global
Tab	Cycle autocomplete forward	REPL
Shift+Tab	Cycle autocomplete backward	REPL
Ctrl+S	Save session checkpoint	REPL (session active)

Permission Modal

When a tool execution requires permission:

Key	Action
y	Allow this execution
a	Allow always (remember for this session)
n	Deny this execution
e	Exit application

Leader Key Shortcuts

Press Ctrl+X followed by a key for quick navigation (configurable timeout, default 1000ms):

Shortcut	Action
Ctrl+X H	Help screen
Ctrl+X S	Settings
Ctrl+X B	Toggle sidebar
Ctrl+X P	Theme picker
Ctrl+X M	Model selector
Ctrl+X R	Resume session
Ctrl+X N	New workflow
Ctrl+X L	Learning ledger
Ctrl+X K	Rollback browser
Ctrl+X T	Toggle theme
Ctrl+X D	Dashboard
Ctrl+X F	File explorer
Ctrl+X !	Notifications

REPL Keys

Key	Action
Enter	Send message
Up	Previous message in history
Down	Next message in history
Tab	Autocomplete forward
Shift+Tab	Autocomplete backward
Ctrl+L	Clear screen
Ctrl+U	Clear current line
Ctrl+A	Move cursor to start
Ctrl+E	Move cursor to end
Ctrl+W	Delete word backward
Ctrl+K	Delete to end of line

Model Selector

Key	Action
Up/Down	Navigate model list
Enter	Select model
Esc	Close selector
Type	Fuzzy filter models

Screen Navigation

Source: internal/tui/keybindings_screens.go

Each screen has its own keybinding set. Common patterns:

Key	Action
Esc	Return to previous screen
q	Quit (from non-input screens)
j/k	Navigate up/down (Vim-style)
g/G	Jump to top/bottom
/	Search within screen

Mouse Support

Full mouse interaction is supported across all viewport-based screens:

Event	Action
Scroll wheel	Scroll viewport content
Left-click on viewport	Focus textarea + mark user-scrolled
Left-click on overlay	Select suggestion item
Scrollbar drag	Drag-scroll the viewport

See Mouse Support for detailed interaction patterns.

Configuration

Leader key and timeout are configurable:

[ui]
leader_key = "ctrl+x"
leader_timeout_ms = 1000

Keybinding Source

Keybindings are defined in:

• internal/tui/keybindings.go -- Global key mapping table
• internal/tui/keybindings_screens.go -- Per-screen keybindings
• internal/tui/app_update.go -- Key handling in Update loop