subagent-tmux

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.