pool

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.