Turn one Claude Code session into a project manager that delegates tasks to other Claude Code sessions.
A single Claude session works on one task at a time. With this plugin, a controller session launches worker sessions in tmux, assigns each a task, monitors their progress, reviews their tool calls, and collects results. Workers run in parallel. The controller decides what to do with their output.
Each worker session loads hooks that write lifecycle events to a JSONL file: session start, prompt submitted, tool use, stop, and session end. A PreToolUse hook pauses before every tool call, giving the controller a window to approve or deny it. If the controller does not respond within the timeout, the tool call proceeds.
The controller orchestrates workers through shell scripts that manage tmux sessions, poll events, read conversation logs, and clean up.
claude plugin install claude-session-driver@superpowers-marketplaceIf your marketplace cache predates this plugin, update it first:
claude plugin marketplace update superpowers-marketplaceRequires tmux, jq, and the claude CLI.
Install the plugin and ask Claude to manage a project. The driving-claude-code-sessions skill provides orchestration patterns:
- Delegate and wait: Launch a worker, assign a task, read the result.
- Fan out: Launch several workers on independent tasks, wait for all to finish.
- Pipeline: Chain workers so each builds on the previous worker's output.
- Supervise: Hold a multi-turn conversation with a worker, reviewing each response.
- Hand off: Pass a running worker session to a human operator in tmux.
| Script | Purpose |
|---|---|
launch-worker.sh |
Start a worker session in tmux |
converse.sh |
Send a prompt, wait, return the response |
send-prompt.sh |
Send a prompt without waiting |
wait-for-event.sh |
Block until a lifecycle event appears |
read-events.sh |
Read and filter the event stream |
read-turn.sh |
Format the last turn as markdown |
stop-worker.sh |
Stop a worker and clean up |
approve-tool.sh |
Approve or deny a pending tool call |
MIT