CLAW-ORCHESTRATOR(1)

NAME

claw-orchestratorRun Claude Code, Codex, Gemini, Cursor Agent and custom coding CLIs as one unified runtime for claw-style agent…

SYNOPSIS

$npm install -g @enderfga/claw-orchestrator

INFO

454 stars
76 forks
0 views
TypeScriptDeveloper Tools

DESCRIPTION

Run Claude Code, Codex, Gemini, Cursor Agent and custom coding CLIs as one unified runtime for claw-style agent systems. Runs standalone, with first-class OpenClaw plugin support.

README

Claw Orchestrator

Claw Orchestrator

A runtime for coding agents. Wrap Claude Code, Codex, Gemini, Cursor Agent, OpenCode, or any custom CLI as persistent programmable sessions; coordinate them in multi-agent councils; run autonomous Planner / Coder / Reviewer loops; or hand a five-question interview to an Opus council that ships a deployed web app at localhost:19000/forge/<slug>/.

npm version CI License: MIT

Coding CLIs are designed for humans at terminals. Claw Orchestrator turns them into headless engines and stacks an agent platform on top: a 55-tool API that scales from a single session call up to a fully generated, deployed web app — reachable through the CLI, the OpenClaw gateway, the Model Context Protocol, or directly from TypeScript, and visible through an embedded three-tab dashboard.


Features

CapabilityWhat it doesReference
Persistent SessionsLong-lived coding agents kept alive across requests, with full context, tool, model, and worktree control.sessions.md
Multi-Engine RuntimeOne interface over Claude Code, Codex, Gemini, Cursor Agent, OpenCode, and arbitrary custom CLIs.multi-engine.md
Multi-Agent CouncilParallel agents in isolated git worktrees, voting on consensus until they agree.council.md
AutoloopThree-agent autonomous workspace iteration. Chat with the Planner; it spawns Coder + Reviewer into a self-iterating subloop and pushes you on regression, target-hit, or decision points.autoloop.md
UltraappA three-agent Opus council turns a five-question interview into a deployed web app — Tailwind UI, BYOK, file-queue runtime, smoke test, all live at localhost:19000/forge/<slug>/.ultraapp.md
Embedded DashboardThree-tab UI for Autoloop, Council, and Forge with sidebar lifecycle controls, per-run live event streaming, and cookie-based auth via a /login redirect.dashboard.md
OpenAI-Compatible ProxyPOST /v1/chat/completions translates OpenAI requests into native Anthropic, OpenAI, and Google calls and streams responses back in OpenAI shape. Point any OpenAI-SDK client at the orchestrator without changing call sites.openai-compat.md

The full 55-tool surface is enumerated in tools.md.


Quick Start

npm install -g @enderfga/claw-orchestrator
clawo serve   # dashboard at http://127.0.0.1:18796/dash
import { SessionManager } from '@enderfga/claw-orchestrator';

const manager = new SessionManager(); await manager.startSession({ name: 'fix-tests', engine: 'claude', cwd: '/project' }); const result = await manager.sendMessage('fix-tests', 'Fix the failing tests');


Integrations

Standalone CLI

clawo serve                                            # dashboard + HTTP server on :18796
clawo session-start fix-tests --engine claude --cwd .  # start a session
clawo session-send fix-tests "Fix the failing tests"   # send into it

Every command is documented in cli.md.

OpenClaw Plugin

curl -fsSL https://raw.githubusercontent.com/Enderfga/claw-orchestrator/main/install.sh | bash

Installs via npm, registers the plugin in ~/.openclaw/openclaw.json, restarts the gateway. All 55 tools become available to every OpenClaw agent.

Model Context Protocol Server

npm install -g @enderfga/claw-orchestrator   # clawo-mcp is now on PATH

Register clawo-mcp with any MCP-compatible host: Hermes Agent, Claude Desktop, Cursor, Cline, Continue, Zed, Windsurf, Goose, and others. Per-host stdio-config snippets and the CLAWO_MCP_TOOLS allowlist for tight tool budgets are in mcp.md.


Engine Compatibility

EngineCLITested Version
Claude Codeclaude2.1.140
Codexcodex0.128.0
Geminigemini0.36.0
Cursor Agentagent2026.03.30
OpenCodeopencode1.1.40
Custom CLIany

Any coding CLI that runs as a subprocess can be wired up as a custom engine — see multi-engine.md.


Contributing

See CONTRIBUTING.md. Run npm run build && npm run lint && npm run format:check && npm run test before submitting.

License

MIT — see LICENSE.

SEE ALSO

clihub5/15/2026CLAW-ORCHESTRATOR(1)