What problem does it solve?
It solves the problem of slow, blocked, or context-contaminated work by letting you delegate multiple tasks to isolated sub-agents running concurrently in separate tmux sessions.
Core Features & Use Cases
- Isolated parallel execution: Run multiple investigations at once without mixing context between tasks.
- File-based result capture: Redirect each sub-agent’s output to a dedicated /tmp file so you can reliably read results afterward.
- Optional structured and interactive modes: Support JSON output for structured events and a FIFO-based approach for two-way communication.
Use case example: Run three independent repository scans (models, controllers, tests) in parallel, then combine their outputs into a single summarized report.
Quick Start
Start a tmux session for your task and run pi in that session while redirecting output to a dedicated file you can read when it completes.