Docs / Configuration
One TOML file. Deliberately.
Configuration is TOML at ~/.config/quorum-term/config.toml — not Lua. That's a design decision, not a gap: a Lua runtime is a C binding, and the pure-Rust invariant wins. The opinionated defaults mean most people never need the file at all.
The config file
# ~/.config/quorum-term/config.toml — everything optional
font_size = 13.0
font_family = "JetBrainsMono Nerd Font Mono"
scrollback_lines = 10000
padding = 2.0
# launch something other than $SHELL in new panes
# program = ["ssh", "devbox"]
restore_session = true # persist tabs/panes across restarts
resume_agents = true # respawn claude/codex by resuming sessions
[colors] # per-color overrides on top of the theme
# background = "#0b0b10"
# ansi = ["#...", ...] # 16 entries: 0-7 normal, 8-15 bright
[[projects]] # per-machine worktree environments
root = "~/code/myapp"
[[projects.up]]
name = "web"
command = "npm run dev"Themes
Seven built-in themes, switchable live from the Theme Editor (⌘K). The selection is stored in ~/.quorum/terminal-theme.json, shared with the Quorum settings app; [colors] overrides in the TOML apply on top of whichever theme is active.
Gruvbox (default)Tokyo NightCatppuccin MochaNordSolarized DarkXcode DarkXcode Light
Keyboard shortcuts
- ⌘DSplit the focused pane (BSP)
- ⌘TNew tab
- ⌘WClose pane
- ⌘⇧[ ]Previous / next tab
- ⌘1–9Jump to tab
- ⌘KCommand palette
- ⌘⇧WWorktree picker
- ⌘⇧VToggle voice dictation
- ⌘C / VCopy / paste (bracketed)
- ⌘clickOpen hyperlink (OSC 8)
Every chord is rebindable in Settings → Keyboard Shortcuts — from the in-terminal overlay or the macOS settings app; both write the same file.