Focus.AI Labs / Artifact Field Notes Tools & Utilities
Fast browse / jump off / source-grounded
Tools & Utilities

PiSwarm

PiSwarm is a Shell-based orchestration toolkit for parallel GitHub issue and PR processing using the pi agent and Git worktrees.

Origin
seed-list
Extensibility
standalone
Primary interface
cli

What this artifact is for

The quick orientation layer before you go deeper upstream.

Profile

Summary

PiSwarm is a Shell-based orchestration toolkit for parallel GitHub issue and PR processing using the pi agent and Git worktrees.

Seed description: Parallel GitHub issue and PR processing using the pi agent and Git worktrees

Category: Tools & Utilities

Best for: Parallel GitHub issue and PR execution via isolated worktrees

Signals

How to read this page

Workflow tags: orchestration

Integrations: github

Caveats: No caveats captured yet

Maturity: stars: 7, forks: 1

README excerpt

More of the actual upstream surface so you can skim here before deciding to open the repo.

Upstream skim

Parallel GitHub issue and PR processing using the pi agent and Git worktrees.

Commander (Project/Milestone orchestrator) │ ├─► Captain (Epic orchestrator) │ ├─► swarm.sh (Issue wave 1) │ ├─► pr-swarm.sh (Review PRs) │ ├─► swarm.sh (Issue wave 2) │ └─► ... │ └─► Captain (Another Epic) └─► ...

git clone https://github.com/lsj5031/pi-swarm.git

Preview source: captured upstream text ↗

What shows up in the source

Quick topics

Pi Swarm 🐝FeaturesCommand HierarchyInstallationQuick StartWork on IssuesReview PRsExecute an Epic

Skim bullets

  • Issue Swarm: Process multiple GitHub issues in parallel
  • PR Swarm: Review and fix multiple Pull Requests in parallel
  • Captain: Orchestrate epics with dependency-aware wave execution
  • Commander: Orchestrate multiple epics or generate entire projects from a description
  • Isolated Worktrees: Each agent works in its own git worktree
  • Headless Execution: Uses pi --mode json for structured monitoring
  • State Persistence: Resume interrupted operations with --resume
  • Auto-retry: Failed tasks retry automatically with exponential backoff

Sources and provenance

Everything on this page should be traceable back to the list seed or an upstream surface.

Provenance

Discovery reason: Listed in the awesome-pi-agent README

Discovered from: seed artifact

Claim confidence: high

Surface capture kind: repo-readme