
Claude Session Driver
https://github.com/obra/claude-session-driver- Category
- AI Agents
- Rank
- No. 1440Tools index
Previous survey · No. 1446 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- obra
- GitHub
- 107 stars
- Latest release
- v2.0.1
- Date
About
Launch, control, and monitor other Claude Code sessions as workers via tmux.
What it does
It turns a lead coding-agent session into a coordinator for parallel workers. The coordinator assigns tasks, follows structured lifecycle events, reads responses, continues conversations, and can pass a live worker to a human. One command surface works across Claude Code, Codex, and Pi.
Why it's ranked here
The tool offers a credible orchestration layer rather than a thin process launcher. Shared commands across three agent harnesses reduce workflow branching, while structured event logs make parallel work observable. The central concern is deliberate: workers bypass permission prompts, and monitoring records actions without preventing them.
What's good
It supports delegation, fan-out, pipelines, supervised conversations, and human handoff through the same command model. Prompt delivery waits for an explicit submission event and retries Enter when interactive input is slow. Worker status distinguishes active, terminated, missing, and not-yet-registered sessions. Process execution uses argument arrays instead of a shell, reducing quoting and injection hazards.
Tradeoffs
Every worker runs without interactive permission approval, so task scope and working directories need careful control. Event collection is observation-only and cannot block a dangerous tool call. The setup depends on tmux, Node, and at least one supported agent command. Existing-session adoption works only with Claude because Codex and Pi assign their own session identifiers.
How to use it well
Use it when one coding agent should coordinate several independent or staged engineering tasks, especially when you want machine-readable progress and occasional human takeover. Start with bounded assignments, inspect events, then combine worker results in the controller. It does not replace sandboxing, policy enforcement, or approval gates for untrusted work.
Technical notes+
The project is a private pnpm package in package.json, built with tsup and requiring Node 22.12 or newer. src/cli.ts dispatches top-level and per-worker commands through one TypeScript CLI. src/events.ts defines six JSONL lifecycle event variants. src/core/proc.ts uses execFile with argument arrays and a 10 MiB buffer. src/commands/send.ts strips embedded bracketed-paste markers, waits for a prompt-submission event, and retries Enter until timeout. src/harness/codex.ts creates isolated worker homes, copies operator authentication when present, and generates hook configuration. src/harness/pi.ts stages Pi configuration and loads a bundled TypeScript extension.
Observed
- License
- MIT
- Primary language
- TypeScript
- Packaging
- Private pnpm package using ECMAScript modules and tsup
- Install surface
- Claude plugin distributed through the superpowers marketplace
- Interface
- Single command-line interface with top-level and per-worker commands
- Harness support
- Claude Code, Codex, and Pi
- Runtime requirements
- Node 22.12 or newer, tmux, and at least one supported harness command
Read from README.md, package.json, src/cli.ts, src/events.ts, src/core/proc.ts, src/core/time.ts, src/core/tmux.ts, src/core/paths.ts, src/core/shell.ts, src/harness/pi.ts, src/core/consent.ts, src/commands/list.ts, src/commands/send.ts, src/commands/stop.ts, src/harness/codex.ts.
What it can do
Launch Claude Code worker sessions
Session configuration parameters → Active Claude Code worker sessions
Control Claude Code worker sessions
Commands and instructions → Executed actions in worker sessions
Monitor Claude Code worker sessions
Running worker sessions → Session status and activity reports
Manage tmux sessions for Claude workers
tmux commands and session parameters → Created, modified, or terminated tmux sessions
Coordinate multiple Claude Code instances
Multiple worker session requests → Orchestrated parallel Claude Code operations
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.