Docs / Configuration
Configuration and themes
Start with Settings for appearance, sessions, keyboard preferences, and integrations. For file-based configuration, edit ~/.config/raven-term/config.toml. The defaults work without a config file.
The config file
# ~/.config/raven-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 spaces/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
Built-in themes, switchable live from Change theme… (⌘K, or ⌘⌥T); a theme of your own is made in the Theme Studio. The selection is stored in ~/.raven/work-ledger.db, which every Raven surface reads; [colors] overrides in the TOML apply on top of whichever theme is active.
Keyboard shortcuts
- ⌘DSplit the focused pane (BSP)
- ⌘TNew space
- ⌘WClose pane
- ⌘⇧[ ]Previous / next space
- ⌘1–9Jump to space
- ⌘KCommand palette
- ⌘⇧ENotes pane
- ⌘⇧PPull request pane
- ⌘C / VCopy / paste (bracketed)
- ⌘clickOpen hyperlink (OSC 8)
The chords are fixed: one shortcut grammar, the same on every install, is what makes it teachable — the modifier says how far the action reaches and the letter comes from the action's own name. Settings (⌘,) has four sections — Appearance, Session, Keyboard and Integrations — and the Keyboard one chooses the space-shortcut scheme, not the bindings. There is no separate settings application: the terminal owns its own settings, and the notch companion owns the update ones.