Keyboard Shortcuts
Comprehensive keyboard shortcuts reference for the CodeCLI TUI. Shortcuts are organized by context: global shortcuts that work everywhere, input mode shortcuts, navigation, and session management.
iNote
Shortcuts can be customized in
~/.config/codecli/keybindings.json. See the keybindings documentation for customization instructions.Global Shortcuts
These shortcuts work in any context within the TUI.
| Shortcut | Action | Description |
|---|---|---|
| Ctrl+C | Cancel / Interrupt | Cancel the current operation. If the agent is running, stops generation. If idle, exits the TUI. |
| Ctrl+D | Exit | Exit the TUI. If there is an active session, prompts to save before exiting. |
| Ctrl+L | Clear Screen | Clear the terminal screen and redraw the TUI. Useful after unexpected output corruption. |
| Ctrl+Z | Suspend | Suspend the TUI process and return to the shell. Resume with fg. |
| Escape | Cancel / Close | Close the current overlay, modal, or popup. Return focus to the previous element. |
| ? | Help | Open the help overlay showing all available shortcuts for the current context. |
Input Mode
Shortcuts available when the text input is focused.
| Shortcut | Action | Description |
|---|---|---|
| Enter | Submit | Submit the current message to the agent |
| Shift+Enter | New Line | Insert a newline without submitting. For multi-line input. |
| Tab | Autocomplete | Trigger autocomplete for file paths, slash commands, and model names |
| Shift+Tab | Previous Suggestion | Cycle backwards through autocomplete suggestions |
| Up Arrow | History Back | Navigate backwards through message history |
| Down Arrow | History Forward | Navigate forwards through message history |
| Ctrl+A | Select All | Select all text in the input field |
| Ctrl+W | Delete Word | Delete the word before the cursor |
| Ctrl+K | Delete to End | Delete from cursor to end of line |
| Ctrl+U | Delete to Start | Delete from cursor to start of line |
| / | Slash Command | Start a slash command. Type / followed by a command name. |
Slash Commands
Slash commands are special directives entered in the input field. They start with /.
| Command | Description |
|---|---|
| /help | Show available slash commands and shortcuts |
| /clear | Clear the conversation display |
| /compact | Manually trigger context compaction |
| /model NAME | Switch the active model mid-session |
| /agent NAME | Switch to a named agent configuration |
| /tools | Open the tools management view |
| /skills | Open the skills management view |
| /mcp | Open the MCP servers management view |
| /sessions | Open the session browser |
| /export | Export the current session |
| /stats | Show session statistics |
| /btw QUESTION | Ask a side question without interrupting the main task |
| /plan | Show or update the current task plan |
| /kanban | Show or update the kanban board |
| /quit | Exit the TUI |
Navigation
Shortcuts for navigating through the conversation, panels, and views.
| Shortcut | Action | Context |
|---|---|---|
| Ctrl+P | Previous Message | Scroll up to the previous assistant message |
| Ctrl+N | Next Message | Scroll down to the next assistant message |
| Ctrl+U | Scroll Up | Scroll the conversation view up by half a page |
| Ctrl+D | Scroll Down | Scroll the conversation view down by half a page |
| Home | Scroll to Top | Jump to the top of the conversation |
| End | Scroll to Bottom | Jump to the bottom of the conversation (latest message) |
| Page Up | Page Up | Scroll up by one full page |
| Page Down | Page Down | Scroll down by one full page |
| Ctrl+Tab | Next Panel | Switch focus to the next panel (in split-panel views) |
| Ctrl+Shift+Tab | Previous Panel | Switch focus to the previous panel |
| g g | Go to Top | Vim-style: jump to the top of the conversation |
| G | Go to Bottom | Vim-style: jump to the bottom of the conversation |
| / | Search | Open the search bar to find text in the conversation |
| n | Next Match | Jump to the next search match |
| N | Previous Match | Jump to the previous search match |
Session Management
Shortcuts for managing sessions during a TUI session.
| Shortcut | Action | Description |
|---|---|---|
| Ctrl+S | Save Session | Explicitly save the current session to disk |
| Ctrl+O | Open Session | Open the session browser to load a previous session |
| Ctrl+N | New Session | Start a new session (prompts to save current if active) |
| Ctrl+F | Fork Session | Fork the current session into a new session at this point |
View Controls
Shortcuts for toggling UI elements and switching views.
| Shortcut | Action | Description |
|---|---|---|
| Ctrl+B | Toggle Sidebar | Show or hide the sidebar navigation panel |
| Ctrl+T | Toggle Tools Panel | Show or hide the tools/kanban sidebar panel |
| Ctrl+J | Toggle JSON View | Toggle raw JSON view for the current message (shows tool calls and responses) |
| Ctrl+G | Toggle Compact Mode | Switch between full and compact conversation display |
| F11 | Toggle Fullscreen | Toggle fullscreen terminal mode (where supported) |
| Ctrl+1 | Tab 1 | Switch to tab 1 (Conversation) |
| Ctrl+2 | Tab 2 | Switch to tab 2 (Tools) |
| Ctrl+3 | Tab 3 | Switch to tab 3 (MCP) |
| Ctrl+4 | Tab 4 | Switch to tab 4 (Skills) |
| Ctrl+5 | Tab 5 | Switch to tab 5 (Kanban) |
Mainframe Mode
Additional shortcuts available when running in mainframe mode.
| Shortcut | Action | Description |
|---|---|---|
| Ctrl+Shift+1-9 | Focus Pane | Switch focus to the numbered agent pane |
| Ctrl+Shift+B | Broadcast | Open broadcast input to send a message to all panes |
| Ctrl+Shift+M | Merge Results | Collect and merge results from all agent panes |
| Ctrl+Shift+L | Change Layout | Cycle through available pane layouts (1x1, 2x1, 2x2, 3x1) |
| Ctrl+Shift+K | Kill Pane | Kill the currently focused agent pane |
| Ctrl+Shift+S | Spawn Pane | Spawn a new agent pane |