claude-flow

Ruflo を始める

Claude Code で始めるには、コアツール、ビジュアルコンソール、ランタイムモッドを使用します。Claude Code 2.1.287 以降が必要です。Claude Code 内で実行してください：

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-console@ruflo
/plugin install ruflo-mods@ruflo
/reload-plugins
/ruflo

Core は基盤となるツールを提供します。Console はエージェントのコックピットを開きます。Mods は Claude Code 内でルーティングとポリシー適用を追加します。Mods はご自身のアカウントの権限で実行されるため、インストール前にコードを確認してください。

Codex またはその他の MCP 対応ツールをお使いですか？ Ruflo プロジェクトのセットアップには NPX を使用し、クライアントを Ruflo MCP サーバーに接続してください。プロジェクトのターミナルでセットアップウィザードを実行します：

npx ruflo@latest init wizard

ローカルの stdio MCP サーバーに対応したクライアントでは、command に npx、arguments に ["-y", "ruflo@latest", "mcp", "start"] を設定してください。同等のサーバーコマンドは次のとおりです：

npx -y ruflo@latest mcp start

MCP は Ruflo のツールをクライアントに公開します。上記のコンソールと Mods は Claude Code との統合機能です。フックのサポートはクライアントによって異なります。

通常のターミナルを使いたい場合（任意）。 Claude Code を使わずに、コンソールを単独で実行することもできます：npx ruflo tui（スクリプトで 1 フレームだけ出力するには --plain を追加します）。概要、コスト、スウォーム、イベント、ミッションに加えて、任意の AI ページが表示されます。ターミナル UI ガイド

インストール方法を比較 · コンソールを開く · ユーザーガイド

https://ruos.cognitum.one/mcp

npx ruvector

エージェント = モデル + ハーネス。 モデルがコードを書き、ハーネスがツール、メモリ、ループ、サンドボックス、制御機能を与えることで、実際に作業できるようにします。Ruflo はハーネスです — Claude Code と Codex を取り巻く実行レイヤーとして、100 以上の専門エージェント、連携するスウォーム、自己学習型メモリ、マシン間のフェデレーション通信、エンタープライズ向けセキュリティガードレールを追加します。これにより、エージェントは実行するだけでなく、協力して動作します。

npx ruflo init を実行するだけで、Claude Code に神経系が備わります。エージェントはスウォーム内で自律的に編成され、すべてのタスクから学習し、セッションをまたいで記憶し、フェデレーションを使えばデータを漏らすことなく他のマシン上のエージェントと安全に通信します。コードを書くのはこれまでどおりです。連携は Ruflo が処理します。

_{概念的な学習ループです。ローカルなベクトル検索と対照的な更新は、LLM を使わずに実行できます。ただし、埋め込みと設定済みの学習モジュールは引き続き必要です。RuVector のトレーニング統合と軌跡の対照学習をご覧ください。}

Ruflo を初めて使いますか？ 314 個の MCP ツールや 26 個の CLI コマンドを覚える必要はありません。init の後は、普段どおり Claude Code を使うだけです。フックシステムがタスクを自動的にルーティングし、成功したパターンから学習し、バックグラウンドでエージェントを連携させます。

確認できる起源

Reuven Cohen (rUv)がClaude Flowとして開発を始めました。 2025年6月2日の最初のコミットには、Claudeがコードを書き、編集し、テストし、改善する、再帰的なエージェントサイクルのためのコードオーケストレーションレイヤーについて記されています。6月10日のソーススナップショットでは、オーケストレーション、タスクスケジューリング、メモリ、ターミナルのモジュールが追加されています。

ハーネスとは、モデルを取り巻く作業環境です。タスクを整理し、ステップ間でコンテキストを引き継ぎ、結果の確認を支援します。これはRufloの系譜を示すものであり、あらゆるClaude Codeツールの中で普遍的に最初であることを示すものではありません。 図解付きの解説、正確なコミット、エコシステムの先行事例についてはこちらをご覧ください。

アニメーションデモを開く · Theme Studioガイド · ワークフローデモ

エージェントのコックピットです。 Claude Codeの横で、ワークフロー、エージェント、モデル、トークン、コストを追跡できます。38秒のアニメーションでは、実際のレンダラーのフレームを通してOrbitalとTheme Studioを紹介します。起動チェック、6つのパレット、カスタマイズ、保存したテーマ、JSONのインポート、サイズ変更が含まれています。このコンパクトな3.84 MBのSVGには、456フレームすべてが保持されています。ネイティブホストとAIプロバイダーの実行は紹介していません。

あらゆる実行を確認できます。 エージェントのログと結果を開き、検索、障害のトリアージ、再生、比較ができます。npx ruflo initを実行し、Claude Codeを再起動してから、/rufloを実行してください。コンソールの全体ツアー。

Claudeに操作を任せ、上限はあなたが設定します。 Settings → Claude controlを有効にすると、コンソールの移動や操作の実行ができます。read、write、manage、fullから権限を選び、承認方法はaskまたはautoを選択します。現在のデフォルトはread + askです。権限レベルを上げるかどうかはあなた次第です。権限レベルを超える操作は拒否されます。また、autoでもネットワーク、支出、破壊的な操作には確認が必要です。リアルタイムの操作ログを確認するか、Take back controlを押してClaudeの操作を停止してください。詳細。

Claude を使ってミッションを 1 つ作成する

以下の録画されたコンソールセッションをご覧ください。 Claude がミッションを作成し、Learning ページと Security ページを開き、実行した操作を Overview で報告します。

1. 境界を設定します。 以下のコマンドでコンソールをインストールし、/ruflo を開いてから、Settings → Claude control → write + ask を選択します。
2. 具体的なリクエストを出します。 次を試してください：「ダークモード切り替え機能を追加するミッションを作成してください。ミッションとそのステータスを見せてください。」
3. 作成を承認します。 Claude が Missions を開き、目標を設定します。コンソールで保留中の作成アクションを確認してください。
4. 結果を確認します。 Missions に目標が含まれていることと、Overview に操作が記録されていることを確認します。ミッションを作成しただけでは、その機能が実装されたことにはなりません。
5. 制御を維持します。 Take back control を押すと、Claude のコンソールツールが一時停止します。制御を戻すまで、以降の呼び出しは拒否されます。

録画で確認できる内容： write + auto を使った実際の Claude Haiku セッション、ミッションの作成、ページ間の移動、拒否された swarm stop、制御の取り戻しです。上記の手順では ask を使い、作成を自分で承認します。リンク先のワークフローアニメーションではサンプルデータが使われており、テーマのデモではレンダラーフレームが再生されます。どちらも、swarm の作業完了やメモリの想起を示すものではありません。

実装と録画テストの結果 · 再現スクリプト

ruflo マーケットプレイスからモッドをインストールします（Claude Code 2.1.287 以降。モッドはアカウントの権限で動作し、サンドボックス化されていないため、最初にコードを確認してください）：

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-console@ruflo
/plugin install ruflo-mods@ruflo
/reload-plugins

上記のコックピットが ruflo-console、プロンプトをルーティングしてプロセス内でポリシーを適用するのが ruflo-mods、ペインに swarm を表示するのが ruflo-swarm、ruOS のステータスセグメントを追加するのが ruflo-ruos です。/plugin を開いて、アクティブなモッドの行に表示されていることを確認してください。コンソール内では、/ruflo market が Plugin Catalog です。すべての ruflo プラグイン、モッド、スキルと、それぞれに含まれるものを確認でき、インストール、有効化、無効化、更新の各ボタンを使えます（いずれも最初に確認を求めます）。

クイックスタート

インストール方法は 2 種類あり、対象範囲が大きく異なります。 必要なものに応じて選択してください（#1744）：

パス A — Claude Code プラグイン（軽量版、スラッシュコマンドのみ）

# Add the marketplace
/plugin marketplace add ruvnet/ruflo

# Install core + any plugins you need
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
/plugin install ruflo-rag-memory@ruflo
/plugin install ruflo-neural-trader@ruflo

スラッシュコマンドとエージェント定義が追加されます。ruflo-core（上記でインストール済み）は、インストール時に独自の MCP サーバーも登録します。そのツールは、CLI トラックのスキャフォールドで使用される memory_store／swarm_init／agent_spawn という名前ではなく、mcp__plugin_ruflo-core_ruflo__*（例：mcp__plugin_ruflo-core_ruflo__memory_store）として呼び出せます。他のプラグインは通常、独自の MCP サーバーを同梱していません。CLI トラックのツール名を使用して一連の処理を行うには、以下のパス B を使用してください。

CLI のインストール

macOS / Linux / WSL / Git-Bash：

# One-line install (POSIX shells only — see Windows note below)
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash

すべてのプラットフォーム（ネイティブの Windows PowerShell / cmd を含む）：

# Interactive setup wizard — runs identically on every platform
npx ruflo@latest init wizard

# Quick non-interactive init
# npx ruflo@latest init

# Or install globally
npm install -g ruflo@latest

💡 Windows ユーザーの方へ： curl ... | bash 形式には POSIX シェル（Git-Bash、WSL、MSYS）が必要です。npx ruflo@latest init wizard の行は PowerShell と cmd でネイティブに動作します。'bash' is not recognized エラーが発生した場合は、代わりに npx の行を使用してください — どちらも同じ初期化フローを実行します。

MCP サーバー

# Add Ruflo as an MCP server in Claude Code
claude mcp add claude-flow -- npx ruflo@latest mcp start

提供する機能

機能	説明
100以上のエージェント	コーディング、テスト、セキュリティ、ドキュメント、アーキテクチャに特化したエージェント
通信レイヤー	ゼロトラストのフェデレーション — マシンや組織をまたぐエージェントが互いを検出し、認証を行い、安全に作業をやり取りします
スウォーム連携	コンセンサスを備えた階層型、メッシュ型、適応型トポロジー
自己学習	SONA のニューラルパターン、ReasoningBank、軌跡学習
ベクトルメモリ	HNSW インデックスを使用した AgentDB — N=20k で約1.9倍、N=5k で総当たり検索と比べて約3.2〜4.7倍高速であることを測定（recall@10 は約0.99）。ANN はクロスオーバーポイントを超えると優位で、N が小さい場合は同等または劣ります。監査 と scripts/benchmark-intelligence.mjs を参照してください
バックグラウンドワーカー	自動起動する12個のワーカー（監査、最適化、testgaps など）
プラグインマーケットプレイス	Claude Code のネイティブプラグイン33個 + npm プラグイン21個
マルチプロバイダー対応	Claude、GPT、Gemini、Cohere、Ollama に対応し、スマートルーティングを提供
セキュリティ	AIDefence、入力検証、CVE の修正、パストラバーサルの防止
エージェントフェデレーション	ゼロトラストセキュリティによる、インストール環境をまたいだエージェント連携
MetaHarness	リリース前に AI エージェントのセットアップを監査できます。準備状況を評価し（1〜100）、ツール設定のセキュリティ上の問題をスキャンし、プロジェクト全体のスナップショットを作成して経時的なリグレッションを検出し、リポジトリに合ったテンプレートを見つけます。ruflo eject を実行すると、ruflo プロジェクトを独自の名前を持つスタンドアロンのエージェントツールキットに変換できます。詳細ガイド。

経験から学ぶ

有用な軌跡とタスクへのフィードバックは、今後の作業に活用できます。結果は、設定されたメモリ、学習コンポーネント、フィードバックの品質によって異なります。学習プラグイン。

エージェントフェデレーション — エージェント向け Slack

Slack はチームにチャンネルをもたらしました。フェデレーションはエージェントにも同じものをもたらします — 信頼境界を越えて共有されるワークスペースで、異なるマシン、組織、クラウドリージョン上のエージェントが互いを発見し、身元を証明し、タスクに協力できます。

違いは、一部のチャンネルは信頼され、一部はそうではないという点です。@claude-flow/plugin-agent-federation がこれを自動的に処理します。エージェントはフェデレーションに参加し、mTLS + ed25519 によって検証され、作業の交換を開始します — ノードから出る前に PII が除去され、すべてのメッセージが監査可能な状態で。信頼されていないエージェントも、より低い権限で参加できます。エージェントが確認できるのは発見情報であり、メモリーではありません。信頼性が実証されるにつれて、信頼レベルが引き上げられます。不適切な動作をした場合は、人が介在することなく、即座に引き下げられます。

ハンドシェイクを設定したり、証明書を管理したりする必要はありません。federation init、federation join を実行すれば、エージェントが会話を始めます。プロトコルが ID を処理し、PII パイプラインがデータの安全性を確保し、監査証跡がコンプライアンスに対応します。

📘 ユーザーガイド全文： docs/federation/ — セットアップ、MCP ツール、信頼レベル、サーキットブレーカー、およびパケット層の到達可能性をフェデレーションの信頼に結び付ける（オプトイン方式の）WireGuard メッシュレイヤー。ADR-111 の詳細については docs/federation/phase7-mesh-bringup.md をご覧ください。

# Team A: initialize federation and generate keypair
npx claude-flow@latest federation init

# Team A: join Team B's federation endpoint
npx claude-flow@latest federation join wss://team-b.example.com:8443

# Team A: send a task — PII is stripped automatically before it leaves
npx claude-flow@latest federation send --to team-b --type task-request \
  --message "Analyze transaction patterns for account anomalies"

# Team A: check peer trust levels and session health
npx claude-flow@latest federation status

アーキテクチャ全体、信頼モデル、実装ロードマップについては、issue #1669 をご覧ください。

# Claude Code plugin
/plugin install ruflo-federation@ruflo

# Or via CLI
npx claude-flow@latest plugins install @claude-flow/plugin-agent-federation

User --> Claude Code / CLI
          |
          v
    Orchestration Layer
    (MCP Server, Router, 27 Hooks)
          |
          v
    Swarm Coordination
    (Queen, Topology, Consensus)
          |
          v
    100+ Specialized Agents
    (coder, tester, reviewer, architect, security...)
          |
          v
    Memory & Learning
    (AgentDB, HNSW, SONA, ReasoningBank)
          |
          v
    LLM Providers
    (Claude, GPT, Gemini, Cohere, Ollama)

ドキュメント

4 つの対象者向けに、4 つのドキュメントを用意しています。

ベンチマークの内部資料（再現用）：sota-workload-spec.md · SOTA-PROGRESS.md · マトリックスの生 JSON：darwin · linux

ユーザーガイドのセクション一覧：

サポート

ライセンス

MIT - RuvNet