orchestra documentation

orchestra is a self-improving agentic dev system - it runs a fleet of opinionated agents that pick up work from Linear, GitHub, and Slack, do it in isolated git worktrees, and open PRs. It has one objective pursued two ways: it improves its own harness, and it ships your product. It is self-improving, not self-governing - every decision goes through a human.

These pages are the reference for running and extending it.

Getting started

• Setup - stand orchestra up on a fresh VM, configure it for your org, and verify.

Reference

• Architecture - topology, processes, data flow, and the TUI.
• Agents - the roster, triggers, write scopes, routing, and the handoff model.
• Data model - SQLite schema, queue lifecycle, and the plan JSON shape.
• Ops - secrets, deploy paths, systemd, ingestion contracts, and recovery.

Deep dives

• Design patterns - the reusable patterns the system is built on.
• Decisions - architectural rationale, grouped by concern.
• Agent handoff protocol - how agents escalate to a human.
• Delegator GitHub comment mapping - webhook field mappings.

Looking to install? Start with Setup. Source lives on GitHub.