orchestra / docs
Documentation/Configuration

Appearance

Choose a palette for the whole workspace, including your terminals.

On this page Open appearance settings30 themesChange themes quicklyYour own themesWindow and app iconAdjust terminal text

Open appearance settings

Press ⌘,, click Settings in the sidebar, or use the app menu. Settings has General, Agents, Appearance, Terminal, Usage, and Privacy sections.

In Appearance, choose Light or Dark mode, select a theme, and turn Arc Mode on or off. Dark mode with the System theme is the default.

30 themes

System, Absolutely, Aubergine, Ayu, Catppuccin, Codex, Dracula, Everforest, GitHub, Gruvbox, Linear, Lobster, Material, Matrix, Monokai, Night Owl, Nord, Notion, OG, One, Oscurange, Raycast, Rose Pine, Sentry, Solarized, Temple, Tokyo Night, Vercel, VS Code Plus, and Xcode.

The palette applies to the window, sidebar, status bar, pages, controls, dialogs, terminal, and embedded GitHub content. Agent logos retain their original brand colors.

Change themes quickly

Press ⌘K, choose Change Theme…, and select a palette without leaving your current screen. The command bar can also switch between Light and Dark, as can the theme button in the status bar.

Your own themes

Add a folder to ~/.orchestra/themes and it appears in the Custom section of the theme picker. To start from an existing palette, select it and choose Duplicate as Custom Theme…; Orchestra saves a copy there and selects it, so you can edit its theme.json. See Custom themes for the file format.

Window and app icon

On macOS, Settings → Appearance also has:

  • Translucent Window: show the desktop through the window with a blur, with an opacity from 40% to 95%. Dialogs and menus stay opaque, and the window stays opaque while macOS Reduce Transparency is on.
  • App Icon: a White or Black Dock icon, kept when you reopen Orchestra.

Adjust terminal text

In Settings → Terminal, set the font size between 10 and 24 pt and the horizontal and vertical padding between 0 and 24 px. Turn off Font Smoothing for thinner, lighter glyphs. Appearance and terminal preferences persist across launches.

Browse documentation

Welcome to OrchestraA macOS workspace for your projects, terminals, and coding agents.
InstallationDownload Orchestra from GitHub Releases, or build it from source.
Projects & sessionsOrganize your work around folders, with an isolated worktree and terminal for every session.
Supported agentsUse the agent CLIs you already know, with their own configuration and credentials.
TerminalA real interactive terminal, running your agent or shell in its own folder.
Sidebar & navigationArrange the sidebar, switch projects with Arc Mode, and keep track of activity.
Saved workspace & resumeReturn to your projects and continue a captured agent conversation.
Issues & pull requestsRead and triage repository context, then start an agent session without leaving Orchestra.
Session messagingExchange requests and replies between existing sessions in the same project.
AppearanceChoose a palette for the whole workspace, including your terminals.
Custom themesCreate your own palette in a JSON file and use it beside the built-in themes.
UsageSee subscription limits for your agents and OpenRouter spend by model.
Settings & storageGeneral preferences and where Orchestra keeps workspace metadata and message history.
Privacy & usage dataOptional anonymous usage sharing, approximate city and country, and every collected event.
Keyboard shortcutsThe everyday actions you can reach from the keyboard.
ContributingReport issues, propose changes, and build Orchestra locally.
FAQAnswers to the questions that come up before your first session.
↑↓ Navigate↵ Openesc Close