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 | macOS | |
|---|---|---|---|
| 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.
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
[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.
| 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]:
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.