pi-symphony

Unattended issue orchestration for Pi — polls Linear, spawns workers, manages PRs

Package details

← Back

skill

Install pi-symphony from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:pi-symphony

Package: pi-symphony
Version: 0.3.1
Published: Mar 22, 2026
Downloads: 54/mo · 25/wk
Author: tmustier
License: MIT
Types: skill
Size: 1.6 MB
Dependencies: 0 dependencies · 0 peers

Pi manifest JSON

{
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-symphony

Symphony-style unattended issue orchestration for Pi using Linear.

Status

Agent: Functional — the core orchestration loop, PR automation, and merge execution are implemented. Not yet running in production. Translation: This will let you give in to vibeslop agentically engineer at a new level of abstraction.

What it does

Polls a Linear board for eligible issues
Creates an isolated workspace per issue
Launches a Pi coding worker in RPC mode
Lets the worker implement autonomously within repo-defined policy
Manages the full PR lifecycle: create/reuse PRs, self-review, merge execution
Captures proof-of-work artifacts and surfaces status through a dashboard and JSON API
Writes local-first symphony_run analytics extracts for worker attempts under the run logs root
Retries, reconciles, and recovers safely

Architecture

Orchestrator (Elixir/OTP) — long-running daemon adapted from OpenAI Symphony
Worker extensions (TypeScript) — workspace-guard, proof, linear-graphql
Workflow contract — repo-owned WORKFLOW.md with policy-driven prompt templates

Development quick start

make setup
make check

See docs/DEV.md for the full developer workflow.

Repo shape

pi-symphony/
  orchestrator/elixir/  # Elixir/OTP orchestrator (adapted from OpenAI Symphony)
  extensions/           # Pi worker extensions
  examples/             # fixtures and sample workflows
  docs/                 # architecture, developer docs, contracts
  docs/archive/         # historical migration notes

Docs

docs/PLAN.md — implementation plan and architecture
docs/DEV.md — local development workflow and quality bar
docs/PI_RPC_CONTRACT.md — Pi worker runtime contract
docs/ORCHESTRATED_PR_FLOW.md — PR automation design
docs/PR_AUTOMATION_SCHEMA_PROPOSAL.md — config and runtime contract for PR automation
docs/WORKFLOW_PR_AUTOMATION_DRAFT.md — booking-demo workflow draft
THIRD_PARTY_NOTICES.md — vendored code attribution

License

MIT for original project code. Vendored third-party code retains its upstream license; see THIRD_PARTY_NOTICES.md.