Booboo

🐾 Booboo — 統合された運用ブレイン

あらゆる AI システムのデータを、構造 + 知識 + 記憶 + エージェント + 自動化がひとつのグラフに融合した、生きたルート付きの 3D ブレインに変換します。REST または MCP 経由でクエリでき、ブラウザーまたはデスクトップの壁紙として表示でき、1 回の呼び出しでエージェントを起動できます。

インストール前に実物を見る → booboo.fractionalhq.uk · ブラウザーですぐに使えるライブブレイン。サインアップも、クローンも不要です。

おやつを埋めた場所を決して忘れないダックスフンドにちなんで名付けられました。ぴったりなのは、Booboo がまさに記憶と想起を扱うものだからです。システム全体を一度に見渡し、埋もれた情報を取り出し、つながりを見失いません。

加工なし：booboo view --demo --nodes 50000 — 50k ノード、4 層、ブラウザーのタブでライブ表示、コンソールエラーはゼロ。コマンドを 1 つ実行して試してみてください。

ほとんどのツールが表示するのは、ナレッジグラフ、エージェントのフローチャート、メモリーストア、トレースビューアーなど、ひとつの側面だけです。Booboo はそれらすべてを単一の点をルートとするひとつのグラフに融合するため、システム全体が実際にどのようにつながっているのかを確認し、クエリできます。

ステータス： アルファ — 8 つのパッケージを公開済みです：@booboo-brain/spec（コントラクト）、@booboo-brain/build（設定駆動の postgres/json アダプター）、@booboo-brain/serve（REST + MCP クエリレイヤー）、@booboo-brain/viewer（100 万ノードの 3D 描画）、@booboo-brain/panel（組織図）、@booboo-brain/vault（Wiki リンク付き Markdown エクスポート）、@booboo-brain/cli（統合 booboo コマンド）、create-booboo（プロジェクトのひな形作成ツール）。セマンティックバージョニングはパッケージごとです。各 package.json を参照してください。MIT。

---

ひとつのアイデア

Booboo の中心にあるのは小さな JSON 仕様です。そこにデータを渡すアダプターと、描画・提供・クエリを行うコンシューマーが組み合わさっています。

  your data ──▶  ADAPTERS  ──▶  GRAPH JSON ──▶  CONSUMERS
  (postgres,     (config-       (the spec,       (3D viewer ·
   json, neo4j,   driven,        ~1 KB            REST API ·
   mcp, …)        ~50 lines)     contract)        MCP server · wallpaper)

JSON を出力するだけで、ビューアー、API、MCP サーバーを無料で利用できます。特殊なデータには、フォークではなく約 50 行のアダプターを用意します。SPEC.md を参照してください。

クイックスタート

コマンドは 1 つ。データベースも設定もサインアップも不要です。 お使いのマシンで動く合成ブレインです。

npx @booboo-brain/cli view --demo --nodes 1000000

これが最大の見せ場です。ブラウザーのタブで 100 万ノードを 60fps で描画します。 一般的なノート PC では --nodes 50000 に減らしてください。どのように動作するかは SCALE.md を参照してください（カスタムシェーダーを使った単一ポイントクラウドの 1 回のドローコールと、ラベルの段階的な LOD によって実現しています）。

お使いのマシンで問題なく動いたら、スターを付けてください。このリポジトリにはマーケティング施策がありません。次の開発者に見つけてもらうための手段がスターです。

次に、ご自身のスタックを接続します：

# scaffold a project (json starter + postgres upgrade path)
npx create-booboo my-brain
cd my-brain
npm install
npm run build                    # booboo.config.yaml → brain.json (the snapshot)
npm run serve                    # REST API on http://localhost:8787
npm run mcp                      # MCP over stdio — point Claude / Cursor / Claude Code at it

booboo.config.yaml を編集して、ご自身の Postgres/Supabase を指定してください（ひな形にはコメントアウトされた設定例が含まれています）。詳細なリファレンスは docs/CONFIG.md を参照してください · 困ったときは docs/TROUBLESHOOTING.md を参照してください。

ロードマップ： build + REST + MCP + 3D ビューアーをまとめたオールインワンコマンドと、対話型のひな形作成ウィザードを予定しています。進捗は LAUNCH_CHECKLIST.md で管理しています。

現在動作する機能

booboo build --config booboo.config.yaml    # any postgres/json → one graph snapshot (privacy walls + parent spines)
booboo serve --snapshot my.booboo.json --port 8787   # REST: /graph /stats /search /nodes/:id /neighbors/:id /path/:a/:b
booboo mcp   --snapshot my.booboo.json --org org.booboo.json  # MCP over stdio (+ booboo_boot: agents boot FROM the org)
booboo view  --snapshot my.booboo.json               # 3D viewer in your browser — no monorepo, no build step
booboo panel --org org.booboo.json --snapshot my.booboo.json  # THE ORGANIGRAM — see below
booboo vault --snapshot my.booboo.json --org org.booboo.json --out vault  # the brain as a markdown vault — see below

booboo view は、@booboo-brain/viewer の 3D レンダラーをスタンドアロンアプリとして提供します。スナップショット（または ?n=1000000 の合成データ）をブラウザーで表示でき、モノレポは不要です。ビルドエンジンは、設定だけで Supabase から直接組み立てた、実環境の4,469 ノードの本番用ブレインで実証済みです。プライバシー保護の境界を設け、検証したうえで提供しています。詳細は各パッケージの README をご覧ください。

Claude / Cursor に接続する（MCP）

booboo mcp は stdio 経由で MCP に対応します。ホストするサーバーは不要で、必要に応じて起動するため、任意の MCP クライアントから接続できます。

// Claude Desktop: claude_desktop_config.json · Cursor: .cursor/mcp.json · Claude Code: .mcp.json
{
  "mcpServers": {
    "booboo": {
      "command": "npx",
      "args": ["-y", "@booboo-brain/cli", "mcp",
               "--snapshot", "my.booboo.json", "--org", "org.booboo.json"]
    }
  }
}

エージェントからシステム全体にクエリできるようになります。利用できるのは search、neighbors、path、stats です。booboo_boot('<agent-id>') は、エージェントのルール、メモリーの参照範囲、レポートを返すため、エージェントは組織から起動できます。また、booboo_remember / booboo_report を使うと、再ビルド後も保持される永続的なメモリーやレポートを書き戻せます（ライブメモリーシステム）。クライアントの作業ディレクトリが異なる場合は、--snapshot/--org に絶対パスを指定してください。

ツール

ツール	機能
booboo_stats	グラフ全体のノード数とリンク数をレイヤー別に表示します。
booboo_count	ペイロードを取得せず、件数のみを数えます。クエリの規模を見積もる際に使用します。
booboo_search	ラベルまたは ID でノードを検索します（順位：完全一致 > 前方一致 > 部分一致）。まずこれを使ってノードの ID を特定します。
booboo_node	正確な ID を指定して、単一ノード（全フィールドとデータ）を取得します。
booboo_neighbors	ノードの近傍を取得します。接続されたノードと、depth ホップ先までのリンクが含まれます。
booboo_path	2 つのノード ID 間の最短経路（ノードの連鎖）を取得します。到達できない場合は null を返します。
booboo_boot （--org 使用時）	組織図からエージェントの起動時情報を取得します。アイデンティティ、権限の連鎖、継承されたルール、バケットへのアクセス権、スキル、子エージェントが含まれます。毎回のセッションで最初に呼び出してください。
booboo_org （--org 使用時）	すべてのエージェント、階層、バケット、ルール参照を含む、組織図全体を取得します。
booboo_remember	永続的なメモリーを書き込みます。エージェントに紐づく、単一の不可分な事実です。スナップショットと同じ場所にあるジャーナルに追記され、同じセッションでクエリ可能で、再ビルド後も保持されます。
booboo_report	レポートを書き込みます。エージェントが直前に完了した内容を記録し、パネルのレポートタイムラインに表示します。

booboo_remember / booboo_report はデフォルトで有効です。メモリーシステムのライブ部分を担います。読み取り専用サーバー（公開環境／アクセス制限の厳しいデプロイ）にするには、--no-write（または BOOBOO_READONLY=1）を渡してください。ジャーナルの読み取りは引き続き行いますが、書き込みは拒否します。

オーガニグラム — エージェントを会社のように運用する

booboo panel を使うと、エージェントのフリートを実際の組織図として表示できます。この図は単なる図ではなく、権限そのものです。エージェントはそれぞれカードとして表示され、ルール、スキル、メモリバケットへのアクセス権、最新レポートを確認できます。エージェントを新しい親の下にドラッグして適用すると、組織ファイルが変更されます。変更は git でバージョン管理され、書き込み前に検証されるため、循環が発生することはありません。booboo_boot で起動するエージェントは、次のセッションから新しい構成に従います。朝食の時間に会社を再編成すれば、最初のコーヒーを飲む頃にはフリート全体に反映されています。

ポートフォリオのタイムライン	メモリをバケットごとに表示

1つの組織ファイルと1つのスナップショットを、5つのタブで表示します。オーガニグラム（ドラッグ＆ドロップで階層を編集） · バケット（誰が何を記憶しているか） · レポート（フリートが完了した作業、新しい順） · ルール（誰が宣言し、誰が継承するか） · グラフ（埋め込み式の3Dブレイン）。ルールは上から下へ継承されます。ブランチで一度宣言すれば、その下のすべてのエージェントに適用されます。各ドシエには、起動順に並んだ継承ルールの一覧が表示されます。

レポートとバケットには、2つの方法でデータを登録できます。エージェントが booboo_remember / booboo_report を呼び出したときにライブで登録する方法（再ビルド不要の永続的なジャーナル書き込み）と、設定を使って独自のテーブルから一括で登録する方法です。詳しくはdocs/CONFIG.md § フリートのレポートとメモリの接続を参照してください。

ボルト — プレーンな Markdown で作るあなたのブレイン（Obsidian 対応）

booboo vault は、同じスナップショットをWikiリンク付きの Markdown ボルトとして出力します。各ノードのページにはフロントマターとリンクが含まれ、レイヤーやクラスターごとのインデックスページに加え、組織のメンバーごとにドシエ（指揮系統、継承ルール、バケット、マシン、契約）も生成されます。このフォルダーを Obsidian のボルトとして開けば、「LLM のセカンドブレイン」パターンを利用できます。手作業でメモを与えるのではなく、実際のシステムから生成する点が異なります。プレーンなファイルは究極のポータビリティを実現します。誰でも読めますし、どのプロバイダーのエージェントでも読み取れます。毎晩出力すれば、ボルトをバックアップとしても利用できます。

リンクは自分で作成できます。ノート本文に [[node-id]]（または [[exact label]]）の参照を記述し、設定で wikilinks: true にすると、ビルダーがそれらを第一級の authored エッジに変換します。これらのエッジは、グラフ、API、3D ビュー、ボルトのすべてで、収集されたリレーションより優先されます。各ビルドでは、取り込み品質の指標（authored · orphans · dump-suspects）も出力されるため、キュレーションの状態を感覚ではなく数値で把握できます。

エージェントがすべきことを理解できます — 契約はスキャフォールドとともに提供されます

npx create-booboo は、プロジェクトにAGENTS.md（CLAUDE.mdからインポート）をスキャフォールドします。これは、そのフォルダーで作業するあらゆる AI エージェントが自動的に読み込む運用指針です。組織から起動すること、ノート1つにつき事実を1つだけ記録すること、[[links]] を自分で作成すること、修正時は置き換えること、境界を尊重すること、品質ゲートを確認すること、誠実に作業を完了することを定めています。新規インストール時点で、エージェントはブレインの規約を理解しています。ルールが変わったらファイルを編集してください。このファイルはシステムの憲章であり、組織と並べてバージョン管理されます。

どこが違うのか

GitHub 上で最も近いものは、どれも一つのレイヤーだけを担っています。それぞれの領域では優れたツールです。

	システム全体を俯瞰	REST API	MCP（エージェントがクエリ可能）	100万ノードでの3D表示	プライバシーの壁
Booboo	✅	✅	✅	✅	✅
グラフビューアー（3d-force-graph）	表示のみ	—	—	✅	—
ノートグラフ（Obsidian、Logseq）	自分のノートであり、システムではありません（booboo は Obsidian vault を出力します：booboo vault）	—	プラグイン	—	—
エージェントフレームワーク（LangGraph、トレース）	フローと実行	✅	部分的	—	—
メモリストア（Graphiti、Cognee）	メモリのみ	✅	✅	—	—

配線＋ナレッジ＋エピソード記憶＋エージェント＋cronを一つに融合し、ビュー、壁紙、API、MCP ソースとして同時に機能する、ルートを持つライブな起動可能な脳はほかにありません。この運用面での融合こそが新しい点です。

すぐに使える形で（任意 — 上記の機能はすべて無料のままです）

すべての機能は MIT ライセンスで、今後も変わりません。セットアップを自分で行いたくない場合は、 Fractional HQ がお客様のスタックに合わせて、カスタムアダプター、 ホスト型スナップショット、更新パイプラインを構築します。同じリポジトリ、同じ設定スキーマを使い、フォークも制限もありません。

ライセンス

MIT — フォーク、カスタマイズ、配布を前提に構築されています。Fractional HQ 提供。