Skip to content

Enderfga/claw-orchestrator

Repository files navigation

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.

claw-promo.mp4

Control · Council · Autoloop · Ultraapp — the four movements in 35s


Features

Capability What it does Reference
Persistent Sessions Long-lived coding agents kept alive across requests, with full context, tool, model, and worktree control. sessions.md
Multi-Engine Runtime One interface over Claude Code, Codex, Gemini, Cursor Agent, OpenCode, and arbitrary custom CLIs. multi-engine.md
Multi-Agent Council Parallel agents in isolated git worktrees, voting on consensus until they agree. council.md
Autoloop Three-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
Ultraapp A 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 Dashboard Three-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 Proxy POST /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

Engine CLI Tested Version
Claude Code claude 2.1.150
Codex codex 0.133.0
Gemini gemini 0.43.0
Cursor Agent agent 2026.03.30
OpenCode opencode 1.1.40
Custom CLI any

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.