Vibeleaderboard
Index / tool
Visit github.com
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 parametersActive Claude Code worker sessions

  • Control Claude Code worker sessions

    Commands and instructionsExecuted actions in worker sessions

  • Monitor Claude Code worker sessions

    Running worker sessionsSession status and activity reports

  • Manage tmux sessions for Claude workers

    tmux commands and session parametersCreated, modified, or terminated tmux sessions

  • Coordinate multiple Claude Code instances

    Multiple worker session requestsOrchestrated parallel Claude Code operations

Tags

claude-codetmuxorchestrationagentscli

Tech Stack

Node.jsTypeScript

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.