Symphony Ruby

A Ruby implementation of the Symphony spec — a daemon that polls Linear for issues, creates isolated workspaces, and runs coding agents against them.

Setup

bundle install

Usage

# Run with default WORKFLOW.md in current directory
bin/symphony

# Run with explicit workflow file
bin/symphony path/to/WORKFLOW.md

# Run with HTTP dashboard
bin/symphony --port 4567 WORKFLOW.md

Configuration

See WORKFLOW.md.example for a complete example. Configuration is specified as YAML front matter in a Markdown workflow file.

Testing

bundle exec rspec

Architecture

• Orchestrator: Poll loop, dispatch, retry queue, reconciliation
• Tracker::Linear: Linear GraphQL client
• AgentRunner::Claude: Claude Code app-server integration (default)
• AgentRunner::Codex: OpenAI Codex app-server
• WorkspaceManager: Per-issue isolated workspaces
• HTTP::Server: Optional Sinatra dashboard