px logo

Orchestrate
Claude Code agents

A coordinator dispatches work to parallel workers, each in its own tmux session. A release agent merges branches. A daemon monitors everything.

Get startedView on GitHub
terminal
$ px start
$ tmux list-sessions
px: 1 windows (attached)
px-daemon: 1 windows
px-release: 1 windows
$ px tracker status
Tasks:
T-1 [in-progress] add login page → alice
T-2 [in-progress] auth API endpoints → bob
T-3 [assigned] session middleware → bob
R-1 [ready] merge auth-login-page → release
Workers:
coordinator [busy] px:0.0
alice [busy] px-alice:0.0
bob [busy] px-bob:0.0
release [idle] px-release:0.0
daemon [busy] px-daemon:0.0

Everything you need for multi-agent workflows

Built on tmux, SQLite, and Claude Code. No custom runtimes, no containers — just your terminal.

🎯

Task tracker

SQLite-backed task board with dependencies, assignments, and portfolios. Workers auto-pick up tasks when idle.

🔀

Parallel workers

Spawn as many workers as you need. Each runs in its own tmux session with full Claude Code capabilities.

🚀

Release agent

Dedicated agent handles merging, quality gates, and pushing. Workers never merge their own branches.

📦

Portfolios

Group related tasks onto a named integration branch. Collect multiple changes before merging to main.

📊

Status daemon

Live dashboard polls the database, shows worker status, and nudges idle workers back to life.

⚡

Single binary

Compiled with Bun for instant startup. Download, chmod, and go — no runtime dependencies.

Up and running in seconds

px requires tmux and Claude Code. Download the binary, put it on your PATH, and start orchestrating.

Linux (x64)

terminal
$ curl -fsSL -o px https://github.com/Phoenixmatrix/px/releases/latest/download/px-linux-x64
$ chmod +x px && mkdir -p ~/.local/bin && mv px ~/.local/bin/

Linux (arm64)

terminal
$ curl -fsSL -o px https://github.com/Phoenixmatrix/px/releases/latest/download/px-linux-arm64
$ chmod +x px && mkdir -p ~/.local/bin && mv px ~/.local/bin/

macOS (Apple Silicon)

terminal
$ curl -fsSL -o px https://github.com/Phoenixmatrix/px/releases/latest/download/px-darwin-arm64
$ chmod +x px && mkdir -p ~/.local/bin && mv px ~/.local/bin/

Start the coordinator

terminal
$ cd your-project/
$ px start

See the full documentation for development setup, commands reference, and workflow details.

How it works

1

You tell the coordinator what to build

Be explicit about task breakdown and parallelization. "Create three tasks: login UI, auth API, session middleware. Spawn two workers."

2

Workers execute in parallel

Each worker picks up tasks, writes code, runs quality gates, commits, and hands off to the release agent.

3

Release agent integrates

Merges worker branches into main or a portfolio branch, runs checks, and pushes. Workers never merge their own code.