Symphony
Bring your project board, coding agents, and delivery work into one desktop workspace.
Isolated Git worktrees. Resumable agent runs. Pull requests and checks in context. Local execution state.
Install · Workflow · Capabilities · Build from source · Documentation · Design system · Contributing
Public release preparation. Source and release configuration target
pixel-brewery/symphony. Publication still
requires the owner handover, public visibility, usable Actions capacity, and a working
update feed. The handover guide
records the activation requirements. Prepared configuration alone does not make an
installer or update available.
From board to reviewed change
A local-first Electron application for coordinating provider-neutral software-delivery
workflows. Symphony projects a GitHub Projects board into a desktop workspace, prepares
isolated Git worktrees, runs coding agents against them under explicit control, and tracks
the resulting pull requests and checks on your machine.
| Step | Work in Symphony |
|---|
| Connect the project | Select the GitHub Project and review detected repository, ticket-source, and CLI-account connections before applying the setup. |
| Prepare the workspace | Choose a work item and explicitly prepare its managed Git worktree. Keep implementation work isolated from your ordinary checkout. |
| Analyze and implement | Start an Analyzer or Solver run under the configured execution policy. Pause and resume durable runs as work progresses. |
| Review the result | Follow pull requests, local verification, GitHub Actions runs, and checks beside the work item. Keep delivery and environment-review decisions explicit. |
The GitHub CLI and the agent CLIs own their authentication. Symphony stores settings,
machine paths and execution state under ~/.symphony/. Azure DevOps credentials supplied
through its connection flow are stored separately as operating-system-encrypted vault
blobs; settings retain non-secret references.
Install
Download the latest build for your platform from
Releases:
| Platform | Asset |
|---|
| macOS (Apple Silicon) | Symphony-darwin-arm64-<version>.dmg |
| Windows (ARM64) | SymphonySetup.exe |
| Linux (ARM64) | symphony_<version>_arm64.deb |
GitHub adds the source ZIP and source tar.gz links automatically. Symphony publishes no other
ZIP, x64, or NuGet release assets. macOS uses a complete ad-hoc bundle seal and is not notarized;
Windows and Debian installers are unsigned. Review the public source
and published SHA-256 values. Download and run at your own discretion. The MIT license
supplies the software as-is, without warranty.
Windows may show a SmartScreen warning.
macOS: install and open for the first time
The disk image includes Read me first - Open Symphony.txt above the Symphony and Applications
icons, with instructions in English and German. An Apple Developer account or paid certificate
is not required to install Symphony. If macOS asks for approval:
- Drag Symphony.app onto Applications and wait for the copy to finish.
- Open Applications in Finder and double-click Symphony there.
- If macOS blocks it because the developer cannot be verified, choose Done.
- Open System Settings → Privacy & Security, scroll to Security, and choose
Open Anyway for Symphony.
- Confirm with Open and authenticate if requested. This copy can then open normally.
The app-specific approval appears only after a blocked launch and is available for a limited
time. If it is missing, attempt step 2 again before returning to Settings. A managed Mac may
restrict this option. The guide changes no security settings; follow the
Apple instructions for the selected application only.
Installer-only ARM64 releases are downloaded and verified inside Symphony: the status bar's update
button downloads the installer, checks its size and SHA-256 digest, and Restart to update opens
it. The ZIP and NuGet payloads required by
Electron's native automatic updaters are intentionally disabled and remain commented in the
release configuration for a later support expansion.
What you need alongside it
- The GitHub CLI, authenticated, for the GitHub Projects board,
pull requests, and checks
- At least one agent CLI — Claude Code, Codex, or OpenCode — for execution features
- Git
This is the beginning of the README. Read the rest at the original. Read the full README ↗
