Global Preferences

Global preferences apply to your whole Spruce installation; every project you open uses them. Find them under Settings → Preferences.

Appearance

• Color scheme: Light, Dark, or System.
• Accent color: default is the Spruce cyan; customizable.

Terminal

The integrated terminal's shell, arguments, renderer, and native-launcher selection have their own settings page now: Settings → Terminal. See Terminal Settings for the fields and Shell Configuration for the full reference.

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

• Terminal Settings — integrated terminal shell and renderer.
• 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.