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

	Windows	Linux
Config	`%APPDATA%\noble\config.toml`	`~/.config/noble/config.toml`
Data	`%LOCALAPPDATA%\noble`	`~/.local/share/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.

Full reference

config.toml

[general]
theme = "amber"          # any of the 20 themes in Settings
transparent = false      # let the terminal's own background (blur/opacity) show
boot_animation = true
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

[terminal]
shell = ""               # empty = pwsh → powershell → cmd on Windows, $SHELL elsewhere
shell_args = []
scrollback = 5000
restore_session = true
copy_on_select = true
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)

[keys]
prefix = "ctrl+a"
[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, code, dev, src, repos …
max_depth = 4
exclude = []

[ai]
enabled = true
refresh_minutes = 5
providers = ["claude", "codex", "antigravity", "opencode-go", "kilo", "command-code"]
warn_at = 90             # warn once when a quota window reaches this percent (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.

Key	Command	Tool
`c`	`claude`	Claude Code
`x`	`codex`	Codex
`e`	`opencode`	OpenCode
`i`	`copilot`	GitHub Copilot CLI
`g`	`agy`	Antigravity
`v`	`pi`	Pi
`b`	`omp`	oh-my-pi
`f`	`freebuff`	Freebuff
`z`	`grok`	Grok Build
`u`	`cursor-agent`	Cursor
`d`	`command-code`	Command Code
`l`	`cline`	Cline
`n`	`kilo`	Kilo Code

Actions

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

bridgesystemnew_tabclose_tabnext_tabprev_tabtab_1…tab_9split_rightsplit_downclose_panezoomfocus_leftfocus_rightfocus_upfocus_downfocus_nextresize_leftresize_rightresize_upresize_downpalettehelpquitreload_configopen_configcycle_themerefresh_airescan_projectsrename_tabsave_workspacescroll_upscroll_downsearchsend_prefix

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.