Skip to main content
Open Settings from the account menu at the bottom of the sidebar, or press ⌘,. Settings opens in its own window, with a list of sections on the left.

Chat

  • Default agent. The agent Palette uses for new tabs.
  • Smart checkpoint names. Uses the active agent to give each checkpoint a short, descriptive name based on your prompt.
  • Syntax highlighting. Colors code blocks by language in chat replies. You can also turn it on or off for one block.
  • Palette documentation. Lets agents search these docs while they work, and report a page that is wrong or incomplete. Codex can’t use this.

Accounts

  • Palette. Shows the Palette account you are signed in with. Sign in or out here.
  • Providers. One row for each provider, such as Anthropic, OpenAI, Mistral and Google. Open a row to choose how the agent connects (Authentication) and to sign in.
See Agents for which plans and keys each agent accepts.

Agents

Each agent has its own section: Palette, Claude Code, Codex, Mistral Vibe and Gemini CLI.
  • Enabled. Turn an agent on to install it, and off to remove it. Palette installs and updates each agent for you, so you never need a terminal.
  • Setup. Shows the account the agent uses and its installed version. Click the icon beside the version to show the installation in Finder.
  • Defaults. Settings for that agent only, such as Skill sources for Claude Code: load skills and slash commands from the project, your user folder, or both.
The Palette section also holds the model settings for the Palette agent: a cloud model, an on-device model, or a self-hosted endpoint.

Appearance

Theme sets the app to Light, Dark or Auto. Auto follows your Mac.

Notifications

  • Notifications. Get a notification when an agent finishes or needs your input while Palette is in the background.
  • Sound. Play a sound with each notification, and choose its Sound style.

About

  • Version. The exact build you are running.
  • Update channel and Check for Updates. See Updates.
  • Open Source Licenses. The third-party software Palette uses, with its licenses.