SoAZCloud
Open Source

Clawd Coordinator

Orchestrate remote Claude Code sessions across machines via WebSocket. Dispatch prompts, stream results, fan out work — all from your terminal or via MCP.

GitHub npm Documentation ↓
Features

Everything you need to coordinate remote AI agents

Orchestration
⇄
Task Dispatch & Streaming
Send prompts to remote agents and stream output back in real time over WebSocket.
≣
Fan-Out
Dispatch the same prompt to multiple agents in parallel. Collect results as they complete.
☰
Task Queuing
Per-agent concurrency limits with FIFO queuing, auto-retry, and dead-letter handling.
⑂
Workspace Isolation
Isolate task execution with git worktrees or tmpdir strategies. Configurable per-task.
Persistence & State
💾
SQLite Storage
Pure JS/WASM via sql.js — no native dependencies to compile. Works everywhere Node runs.
↻
Task Recovery
Incomplete tasks automatically retry on coordinator restart. No work lost.
📋
Audit Trails
Every task lifecycle event persisted. Query completed, errored, and dead-lettered tasks.
⏰
Scheduled Tasks
Cron-based scheduling for recurring prompts. Built on the croner library.
Security & Access
🛡
RBAC
Admin, operator, and viewer roles with granular permission enforcement.
🏢
Multi-Tenant Orgs
Complete isolation between organizations. Agents, tasks, and users scoped per-org.
🔑
Per-Agent Tokens
Generate API keys scoped to individual agents for tighter access control.
⚠
Rate Limiting
Token-bucket rate limiting: 100 connections/min per IP, 1000 messages/10s per socket.
Integration
>_
25+ CLI Commands
Full-featured CLI for dispatch, monitoring, user management, file transfer, and more.
↔
REST API
Complete HTTP API for programmatic integration with any language or platform.
⚙
MCP Server
Model Context Protocol integration — use Clawd Coordinator as a tool inside Claude Code.
📊
Prometheus Metrics
OpenMetrics endpoint with task counters, duration histograms, queue depth, and agent gauges.
📦
File Transfer
Push and pull files between local and remote agents over WebSocket. Tar-based with checksums.
CLI

Get running in four commands

Quick Start
# Initialize config and auth token
coord init

# Start the coordinator server
coord serve

# Connect a remote agent
coord agent --url wss://your-host:8080 --name worker-1

# Dispatch a task and stream the output
coord run "Refactor the auth module" --on worker-1
Fan-Out
# Send the same prompt to multiple agents in parallel
coord fan-out "Add unit tests to all handlers" --on agent-a,agent-b,agent-c
Task Management
# List all tasks
coord tasks

# Attach to a running task and stream output
coord attach <task-id>

# Get the result of a completed task
coord result <task-id>

Full CLI reference with all 25+ commands available on GitHub.

Integration

REST API & MCP Server

REST API

Full HTTP API for programmatic integration. All endpoints require Bearer token or API key authentication.

  • POST /api/dispatch — Dispatch a task
  • GET /api/tasks — List tasks
  • GET /api/agents — List connected agents
  • POST /api/users — User management
  • POST /api/orgs — Org management
  • GET /metrics — Prometheus metrics

Full API docs →

MCP Server

Use Clawd Coordinator as a tool inside Claude Code via the Model Context Protocol.

coord mcp

Exposes 4 tools for task dispatch, agent listing, task querying, and status reporting. Integrates with Claude Code's native MCP tool system.

Get Started

GitHub npm Book a Call