Settings
Global Preferences
Global preferences apply to your whole Spruce installation; every project you open uses them. Find them under Settings → Global preferences.
Appearance
- Color scheme: Light, Dark, or System.
- Accent color: default is the Spruce cyan; customizable.
Terminal
- Shell command: the binary Spruce launches for terminal sessions (e.g.
/bin/zsh). - Shell arguments: args passed on launch (e.g.
-l).
See Shell Configuration for details.
Credentials
Credentials for integrations are stored per your OS's secure credential store (Keychain on macOS, Credential Manager on Windows, Secret Service / libsecret on Linux).
- GitHub token: for opening PRs and integrating with GitHub.
- Other integrations: as they're added.
Credentials are stored per user, not per project, and never written to the Spruce project directory.
Agents
Agent CLI defaults, MCP server wiring, and per-agent install / configuration status live on their own page: Settings → Agents. See Agents Settings for the default-agent selector and the MCP setup affordances.
Keyboard shortcuts
All of Spruce's keyboard shortcuts can be rebound. See Keyboard Shortcuts for the full list and a table of defaults.
Where global preferences live
On disk, global preferences live in your OS application-data directory alongside projects, but at the root, not inside any specific project. They don't travel through the project git flow.
Related
- Agents Settings — pick the default agent and wire up MCP config.
- Per-Project Settings — settings that travel with the project.
- Keyboard Shortcuts — default shortcuts and rebinding.
- Shell Configuration — terminal shell setup.