Alpha Experimental — actively developed, expect breaking changes

Git-Native AI Orchestration

Turn repository events into orchestrated agent work, from issues, PRs, webhooks, or schedules.

Works with GitHub, GitLab, Linear · Supports Claude, Codex, Copilot, OpenAI, OpenRouter, Kimi, Pi, and more

Polyphony TUI Dashboard

The problem with AI agents today

Managing AI coding agents manually does not scale. Polyphony automates the entire lifecycle.

Without Polyphony

  • Manually copy-paste issues into agent prompts, one at a time
  • Agents work in the same branch, causing merge conflicts
  • No visibility into agent progress until they finish (or fail silently)
  • Failed runs require manual intervention and restart
  • No budget controls — runaway token usage burns through credits
  • Locked into a single agent provider with no fallback

With Polyphony

  • Issues automatically pulled from your tracker and dispatched to agents
  • Each agent works in an isolated git worktree — zero conflicts
  • Live TUI dashboard shows real-time progress, retries, and results
  • Automatic retry with configurable fallback chains across agents
  • Token budgets, concurrency limits, and cost-aware throttling built in
  • Multi-agent support — Claude, Codex, Copilot, Pi, or any ACP-compatible agent

How it works

Four steps from issue to shipped code.

01

Configure

Point to your tracker (GitHub, GitLab, Linear) and choose which agents to dispatch. Configuration lives in your repo as YAML — version-controlled and reviewable.

tracker: github
agents:
- claude
- codex
workspace: worktree
Configuration step
Orchestration step
02

Orchestrate

Polyphony polls for issues, creates isolated git worktrees, and dispatches the right agent to each task. Concurrency, priority, and routing are all configurable.

⠀⠋ Polling tracker...
✓ Found 3 new issues
→ Creating worktree for #42
→ Dispatching claude to #42
03

Monitor

The live TUI dashboard shows agent progress, retries, and results in real time. Sortable tables, detail modals, and live spinners keep you informed without context-switching.

+- Runs ----------------------------------+
| ~ #42 Fix auth refresh  claude  running |
| * #43 Add rate limits   codex   done    |
| . #44 Update docs       pi      queued  |
+------------------------ 1 of 3 ---------+
Monitoring step
Shipping step
04

Ship

Agents commit, push, and open pull requests automatically. The feedback loop is closed — review and merge, then move on to the next batch.

✓ Agent committed 3 files
✓ Pushed to fix/auth-refresh
→ PR #87 opened: "Fix auth token refresh"
Waiting for review...

Get started in seconds

One command to install. One file to configure. You are running agents in under five minutes.

$ brew install penso/polyphony/polyphony

Universal binary (Apple Silicon + Intel)

Why Polyphony

Three pillars that make agent orchestration practical.

🎯

Issue → Agent → PR

Connect your tracker, dispatch agents, get pull requests automatically. The full lifecycle from issue to shipped code is hands-free. No copy-pasting, no manual prompting, no babysitting.

🤖

Multi-Agent

Claude, Codex, Copilot, Pi — use whichever agent fits the task. Define fallback chains so if one agent fails, another takes over automatically. Mix providers freely.

📦

Repo-Native

Inspired by OpenAI Symphony, workflow policy lives in WORKFLOW.md — version-controlled with your code. No external config servers, no SaaS dependency.

Built for real workflows

Everything you need to run AI agents in production.

Isolated Workspaces

Each agent gets its own git worktree. No conflicts, no interference, clean diffs. Workspaces are created and cleaned up automatically.

Retry & Fallback

Automatic retry with configurable agent fallback chains. If Claude fails after 3 attempts, try Codex. Exhausted chains surface clearly in the dashboard.

Budget Control

Token and cost-aware throttling. Set concurrency limits, per-issue token budgets, and global spend caps to keep costs predictable.

Workflow Policy

YAML + Liquid templates in WORKFLOW.md. Define routing rules, priority ordering, label-based agent selection, and custom pipeline steps.

Live Observability

Real-time TUI with live snapshots and non-blocking updates. Sortable tables, detail modals, braille spinners — never miss an agent's progress.

Handoff Automation

Auto-commit, push, PR creation, and feedback loops. Agents ship code end-to-end, not just write it. The handoff is fully automated.

Multi-Tracker Support

GitHub, GitLab, Linear, and Beads. Pull issues from whichever tracker your team uses. Switching trackers requires changing one line of config.

Agent Profiles

Configure per-agent settings: transport type, model preferences, token limits, and custom system prompts. Each agent profile is reusable across workflows.

Concurrent Execution

Run multiple agents in parallel across different issues. Configurable concurrency limits ensure you stay within resource and API rate constraints.

A dashboard built for the terminal

Full TUI with sortable tables, detail modals, live spinners, and workspace status.

polyphony — tui
ID Title Agent Status Updated
#42 Fix auth token refresh claude 2m ago
#43 Add rate limiting middleware codex 15m ago
#44 Update API documentation pi 1h ago
#45 Refactor database connection pool claude 3h ago
#46 Add WebSocket support codex 5h ago
1 of 5 · sorted by updated 1 running

See it in action

Real views from the Polyphony terminal dashboard.

Issue tracking view

Issue Tracking View

Browse and filter issues pulled from your tracker. See agent assignments and status at a glance.

Run pipeline

Run Pipeline

Track each run through its pipeline steps, from dispatch to commit to PR creation.

Agent status

Agent Status

Monitor each agent's health, token usage, success rates, and current task in real time.

Works with your stack

Connect any tracker and dispatch to any agent.

Issue Trackers

GitHub GitHub
GitLab GitLab
Linear Linear
Beads Beads

AI Agents

Claude Claude
Codex Codex
Copilot Copilot
Pi Pi
OpenAI OpenAI-compatible
ACP ACP

Built in the open

Polyphony is open source under the MIT license. No vendor lock-in, no telemetry, no hidden costs. Read every line of code, open issues, send PRs.

MIT License Written in Rust Contributors welcome

Check the good first issues to get started. Join the discussions to shape the roadmap.