Claude Codeセッションを自律型オペレーターに変えるTypeScript MCPサーバーです。目標の分解、複数プロジェクトにまたがるワーカーセッションの生成と調整、2層の永続メモリ管理、ガードレールの強制、そして人間による事後レビューからの学習を行います。
npm install -g claude-operator
claude-operator init
claude-operator startinit は ~/.claude-operator/ (SQLite DB、バスディレクトリ、設定) をスキャフォールドします。
start は stdio で MCP サーバーを起動し、http://localhost:7373 でダッシュボードを起動します。
Related MCP server: claude-swarm
~/.claude/settings.json に以下を追加します：
{
"mcpServers": {
"claude-operator": {
"command": "claude-operator",
"args": ["start", "--mcp"]
}
}
}または、ローカルの開発ビルドを指定します：
{
"mcpServers": {
"claude-operator": {
"command": "node",
"args": ["/path/to/claude-operator/packages/server/dist/server.js"]
}
}
}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-def2層メモリ — 第1層（揮発性、30日で自動期限切れ）と第2層（永続的、人間による確認済み）。オペレーターが分類を提案し、人間がダッシュボードで確認します (pending_classification=TRUE)。
ファイルバス — プライマリのワーカー↔オペレーター間状態チャネル。ワーカーは <bus-dir>/<worker-id>.json にハートビートを書き込みます。監視ループが期限切れのワーカー（2分以上ハートビートがないもの）を検出し、失敗としてマークします。
ガードレール — ツール呼び出しの前に強制されるJSONルール。set_guardrail で設定し、get_guardrails で確認します。
ツール | 説明 |
| 目標、プロジェクトパス、優先度、制約を含むタスクを作成 |
| 分離されたgitワークツリー上でClaude Codeワーカー（名前付きまたはヘッドレス）を起動 |
| ワーカーの状態、ハートビートの経過時間、現在のタスクをポーリング |
| タスクを完了としてマークし、ワークツリーブランチをマージし、クリーンアップ |
| オペレーターメモリ全体に対するFTS5全文検索 |
| 層と信頼度を指定してメモリエントリを書き込み/更新 |
| ガードレールルールを追加または更新 |
| アクティブなガードレールルールを一覧表示 |
| ファイルバス経由で実行中のワーカーに指示を送信 |
| 事後学習のために人間の判断を記録 |
http://localhost:7373 — タスクボード、ワーカーの状態、ガードレールエディター、メモリブラウザ、判断ログ、SSEログストリーム。
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 loggit clone https://github.com/MoyGulati/claude-operator
cd claude-operator
pnpm install
pnpm build
pnpm test # 39 tests
./verify.sh # full gate (build + test)要件: Node 24+、pnpm 10+。
MIT
This server cannot be deployed
Persistent, governed institutional memory for Claude Code — specs, decisions, learnings.
Persistent cross-session memory shared by Codex, Claude Code, ChatGPT, and other AI agents.
Adaptive plan/build/review cycles for AI coding assistants, persisted across sessions.
Build and supervise fleets of agents from Claude Code, Codex or Cursor. Connects over OAuth.
