tmux-subagent

What problem does it solve?

Coordinate and run multiple independent Claude instances in parallel while keeping each agent isolated with its own configuration, tool permissions, and plugin environment to avoid interference, accidental modifications, or permission escalation.

Core Features & Use Cases

• Parallel, isolated agents: Launch multiple tmux-backed Claude sub-agents to work on different aspects of a project simultaneously without sharing state.
• Permission and plugin isolation: Apply allow/deny tool rules per session and install session-scoped plugins to safely test or restrict capabilities.
• Monitoring and lifecycle controls: Create temporary per-session workspaces, monitor output via tmux or iTerm integration, send messages or interrupts, and clean up sessions when finished.
• Use Case: Run a read-only security review agent against src/ while a separate refactor agent makes changes in a sandboxed workspace.

Quick Start

Launch a tmux sub-agent named refactor-task to refactor the authentication module in src/auth and report the proposed changes.