symphony README

The project's README from github.com/openai/symphony. As one markdown file: README.md.

Symphony

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

Symphony demo video preview

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. 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


License

This project is licensed under the Apache License 2.0.

symphony (openai/symphony)

Searching Database…

27.7K ·GitHub
What is this?Symphony is an experimental system from OpenAI that turns project tasks into isolated, autonomous implementation runs, so teams manage the work itself instead of babysitting individual coding agents.
How do I get it running?Follow the instructions in elixir/README.md to set up your environment and run the Elixir reference implementation, or ask your coding agent to set up Symphony for your repository based on the spec.
Does my codebase need anything special before trying this?Symphony is designed to work best in codebases that have already adopted harness engineering, which gives agents a reliable way to run isolated tasks.
Is this ready for production use?No, the README explicitly calls it a low-key engineering preview meant only for testing in trusted environments, not a finished product.
How does Symphony know what work to pick up?In the demo, it monitors a Linear board for tasks and spawns agents to handle them automatically, without an engineer assigning each one manually.
What proof does an agent give before its work is accepted?Agents report proof of work such as CI status, PR review feedback, complexity analysis, and a walkthrough video before a human accepts and lands the pull request.
Why use Symphony instead of running Codex directly?It shifts engineers from supervising individual coding-agent sessions to managing work at a higher level, letting agents land PRs safely once their work is accepted.
What are similar projects?hive, munder-difflin, ruflo, Comma, open-swe, fractal, Choir, foreman
Creator
openai
Size
29.9 MB
Stars
27.7K
Age
7mo
Commits · 90 Days