Summary

OasAIStudio/symphony-ts offers an unofficial TypeScript implementation of OpenAI's Symphony, automating project workflows by converting tracker tickets into isolated, autonomous coding agent runs. It targets developers seeking to enhance AI-assisted engineering through dedicated per-issue workspaces, agent execution management, and runtime visibility, streamlining development and improving observability.

How It Works

The system ingests tasks from trackers (e.g., Linear), provisions distinct workspaces per issue, and executes coding agents within these isolated boundaries. A repository-defined WORKFLOW.md file governs agent tasks and policies. This approach isolates agent work, centralizes workflow logic within the repository, and enables concurrent agent operation with maintained observability and control over retries and cleanup.

Quick Start & Requirements

• Installation: Global install via npm install -g symphony-ts or run directly using npx symphony-ts.
• Prerequisites: Node.js >= 22, a repository with WORKFLOW.md, necessary credentials (e.g., LINEAR_API_KEY), and an app-server compatible coding agent runtime (e.g., codex app-server).
• Quickstart: Navigate to your repo, create/configure WORKFLOW.md, set environment variables (e.g., LINEAR_API_KEY), and run symphony ./WORKFLOW.md --acknowledge-high-trust-preview --port 4321.
• Documentation: Refer to docs/WORKFLOW.template.md for workflow details and docs/DEV_GUIDE.md for development guidance.

Highlighted Details

• Automates tracker tickets into autonomous implementation runs.
• Isolates agent work per issue, avoiding shared mutable directories.
• Maintains workflow policy within the repository.
• Supports concurrent agent operation with clear observability.
• Provides a local dashboard and JSON API for runtime visibility.
• Manages agent execution state, including retries and cleanup.

Maintenance & Community

The roadmap includes planned support for GitHub Projects and local GUI boards, plus expanded coding agent compatibility. Contributing guidelines are in SPEC.upstream.md and AGENTS.md. Users are encouraged to open issues for feature requests.

Licensing & Compatibility

Licensed under Apache-2.0, with attribution for the upstream OpenAI Symphony project. No explicit commercial use restrictions are detailed, but the project carries a warning for trusted environments only.

Limitations & Caveats

Symphony-ts is intended for trusted environments. It requires manual WORKFLOW.md creation and specific agent configuration, including explicit network access policies. Planned features like GitHub Projects integration and a local GUI are still in development.