Complete Keybinding Reference

This page is the canonical reference for every keybinding in AZUREAL. It is organized by context – the mode or panel that must be active for the keybinding to apply. For conceptual explanations of the modal input system, see Keybindings & Input Modes.

Platform note: This reference uses macOS modifier notation (Cmd, Ctrl, Alt/Option). On Windows and Linux, substitute Ctrl for Cmd and Alt for Ctrl in most cases. See Platform Differences for the full mapping table.

Global (Command Mode)

These keybindings are available in command mode across the main worktree view. They do not fire during text input (prompt mode, edit mode, terminal type mode, or active filter/search inputs).

Key	Action	Notes
`Ctrl+Q`	Quit	Prompts confirmation if agents are running
`Ctrl+D`	Debug dump	Opens naming dialog, then writes state snapshot to file
`Ctrl+C` / `Alt+C`	Cancel agent	Kills the active agent in the current slot. macOS uses `Ctrl+C`; Windows/Linux uses `Alt+C`
`Cmd+C` / `Ctrl+C`	Copy selection	Copies from whichever pane has an active text selection. macOS uses `Cmd+C`; Windows/Linux uses `Ctrl+C`
`Ctrl+M`	Cycle model	Rotates through available models: opus, sonnet, haiku, gpt-5.4, and others
`?`	Help overlay	Opens the help overlay showing all keybindings for the current context
`p`	Enter prompt mode	Focuses the input area for typing a prompt. Closes the terminal if it is open
`T`	Toggle terminal	Opens or closes the embedded terminal pane
`G`	Git panel	Opens the git panel overlay
`H`	Health panel	Opens the health panel overlay
`M`	Browse main branch	Switches view to the main branch (read-only browse)
`P`	Projects panel	Opens the projects panel overlay
`r`	Run command	Opens the run-command picker, or executes directly if only one command is registered
`R`	Add run command	Opens the dialog to register a new run command
`[` / `]`	Switch worktree tab	Moves to the previous/next worktree tab. Wraps around at both ends
`Tab` / `Shift+Tab`	Cycle pane focus	Cycles focus through FileTree, Viewer, Session, and Input in order

Worktree Actions

Worktree operations use either a W leader key sequence (press W, then the action key) or a direct key when the worktree tab row is focused. See Leader Sequences for details on the leader key mechanism.

Key	Action
`Wn` / `n`	Create new worktree
`Wr` / `r`	Rename worktree
`Wa` / `a`	Archive or unarchive worktree (toggles based on current state)
`Wd` / `d`	Delete worktree

Input / Prompt Mode

Active when the input area is focused for typing a prompt to an agent. The input area border turns yellow to indicate prompt mode.

Key	Action
`Enter`	Submit prompt
`Shift+Enter`	Insert newline
`Esc`	Return to command mode
`Ctrl+S` / `Alt+S`	Toggle speech-to-text
`Alt+P`	Preset prompts picker
`Alt+1` through `Alt+9`, `Alt+0`	Quick-select preset
`Up` / `Down`	History prev/next
`Alt+Left` / `Alt+Right`	Word navigation
`Ctrl+W`	Delete word

Session Pane (Command Mode)

These keybindings apply when the session pane is focused and you are in command mode (not typing a prompt).

Key	Action
`j` / `k`	Scroll line
`J` / `K`	Page scroll
`Up` / `Down`	Jump to next/prev message
`Shift+Up` / `Shift+Down`	Jump to next/prev prompt
`Alt+Up` / `Alt+Down`	Top / bottom
`a`	New session
`s`	Toggle session list
`/`	Search text
`n` / `N`	Next/prev search match

Session List Overlay

The session list is a modal overlay for browsing, loading, and managing saved sessions. It appears over the session pane when s is pressed.

Key	Action
`j` / `k`	Navigate
`J` / `K`	Page scroll
`Enter`	Load session
`a`	New session
`r`	Rename session
`/`	Filter by name
`//`	Content search
`s` / `Esc`	Close

File Tree

These keybindings apply when the file tree pane is focused.

Key	Action
`j` / `k` / `Up` / `Down`	Navigate
`h` / `Left`	Collapse / go to parent
`l` / `Right`	Expand directory
`Enter`	Open file / toggle directory
`Space`	Toggle directory
`Alt+Right` / `Alt+J`	Recursive expand
`Alt+Left` / `Alt+K`	Recursive collapse
`Alt+Up` / `Alt+Down`	Jump to first/last sibling
`a`	Add file/directory
`d`	Delete
`r`	Rename
`c`	Copy (clipboard mode)
`m`	Move (clipboard mode)
`O`	Options overlay

Viewer

These keybindings apply when the file viewer pane is focused in its default read-only mode.

Key	Action
`j` / `k`	Scroll line
`J` / `K`	Page scroll
`Alt+Up` / `Alt+Down`	Top / bottom
`Alt+Left` / `Alt+Right`	Cycle through edits
`e`	Enter edit mode
`Cmd+A` / `Ctrl+A`	Select all
`t`	Save to tab
`Alt+T`	Tab picker dialog
`x`	Close current tab
`Esc`	Close viewer

Edit Mode

Active when the viewer is in edit mode (entered with e from the viewer). The viewer border changes to indicate edit mode is active.

Key	Action
Any printable key	Insert text
`Backspace` / `Delete`	Delete character
Arrow keys	Move cursor
`Home` / `End`	Line start/end
`Cmd+S` / `Ctrl+S`	Save
`Cmd+Z` / `Ctrl+Z`	Undo
`Cmd+Shift+Z` / `Ctrl+Y`	Redo
`Ctrl+S` / `Alt+S`	Speech-to-text
`Esc`	Exit edit mode

Terminal Command Mode

Active when the terminal pane is visible and focused, but you have not entered type mode. The terminal border turns azure. All global keybindings continue to work in this mode.

Key	Action
`t`	Enter type mode
`Esc`	Close terminal
`+` / `-`	Resize height
All globals	Work normally

Terminal Type Mode

Active when the terminal is in type mode (entered with t from terminal command mode). All keystrokes are forwarded to the PTY except the escape and navigation overrides listed below.

Key	Action
`Esc`	Exit type mode
`Alt+Left` / `Alt+Right`	Word navigation
`Ctrl+Left` / `Ctrl+Right`	Word navigation
All other keys	Forward to PTY

Git Panel

The git panel is a modal overlay opened with G. It has three focus areas – Actions (pane 0), Files (pane 1), and Commits (pane 2) – cycled with Tab/Shift+Tab. The Viewer pane always shows the diff for the selected file or commit but is not a separate focus target. Some keybindings are context-dependent based on which area is focused and whether the current worktree is the main branch or a feature branch.

Actions Pane

Key	Action	Context
`l`	Pull	Main branch only
`m`	Squash merge	Feature branch only
`R`	Rebase	Feature branch only
`c`	Commit	Any branch
`P`	Push	Any branch
`z`	Stash	Any branch
`Z`	Stash pop	Any branch
`a`	Toggle auto-rebase	Feature branch only
`s`	Auto-resolve settings	Actions pane only

Files Pane

Key	Action
`j` / `k`	Navigate
`s`	Toggle stage/unstage
`S`	Stage/unstage all
`x`	Discard changes
`Enter` / `d`	View diff

Commits Pane

Key	Action
`j` / `k`	Navigate
`Enter` / `d`	View diff

Panel-Level

Key	Action
`Tab` / `Shift+Tab`	Cycle pane focus
`[` / `]`	Switch worktree
`{` / `}`	Jump page
`r`	Refresh
`Cmd+A` / `Ctrl+A`	Select all (viewer)
`Cmd+C` / `Ctrl+C`	Copy selection
`J` / `PageDown`	Page down diff
`K` / `PageUp`	Page up diff
`Esc`	Close panel

Commit Editor

The commit editor appears when c is pressed in the git panel actions pane. It provides a text input area for composing a commit message (optionally pre-filled with an AI-generated message).

Key	Action
`Enter`	Commit
`Cmd+P`	Commit + push
`Shift+Enter`	Insert newline
`Esc`	Cancel

Health Panel

The health panel is a modal overlay opened with H. It has two tabs – God Files and Documentation – switched with Tab. Some keybindings differ by tab.

Both Tabs

Key	Action
`j` / `k`	Navigate
`J` / `K`	Page scroll
`Alt+Up` / `Alt+Down`	Jump top/bottom
`Space`	Toggle check
`a`	Toggle all
`v`	View checked as tabs

Tab-Specific

Key	Action	Tab
`Enter` / `m`	Modularize	God Files – spawn an agent to split the selected file
`Enter` / `m`	Document	Documentation – spawn an agent to document the selected item

Panel-Level

Key	Action
`s`	Scope mode
`Tab`	Switch tab
`Esc`	Close panel

Projects Panel

The projects panel is a modal overlay opened with P. When AZUREAL starts outside of a git repository, this panel appears automatically as a full-screen view.

Key	Action
`j` / `k`	Navigate
`Enter`	Switch to project
`a`	Add project
`d`	Delete from list
`n`	Rename display name
`i`	Initialize git repo
`Esc`	Close
`Ctrl+Q`	Quit

Quick Reference by Key

The table below lists every single-key binding and its meaning across different contexts. This is useful for answering “what does this key do?” when you are unsure of your current context.

Key	Command Mode	Session Pane	File Tree	Viewer	Git Panel	Health Panel	Projects Panel
`a`	–	New session	Add file	–	Auto-rebase / Toggle all	Toggle all	Add project
`c`	–	–	Copy (clipboard)	–	Commit	–	–
`d`	–	–	Delete	–	View diff	–	Delete project
`e`	–	–	–	Edit mode	–	–	–
`i`	–	–	–	–	–	–	Init git repo
`j`	–	Scroll down	Navigate down	Scroll down	Navigate down	Navigate down	Navigate down
`k`	–	Scroll up	Navigate up	Scroll up	Navigate up	Navigate up	Navigate up
`l`	–	–	Expand	–	Pull (main)	–	–
`m`	–	–	Move (clipboard)	–	Squash merge	Modularize/Document	–
`n`	–	Next match	–	–	–	–	Rename
`p`	Prompt mode	–	–	–	–	–	–
`r`	Run command	–	Rename	–	Refresh	–	–
`s`	–	Session list	–	–	Stage / Auto-resolve / Scope	Scope mode	–
`t`	–	–	–	Save to tab	–	–	–
`v`	–	–	–	–	–	View as tabs	–
`x`	–	–	–	Close tab	Discard changes	–	–
`z`	–	–	–	–	Stash	–	–
`?`	Help overlay	–	–	–	–	–	–
`/`	–	Search	–	–	–	–	–

Platform Modifier Summary

For quick reference, here is the modifier key mapping between platforms. The full explanation is at Platform Differences.

Action	macOS	Windows / Linux
Copy	`Cmd+C`	`Ctrl+C`
Cancel agent	`Ctrl+C`	`Alt+C`
Save	`Cmd+S`	`Ctrl+S`
Undo	`Cmd+Z`	`Ctrl+Z`
Redo	`Cmd+Shift+Z`	`Ctrl+Y`
Select all	`Cmd+A`	`Ctrl+A`
STT (edit/prompt)	`Ctrl+S`	`Alt+S`

Non-modifier keys (p, j, k, T, G, ?, /, etc.) are identical on all platforms. When in doubt, press ? to see the correct bindings for your system.

Keyboard shortcuts

AZUREAL Manual