Repolode
投稿する
cj-vana

cj-vana/claude-swarm

プロトコルによる動作制約とライブダッシュボードを備え、tmuxとgit worktree上でClaude Codeワーカー群を並列制御するMCPサーバー。

GitHub で見る
スター
117
フォーク
10
未解決の Issue
0
最終コミット
8 か月前

これは何？

Claude Swarmは、Claude Codeのセッションを複数のClaude Codeワーカーのオーケストレーターとして動作させるMCPサーバーです。各ワーカーは独立したgit worktree内のtmuxセッションで動き、1つの機能を実装して状況を報告します。サーバーはセッション状態をディスクに保存するため、チェックポイントとハートビートベースの復旧機能により、コンテキストの圧縮、クラッシュ、マシンの再起動が発生しても作業を継続できます。

このプロジェクトは、長時間にわたる自律的なコーディングのための仕組みをいくつか追加します。実装前に読み取り専用の計画フェーズを設けたり、複雑な機能について複数の計画を競わせたりできます。また、Ralph Loopでは反復ごとに新しいClaudeセッションを起動し、進捗をファイルに保存します。機能の完了扱いには検証コマンドの成功が必須で、失敗した機能は自動で再試行できます。完了後にはコードとアーキテクチャのレビューが行われ、構造化された指摘が生成されます。

プロトコルでは、ツールの制限、ファイルアクセスのルール、リソース上限などの動作制約を定義します。ワーカーの起動前にプロトコルをチェックし、実行中も監視することで、違反はレビュー用に記録されます。localhost:3456のWebダッシュボードでは、Server-Sent Events経由でワーカーのターミナル出力とセッションの進捗を配信します。

主な機能

  • 01tmuxセッション内でClaude Codeワーカーを並列実行し、それぞれを独立したgit worktreeで動かします。
  • 02セッション状態とチェックポイントを保存し、クラッシュや再起動後に作業を再開できます。
  • 03複雑な機能では、計画の作成後に実装する2段階のライフサイクルを実行します。
  • 04機能を完了扱いにする前に検証コマンドの成功を必須とし、失敗時は自動で再試行します。
  • 05ワーカーの動作前に検証し、実行中も監視する動作プロトコルを定義できます。
  • 06ターミナル出力をリアルタイムで確認できるWebダッシュボードを提供します。

ユースケース

  • 認証やテストを含むREST APIなど、大規模な機能一式を複数のコーディングエージェントに分担させる。
  • 中断が発生しても継続できる、数時間にわたる自律コーディングセッションを実行する。
  • 明示的なプロトコルを使って、自律型コーディングエージェントがアクセス・実行できる対象を制限する。
  • ブラウザのダッシュボードから複数のエージェントワーカーを同時に監視する。

クイックスタート

  1. 1

    前提条件をインストール: Node.js 18以降、tmux、Claude Code CLI

  2. 2

    ワンライナーでインストール（クローン、ビルド、MCP serverの登録、skillのインストール）

    README の公式手順に従ってインストール
  3. 3

    または手動でインストール: クローン、依存関係のインストール、ビルド

    git clone https://github.com/cj-vana/claude-swarm.git && cd claude-swarm && npm install && npm run build
  4. 4

    Claude CodeにMCP serverを登録

    claude mcp add claude-swarm --scope user -- node $(pwd)/dist/index.js

使う前に知っておきたいこと

  • Node.js 18以降に加えて、tmuxとClaude Code CLIのインストールが必要です。
  • Claude Codeのワーカーをオーケストレーションするため、このツールとその利用料金に依存します。

トピック

#ai-agents#claude#mcp#orchestration#tmux#typescript#git-worktree

よくある質問

claude-swarm とは？
プロトコルによる動作制約とライブダッシュボードを備え、tmuxとgit worktree上でClaude Codeワーカー群を並列制御するMCPサーバー。 Claude Swarmは、Claude Codeのセッションを複数のClaude Codeワーカーのオーケストレーターとして動作させるMCPサーバーです。各ワーカーは独立したgit worktree内のtmuxセッションで動き、1つの機能を実装して状況を報告します。サーバーはセッション状態をディスクに保存するため、チェックポイントとハートビートベースの復旧機能により、コンテキストの圧縮、クラッシュ、マシンの再起動が発生しても作業を継続できます。
claude-swarm は無料で使えますか？ライセンスは？
claude-swarm は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
claude-swarm は今もメンテナンスされていますか？
半年以上コミットなし。claude-swarm の最終コミットは 2026年2月11日 です。
claude-swarm は何に使えますか？
認証やテストを含むREST APIなど、大規模な機能一式を複数のコーディングエージェントに分担させる。 中断が発生しても継続できる、数時間にわたる自律コーディングセッションを実行する。 明示的なプロトコルを使って、自律型コーディングエージェントがアクセス・実行できる対象を制限する。 ブラウザのダッシュボードから複数のエージェントワーカーを同時に監視する。
claude-swarm のインストール方法は？
前提条件をインストール: Node.js 18以降、tmux、Claude Code CLI ワンライナーでインストール（クローン、ビルド、MCP serverの登録、skillのインストール） または手動でインストール: クローン、依存関係のインストール、ビルド: git clone https://github.com/cj-vana/claude-swarm.git && cd claude-swarm && npm install && npm run build Claude CodeにMCP serverを登録: claude mcp add claude-swarm --scope user -- node $(pwd)/dist/index.js
claude-swarm はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/cj-vana/claude-swarm

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト