Skip to content

kalepail/symphony

 
 

Repository files navigation

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 the Rust reference implementation for this fork

Check out rust-todoist/README.md for instructions on how to set up your environment and run the Rust Todoist implementation. The Elixir runtime remains in this fork as a legacy reference, but Rust is the primary implementation path here. 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/rust-todoist/README.md

For Rust Todoist planning and implementation docs, see:

Script Layout

Logs

Runtime file logs are written relative to the process current working directory unless --logs-root is provided.

  • Launch from repo root: log/symphony.log
  • Launch from rust-todoist/: rust-todoist/log/symphony.log
  • Launch from elixir/: elixir/log/symphony.log
  • Override with --logs-root /path: /path/log/symphony.log

Rotation is size-based in both runtimes, not daily:

  • Rust keeps the current file plus symphony.log.1 through symphony.log.5, rotating before a write would exceed 10 MB.
  • Elixir uses OTP's wrapped disk log with 5 files at 10 MB each, plus .idx and .siz metadata files in the same directory.

License

This project is licensed under the Apache License 2.0.

About

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

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Rust 60.0%
  • Elixir 34.3%
  • Python 5.0%
  • CSS 0.4%
  • Shell 0.2%
  • Makefile 0.1%