Keys and mouse
NOBLE uses a tmux-style prefix (default ctrl+a; press it twice to send a literal ctrl+a to the shell) plus a few direct shortcuts. Everything can be rebound, and ? shows the live reference inside the app.
Direct shortcuts
| Keys | Action |
|---|---|
| alt+1…9 | go to tab |
| alt+0 | Home |
| alt+t | new tab * |
| alt+p | command palette * |
| alt+m | system monitor |
| alt+s | settings * |
| alt+z | zoom pane |
| alt+o | next pane |
| alt+. alt+, | next / previous tab * |
| shift+pgup shift+pgdn | scrollback |
The shortcuts marked * are shell keys too (last argument, transpose words, fish's sudo and pager …), so in a terminal they go to the shell and stay NOBLE's everywhere else; use the prefix keys there instead (ctrl+a : palette, n / p tabs). shell_first = false (Settings → Leave shell keys to the shell) gives them back to NOBLE everywhere.
Passing shortcuts to apps
When an app in a pane needs one of NOBLE's other shortcuts (e.g. alt+m, alt+z), prefix i locks the pane's keys: every shortcut goes to the app (🔒 KEYS on the pane) until prefix i again; the prefix itself keeps working. With passthrough = "once" (Settings → Pass keys to the app) there is no lock: prefix + a shortcut (e.g. ctrl+a alt+m) sends just that key, and prefix i sends the next key.
Keys you type in a pane reach its program with their modifiers, in the form the program asks for: the kitty keyboard protocol for a program that requests it, and console input records on Windows. So shift+enter starts a new line in Claude Code and Codex instead of submitting. On Linux and macOS NOBLE sees Shift+Enter only through an outer terminal that supports the kitty keyboard protocol (see AI agents).
After the prefix
| Keys | Action |
|---|---|
| t c | new tab |
| v | | split right |
| s - | split down |
| x X | close pane / close tab |
| z | zoom pane |
| = | equalize splits (a run of splits in one direction shares the space evenly) |
| } | swap with next pane (the focus moves with it) |
| ! | move pane to a new tab (the shell keeps running) |
| S | settings |
| ← → ↑ ↓ o | move focus |
| shift+arrows H J K L | move divider |
| n p 1…9 0 b | next / previous tab, tab by number, Home |
| m | system monitor |
| pgup [ pgdn ] | scroll the scrollback up / down by a page |
| / | search scrollback |
| a | jump to the next agent that needs you (then your turn, then error) |
| f | focus mode (hide the top and bottom bars on terminal tabs) |
| T | reopen the last closed tab (an agent in it resumes its conversation) |
| u | open a link on the screen |
| y | send the selection or the last command's output to an agent pane (pasted, not run: press ⏎ yourself) |
| , | rename tab |
| < > | move tab left / right |
| . | pane menu (copy path, open folder, VS Code, Launch in split ›, pane operations …) |
| i | pass shortcuts to the app (lock / next key) |
| w | save workspace |
| : space | command palette |
| ? | help |
| r | reload config |
| q | quit |
focus_mode = true) hides NOBLE's top and bottom bars, so the panes get the whole screen, the last row included. Resting the pointer on the top row brings the top bar back; the bottom bar comes back only while the prefix is armed. Resting the pointer on the last row reveals nothing, and clicks there reach the program. Other tabs' alerts show as a ◆ 2 chip on the top row, and a click on it goes to that tab. On Windows a pane that grows taller keeps its shell prompt where it was: the rows added below it stay blank until the shell writes there.Per screen
Home
↑ ↓ select a project · ⏎ open a terminal · → then ⏎ pin to top (★) or more actions (⋯), ← → to choose · c Claude · x Codex · other AI CLIs by their shortcut (Settings → Quick launch) · / search · t terminal at home · o open folder · w save workspace · a add a project or scan a folder · T run a project task · r rescan · R refresh AI · m system · s settings · q quit.
The selected project's card shows a ↻ Continue claude · 2h ago button when Claude Code has a conversation in that folder; click it to open a tab that runs claude --continue there. Claude Code background sessions (claude --bg) are listed in the AI usage panel under a BACKGROUND header; a click attaches to one (see AI agents).
Settings
↑↓ move · ⏎ or space change · ← / → turn a switch off / on and step through values · / filters the rows by name (⏎ keeps the filter, esc clears it) · the wheel scrolls the page · esc back to the page you came from.
System
↑ ↓ select · c m p n sort by CPU, memory, pid or name (again to flip) · / filter · K or del terminate (asks first) · esc back.
Scrollback search
Type to find (case-insensitive) · ⏎ or ↑ older match · ↓ or shift+⏎ newer · esc close.
Matches and the selected one stay on their text while output scrolls. After a resize the search runs again on the reflowed lines.
Notifications
Command palette → Show Notifications lists the last 50, newest first, each with its level (INFO, OK, WARN or ERROR); a repeated notice is one row with a count (×3) · ↑ ↓ select · ⏎ goes to the pane that sent it (a config error opens the file at its line; a plain notice is copied) · ctrl+y copies its text · esc close.
Mouse
- ctrl+click opens a URL (including OSC 8 hyperlinks) in the browser, or a
path:line:colin VS Code. - Click a notification toast to dismiss it and go to the pane that sent it.
- Right-click a tab, pane title or project for a menu.
- Drag tabs to reorder, double-click to rename. Drag dividers to resize; the shells take the new size when you release, and the lines reflow to the new width. On Windows the reflow follows ConPTY's own repaint, so history is not pulled back down when a pane gets taller.
- Hover a project for its pin (★) and more (⋯) buttons; they also show on the selected project.
- The pane buttons
◫(split right),⊟(split down),⤢(zoom) and✕(close) show on the focused pane and on the one under the mouse. Double-click a pane's title to zoom it, and again to restore it. - Drag to select text (copied on release); right-click pastes; the wheel scrolls.
- Scrolled back, click the position bar in the pane's last column or the
↓ livechip to return to the newest output. - shift+drag selects even inside apps that capture the mouse.
@ { } [ ] \ | ~ € on Turkish, German, Polish… layouts) are passed through as characters on Windows, not as ctrl+alt chords. Linux and macOS never send AltGr as Ctrl+Alt, so there Ctrl+Alt with a symbol is a chord: Emacs C-M-/ reaches the program as ESC and the control code.Rebinding
The easiest way is Settings → Key bindings: filter the list with /, press ⏎ on a row to rebind its prefix key or d for its direct chord, x to unbind and r to restore the default. NOBLE asks before it replaces another action's key and writes each change to config.toml.
Bind any key after the prefix, or any global chord, to an action in config.toml; use "none" to unbind. The full list of actions is on the configuration page.