Symphony

Get started in 5 minutes

curl -sSL https://raw.githubusercontent.com/digitaldrywood/symphony/main/scripts/install.sh | sh
symphony --version
symphony init

Open the onboarding wizard at http://localhost:4000/onboarding.

Symphony runs as one binary per host; if you already have Symphony installed on this machine, the installer will detect and refuse a second install. Running symphony init starts the onboarding flow for your first project.

By default, the installer uses ~/symphony for regular users and /opt/symphony for root. It links the release command into /usr/local/bin when that directory is writable, otherwise into ~/.local/bin.

The installer also creates ~/.symphony/global.yaml when it does not already exist. That host-level manifest records global agent limits and the list of projects Symphony may serve; each project entry points at its own WORKFLOW.md and working directory. See elixir/README.md for the full schema.

Symphony turns project work into isolated, autonomous implementation runs, allowing teams to manage work instead of supervising coding agents.

In this demo video, Symphony monitors a Linear board for work and spawns agents to handle the tasks. The agents complete the tasks and provide proof of work: CI status, PR review feedback, complexity analysis, and walkthrough videos. When accepted, the agents land the PR safely. Engineers do not need to supervise Codex; they can manage the work at a higher level.

Warning

Symphony is a low-key engineering preview for testing in trusted environments.

Running Symphony

Requirements

Symphony works best in codebases that have adopted harness engineering. Symphony is the next step -- moving from managing coding agents to managing work that needs to get done.

Option 1. Make your own

Tell your favorite coding agent to build Symphony in a programming language of your choice:

Implement Symphony according to the following spec: https://github.com/openai/symphony/blob/main/SPEC.md

Option 2. Use our experimental reference implementation

Check out elixir/README.md for instructions on how to set up your environment and run the Elixir-based Symphony implementation, including the GitHub Projects v2 operator setup. You can also ask your favorite coding agent to help with the setup:

Set up Symphony for my repository based on https://github.com/openai/symphony/blob/main/elixir/README.md

Operating

For common startup, workspace, review-loop, CI, Hex, and sandbox failures, see the Symphony troubleshooting guide.

GitHub Projects deployments can optionally auto-promote validated PRs from Human Review to Merging when CI is green and Codex has no latest-commit P1 findings. See elixir/README.md for the opt-in config and rollout controls.

The Elixir implementation can optionally keep repository-local lessons from failed runs in .symphony/lessons.md. When enabled in WORKFLOW.md, Symphony recalls recent entries into future agent prompts, but it never auto-commits the file.

---

License

This project is licensed under the Apache License 2.0.