https://github.com/enderfga/claw-orchestrator
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.
https://github.com/enderfga/claw-orchestrator
agent-orchestration agent-teams ai-agent claude-code claw claw-orchestrator cli codex coding-agent cursor-agent developer-tools gemini mcp multi-agent multi-engine openclaw persistent-sessions session-management tool-orchestration typescript
Last synced: 5 days ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/enderfga/claw-orchestrator
- Owner: Enderfga
- License: mit
- Created: 2026-01-30T16:00:53.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-05-11T10:10:31.000Z (19 days ago)
- Last Synced: 2026-05-11T10:31:02.833Z (18 days ago)
- Topics: agent-orchestration, agent-teams, ai-agent, claude-code, claw, claw-orchestrator, cli, codex, coding-agent, cursor-agent, developer-tools, gemini, mcp, multi-agent, multi-engine, openclaw, persistent-sessions, session-management, tool-orchestration, typescript
- Language: TypeScript
- Homepage: https://github.com/Enderfga/claw-orchestrator#readme
- Size: 3.2 MB
- Stars: 445
- Watchers: 4
- Forks: 75
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 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//`.
[](https://www.npmjs.com/package/@enderfga/claw-orchestrator)
[](https://github.com/Enderfga/claw-orchestrator/actions/workflows/ci.yml)
[](https://opensource.org/licenses/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
| 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`](./skills/references/sessions.md) |
| **Multi-Engine Runtime** | One interface over Claude Code, Codex, Gemini, Cursor Agent, OpenCode, and arbitrary custom CLIs. | [`multi-engine.md`](./skills/references/multi-engine.md) |
| **Multi-Agent Council** | Parallel agents in isolated git worktrees, voting on consensus until they agree. | [`council.md`](./skills/references/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`](./skills/references/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//`. | [`ultraapp.md`](./skills/references/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`](./skills/references/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`](./skills/references/openai-compat.md) |
The full 55-tool surface is enumerated in [`tools.md`](./skills/references/tools.md).
---
## Quick Start
```bash
npm install -g @enderfga/claw-orchestrator
clawo serve # dashboard at http://127.0.0.1:18796/dash
```
```ts
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
```bash
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`](./skills/references/cli.md).
### OpenClaw Plugin
```bash
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
```bash
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`](./skills/references/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`](./skills/references/multi-engine.md#custom-engine-enginecustom).
---
## Contributing
See [`CONTRIBUTING.md`](./CONTRIBUTING.md). Run `npm run build && npm run lint && npm run format:check && npm run test` before submitting.
## License
MIT — see [`LICENSE`](./LICENSE).