Skip to main content

Orchestrate coding agents with Symphony

Symphony turns Linear issues into isolated workspaces where coding agents autonomously implement features, fix bugs, and land PRs—while you manage the work, not the agents.

Get StartedView Architecture
$ symphony ./WORKFLOW.md
✓ Polling Linear for issues…
→ Dispatching ABC-123 to workspace
⚡ Running Codex session

Quick Start

Get Symphony running in minutes

1

Install dependencies

Install Elixir and Erlang using mise. Symphony requires Elixir 1.19+ and Erlang/OTP 28.
mise install
mise exec -- elixir --version
2

Set up your environment

Get a Linear API key and configure your repository. Clone Symphony and set up dependencies.
git clone https://github.com/openai/symphony
cd symphony/elixir
mise exec -- mix setup
mise exec -- mix build
You’ll need a Linear API key from Settings → Security & access → Personal API keys. Set it as LINEAR_API_KEY in your environment.
3

Configure your workflow

Copy WORKFLOW.md to your repository and customize it for your project. Define your Linear project slug, workspace root, and agent behavior.
---
tracker:
  kind: linear
  project_slug: "your-project-slug"
workspace:
  root: ~/code/workspaces
agent:
  max_concurrent_agents: 10
---
4

Launch Symphony

Start the orchestrator and watch it autonomously handle your Linear issues.
./bin/symphony ./WORKFLOW.md --i-understand-that-this-will-be-running-without-the-usual-guardrails
Add --port 4000 to enable the HTTP observability dashboard at http://localhost:4000.

Core Features

Everything you need to orchestrate coding agents at scale

Linear Integration

Automatically poll Linear for active issues and dispatch them to isolated workspaces

Workspace Isolation

Each issue gets its own workspace with lifecycle hooks and safe cleanup

Agent Orchestration

Run Codex in app-server mode with configurable concurrency and turn limits

YAML Configuration

Define workflow behavior with YAML frontmatter and Liquid templating

Retry Logic

Exponential backoff and automatic retries for transient failures

Observability

Real-time dashboard, structured logs, and HTTP API for runtime state

Explore by Topic

Dive deeper into Symphony’s architecture and capabilities

Architecture

Understand Symphony’s component design, orchestrator behavior, and agent lifecycle

Learn more

Configuration

Configure tracker integration, workspace behavior, agent limits, and Codex settings

View options

Operations

Run Symphony in production, monitor active agents, and troubleshoot common issues

Explore guides

Specification

Read the language-agnostic spec to implement Symphony in your preferred language

Read spec

Ready to get started?

Symphony is an engineering preview designed for trusted environments. Follow our quickstart to set up your first orchestrated workflow.

Start building with Symphony