What problem does it solve?
The pool eliminates slow, failure-prone “one worktree per issue” setups by providing a fixed set of reusable git worktrees that are prepared, leased, and reset reliably for parallel issue work.
Core Features & Use Cases
- Persistent worktree pool: Creates and maintains detached worktrees under .worktrees/instance-N, each with its own node_modules for consistent parallel execution.
- Fast leasing for batch runs: Leases an instance to a specific branch, hard-resets to a base ref, cleans untracked files, and runs pnpm install only when package dependencies changed.
- Recovery and lifecycle management: Supports status inspection, resetting back to origin/release, repairing corrupted/wedged instances, and fully destroying the pool.
Quick Start
Ask your agent to initialize the pool by running: .pi/skills/pool/scripts/pool.sh init 4.