Themes and appearance

The app separates app-wide appearance from per-workspace color. Pick one global mode, then tint each workspace independently so personal, work, and client contexts stay visually distinct.

Appearance mode

Set the app to System, Light, or Dark from Settings. System follows the macOS appearance and switches when the OS does. Light and Dark lock the app to that mode.

Mode changes apply live across the app and every open workspace.

Default and workspace themes

Default theme supplies the starting appearance for new workspaces and the value used when you reset a workspace theme. Choose Customize theme to edit the active workspace without changing every other workspace.

Workspace colors

Each workspace carries its own background, accent, and highlight colors, stored independently for light and dark mode. The same workspace can show a teal tint in dark mode and a warm orange tint in light mode.

Customize Theme edits one mode and one color at a time. Choose Light or Dark, then choose a target:

Background tints the sidebar, panel borders, and surrounding frame.
Accent tints tabs, links, command-key affordances, and the active workspace marker.
Highlight controls selected and emphasized content.

Pick a color from the canvas, a preset swatch, or the eyedropper. Swatches include colors from your other workspaces. The copy button starts from another color: Copy from Light or Copy from Dark for Background, Copy from Background for Accent, and Copy from Accent for Highlight.

Intensity, alpha, and prominence

Sliders below the canvas fine-tune the selected target:

Intensity (Background) controls how strongly the workspace color tints the chrome.
Alpha (Background) sets how opaque the chrome is. Lower values let more of the desktop or window behind show through.
Prominence (Accent and Highlight) ranges from neutral to vivid.

Lower values produce a quieter chrome; higher values push the workspace identity forward.

Save or reset

Changes preview live. Select Save Light Theme or Save Dark Theme to keep the edited mode. Reset returns both modes to your default theme, and Set as default theme makes the current colors the starting point for new workspaces.

Fonts

Choose the installed fonts used by code-oriented surfaces:

Monospace font — code blocks, the diff view, and inline code in chat. Set it in Settings → Appearance.
Terminal font — the terminal pane. Set it in Settings → Terminal.

The app ships sensible defaults and lets you choose any other installed font.

Text sizes

Surface-specific size controls let you tune individual areas without resizing the whole app:

Chat text scale — chats and agent terminal tabs.
Editor and diff font size — code in the editor and diff views.
Terminal tab font size — the main terminal pane.
Right-sidebar terminal font size — terminals docked in the right panel.

Chat and editor sizes live in Settings → Appearance; the terminal sizes live in Settings → Terminal. Adjust the surface that feels cramped; the app keeps these sizes independent.

Terminal colors

Choose a terminal color palette in Settings → Terminal, separately from the workspace chrome. The palette changes terminal foreground, background, and ANSI colors without changing the app theme, and follows light and dark mode automatically.

Tabs, sidebars, and status

Appearance settings also control several layout-related visual defaults:

Workspace-tab placement and pinned-tab style.
Compact or Detailed left-sidebar layout and the compact sidebar label.
The number of visible worktrees per project.
Sidebar commit status.
Default right-panel layout and automatic sidebar hiding.
Word wrap in the editor and diff view.
Live-edit previews in Chat UI.
Loading-indicator style.

You can also select the app’s Dock icon under App Icon. For resizing, splitting, and floating-window behavior, see Layout, sidebars, and PiP.

Live updates

Theme, color, transparency, font, and size changes apply immediately. Switch workspaces and the chrome retints to match the new context.