Docs

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

KeysAction
alt+1…9go to tab
alt+0Home
alt+tnew tab *
alt+pcommand palette *
alt+msystem monitor
alt+ssettings *
alt+zzoom pane
alt+onext pane
alt+. alt+,next / previous tab *
shift+pgup shift+pgdnscrollback

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

KeysAction
t cnew tab
v |split right
s -split down
x Xclose pane / close tab
zzoom 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)
Ssettings
← → ↑ ↓ omove focus
shift+arrows H J K Lmove divider
n p 1…9 0 bnext / previous tab, tab by number, Home
msystem monitor
pgup [ pgdn ]scroll the scrollback up / down by a page
/search scrollback
ajump to the next agent that needs you (then your turn, then error)
ffocus mode (hide the top and bottom bars on terminal tabs)
Treopen the last closed tab (an agent in it resumes its conversation)
uopen a link on the screen
ysend 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 …)
ipass shortcuts to the app (lock / next key)
wsave workspace
: spacecommand palette
?help
rreload config
qquit
Focus mode: On a terminal tab, focus mode (prefix f, or 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

Keyboard layouts: AltGr symbols (@ { } [ ] \ | ~ € 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.