orchestra / docs
Documentation/Overview

Welcome to Orchestra

A macOS workspace for your projects, terminals, and coding agents.

On this page One project. All your agents.Your first sessionExplore the workspaceBuilt for your desktop

One project. All your agents.

Orchestra brings your coding CLIs into one desktop app for macOS and Linux. Add an existing project folder, open sessions with your preferred agents, and move between them while their terminals keep running.

Use Claude Code to build, Codex to review, or Pi to explore an approach. Each new session gets its own Git worktree by default, so agents can work in parallel without editing the same checkout. Every session uses your shell configuration and existing agent setup.

Your first session

  1. Set up Orchestra and install an agent CLI.
  2. Click + beside Projects and choose an existing folder.
  3. Open the project row’s + menu, choose Session, and select an agent.

Orchestra is open source under the MIT License. Download it from GitHub Releases or build it from the source repository.

Explore the workspace

Built for your desktop

Orchestra is a Wails app with a Go backend, a Vue interface, and xterm.js terminals. Choose from 30 themes, tune the terminal text and padding, and use keyboard shortcuts and the command bar to move quickly.

Project and session metadata are saved locally. Running processes and terminal scrollback last while the app is open; resume reconnects to a saved agent conversation after a restart.

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