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.