claude-operator

TypeScript MCP-Server, der jede Claude Code-Sitzung in einen autonomen Operator verwandelt — zerlegt Ziele, startet und koordiniert Arbeitssitzungen über mehrere Projekte hinweg, verwaltet persistenten zweistufigen Speicher, erzwingt Sicherheitsvorkehrungen und lernt aus retrospektiven menschlichen Überprüfungen.

Installation

npm install -g claude-operator
claude-operator init
claude-operator start

init erstellt das Grundgerüst für ~/.claude-operator/ (SQLite-DB, Bus-Verzeichnis, Konfiguration). start startet den MCP-Server über stdio + Dashboard unter http://localhost:7373.

Related MCP server: claude-swarm

In Claude Code einbinden

Fügen Sie dies zu Ihrer ~/.claude/settings.json hinzu:

{
  "mcpServers": {
    "claude-operator": {
      "command": "claude-operator",
      "args": ["start", "--mcp"]
    }
  }
}

Oder verweisen Sie auf den lokalen Entwicklungs-Build:

{
  "mcpServers": {
    "claude-operator": {
      "command": "node",
      "args": ["/path/to/claude-operator/packages/server/dist/server.js"]
    }
  }
}

Architektur

Operator session (Claude Code)
        │  MCP tools (10)
        ▼
┌─────────────────────────────────┐
│  claude-operator MCP server     │
│  ┌──────────┐  ┌─────────────┐ │
│  │  SQLite  │  │  File bus   │ │
│  │  WAL+FTS5│  │  heartbeat  │ │
│  └──────────┘  └─────────────┘ │
│  ┌──────────────────────────┐  │
│  │  Monitor loop (30s poll) │  │
│  └──────────────────────────┘  │
└────────────┬────────────────────┘
             │  spawn / bus read-write
    ┌────────┴────────┐
    ▼                 ▼
Worker A          Worker B
(git worktree)    (git worktree)
operator/w-abc    operator/w-def

Zweistufiger Speicher — Stufe 1 (flüchtig, läuft automatisch nach 30 Tagen ab) und Stufe 2 (dauerhaft, vom Menschen bestätigt). Der Operator schlägt eine Klassifizierung vor; der Mensch bestätigt diese im Dashboard (pending_classification=TRUE).

Datei-Bus — primärer Zustands-Kanal zwischen Worker und Operator. Worker schreiben Heartbeats in <bus-dir>/<worker-id>.json; die Überwachungsschleife erkennt inaktive Worker (kein Heartbeat >2 Min.) und markiert sie als fehlgeschlagen.

Sicherheitsvorkehrungen (Guardrails) — JSON-Regeln, die vor jedem Tool-Aufruf durchgesetzt werden. Festgelegt über set_guardrail, eingesehen über get_guardrails.

Tool-Referenz

Dashboard

http://localhost:7373 — Aufgabenübersicht, Worker-Status, Sicherheitsregel-Editor, Speicher-Browser, Protokoll der Entscheidungen, SSE-Log-Stream.

CLI

claude-operator init          # scaffold config + DB
claude-operator start         # start MCP server + dashboard
claude-operator status        # print active workers + tasks
claude-operator retro         # open judgment call log

Entwicklung

git clone https://github.com/MoyGulati/claude-operator
cd claude-operator
pnpm install
pnpm build
pnpm test        # 39 tests
./verify.sh      # full gate (build + test)

Anforderungen: Node 24+, pnpm 10+.

Lizenz

MIT