orchestra / docs
Documentation/Reference

Contributing

Report issues, propose changes, and build Orchestra locally.

On this page IssuesPull requestsBuild and check

Issues

Report bugs and request features on GitHub Issues. Search existing issues first, and include the steps that reproduce a bug.

Pull requests

Fork the repository, make your change on a branch, and open a pull request. Read AGENTS.md in the repository before changing how a feature works. Contributions are accepted under the MIT License.

Build and check

Follow Build from source, then run the checks that apply to your change from the repository root:

Terminal
npm --prefix frontend test
npm --prefix frontend run build
go test -race ./...
go vet ./...
make build

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