Docs

Configuration

One commented config.toml, created on the first launch and reloaded live when you save it. Most options can also be changed from the Settings screen (alt+s).

Where things live

WindowsLinuxmacOS
Config%APPDATA%\noble\config.toml~/.config/noble/config.toml~/Library/Application Support/noble/config.toml
Data%LOCALAPPDATA%\noble~/.local/share/noble~/Library/Application Support/noble

noble --paths prints the exact locations. Set NOBLE_HOME to move both, for example to try things without touching your real setup.

Safe by design: A typo or a bad value shows up as a toast inside NOBLE and the last good config stays in effect. It never crashes the app.

A key or section that NOBLE does not read, such as a typo like scrolback, gets one warning toast that names it and its line, at startup and on each reload. Clicking the toast opens the file at that line. Sections NOBLE has removed, such as [island], are ignored silently.

Full reference

config.toml
[general]
theme = "amber"          # any of the 22 themes in Settings
transparent = false      # let the terminal's own background (blur/opacity) show
boot_animation = true    # first launch and first launch after an update (false: never)
animations = true        # page transitions, zoom, fades and other small animations
animations_on_battery = true  # keep them while a laptop runs on battery (false: off on battery)
clock_24h = true
show_seconds = true
operator = ""            # name in the greeting; empty = your user name
check_updates = true     # look for a new release once a day and show it at the bottom right
show_tips = true         # status bar tips about the current screen (changes with the screen)

[terminal]
shell = ""               # empty = pwsh → powershell → cmd on Windows, $SHELL elsewhere
shell_args = []
scrollback = 5000
restore_session = true
resume_agents = true     # a restored Claude, Codex, Copilot, OpenCode, Antigravity or Cursor pane picks its last conversation up again (false: starts fresh)
copy_on_select = true
osc52_write = true       # programs in a pane may set the clipboard (OSC 52); false ignores them
tab_follows_cwd = true   # name a tab after its current folder (false: the folder it was opened in)
colors = "windows-terminal"  # windows-terminal (your PowerShell scheme; the theme elsewhere) | theme | campbell | dark-plus | light-gray | "wt:<your scheme>" …
background = ""          # override the scheme's background, e.g. "#c8c8c8"
foreground = ""          # override the scheme's text color
notify = true            # toast + bell when a background tab needs attention
notify_after = 10        # report background commands that ran at least this many seconds (0 = off)
dim_inactive = true      # in a split tab, fade the text of the panes without focus
focus_mode = false       # hide NOBLE's top and bottom bars on terminal tabs (prefix f toggles it)

[keys]
prefix = "ctrl+a"
passthrough = "lock"     # "lock": prefix i locks a pane's keys to its app · "once": prefix + shortcut sends it
shell_first = true       # alt+. alt+, alt+t alt+s alt+p go to the shell in a terminal
[keys.prefix_bindings]   # key after the prefix → action ("none" unbinds)
"%" = "split_right"
[keys.direct_bindings]   # global chords
"alt+v" = "split_right"

[projects]
roots = []               # empty = Desktop, Documents, source/repos, projects, Developer, code, dev ...
max_depth = 4
exclude = []

[ai]
enabled = true
refresh_minutes = 5
providers = ["claude", "codex", "antigravity", "opencode-go", "kilo", "command-code"]
warn_at = 90             # warn when a quota window reaches this percent, and when it resets (0 = off)

[[launchers]]            # Home quick launch; hidden when `command` is not on PATH
key = "c"
name = "claude"
command = "claude"
show = true              # false hides it from Home (Settings → Quick launch)

Quick launch defaults

Home shows a launcher only when its command is on your PATH. Each one can be hidden or rebound in Settings → Quick launch, or with more [[launchers]] entries.

KeyCommandTool
cclaudeClaude Code
xcodexCodex
eopencodeOpenCode
icopilotGitHub Copilot CLI
gagyAntigravity
vpiPi
bompoh-my-pi
ffreebuffFreebuff
zgrokGrok Build
ucursor-agentCursor
dcommand-codeCommand Code
lclineCline
nkiloKilo Code

Actions

Use these names in [keys.prefix_bindings] and [keys.direct_bindings]:

bridgesystemsettingsnew_tabclose_tabnext_tabprev_tabtab_1…tab_9move_tab_leftmove_tab_rightsplit_rightsplit_downclose_panezoomfocus_leftfocus_rightfocus_upfocus_downfocus_nextresize_leftresize_rightresize_upresize_downpane_menupalettehelpquitreload_configopen_configcycle_themerefresh_airescan_projectsrename_tabsave_workspacescroll_upscroll_downsearchadd_project_folderadd_projectremove_projectsend_prefixpassthroughjump_to_agentupdatedismiss_updatereopen_tabfocus_modeopen_linknotificationsenable_hooksdismiss_hooks_offerprev_commandnext_commandcopy_last_outputsend_last_outputequalize_panesswap_panemove_pane_to_tab

Terminal colors

Terminal panes can follow the NOBLE theme (colors = "theme"), use a built-in scheme (campbell, dark-plus, light-gray) or, on Windows, a scheme from Windows Terminal: "windows-terminal" picks your PowerShell profile’s scheme and "wt:<name>" any other. On Linux, windows-terminal falls back to the theme. background and foreground override single colors.