SynaBun

SynaBun

AI コーディングツール向けの長期記憶を、自分のコンピューターに保存します。

synabun.ai · ドキュメント · ブログ · 比較 · 変更履歴

---

SynaBun は、オープンソースでセルフホスト可能な AI ワークスペース兼永続記憶 MCP サーバーです。SynaBun Assistant が Claude Code、Codex、OpenCode のエージェントを連携させます。 あるセッションで決めたこと、修正したこと、説明したことは、次のセッションでも、接続したすべてのプロジェクトやツールで引き継がれるため、同じ説明を繰り返す必要がなくなります。すべてはコンピューター上の 1 つの SQLite ファイルに保存されます。アカウントも、クラウドサービスも、API キーも必要ありません。

npm install -g synabun

synabun でアプリを起動します。synabun mcp は、あらゆる MCP クライアントで使える stdio の MCP サーバーです。

{
  "mcpServers": {
    "SynaBun": {
      "command": "npx",
      "args": ["-y", "synabun", "mcp"]
    }
  }
}

グローバルインストール後は、"command": "synabun", "args": ["mcp"] で同じサーバーを起動できます。ドキュメントを読むか、ほかの記憶ツールとのSynaBun の比較をご覧ください。

Claude Code、Codex CLI、Gemini CLI、OpenCode にはそれぞれ 1 つの切り替え操作で接続できます。Cursor、Windsurf、その他の MCP（Model Context Protocol）対応ツールには、コピーして使える設定スニペットで接続できます。Neural Interface も付属しており、ツールが記憶している内容を確認したり、コーディングエージェントを実行したりできるローカルのウェブアプリです。

できること

• セッションをまたいでコンテキストを保持します。 アシスタントは作業中に学んだことを保存し、次のタスクの前にそれを検索します。検索では、キーワードだけでなく意味も照合します。
• 記憶している内容を確認できます。 Neural Interface の 3D マップで、関連する記憶がまとまって表示されます。記憶の閲覧、検索、編集、削除ができます。
• Claude Code、Codex、OpenCode を並行して実行できます。 Neural Interface にはそれぞれのサイドパネルがあり、ターミナル、ファイルエクスプローラー、ホワイトボードと並べて表示できます。すべてが同じ記憶を共有します。
• タスクを委任できます。 SynaBun Assistant がタスクを計画し、使用するモデルを提案して、Claude Code、Codex、OpenCode のワーカーに渡し、結果を報告します。WhatsApp からメッセージを送ることもできます。
• 自動化できます。 タスクをテンプレートとして保存し、ループまたはスケジュールに従って実行できます。
• エージェントにブラウザーを使わせることができます。 ブラウザーツールを使うと、エージェントはページを開き、クリックや入力を行い、ブラウザーで内容を読み取れます。操作の様子は確認できます。

クイックスタート

Node.js 22.19 以降が必要です。

npm install -g synabun
npm --prefix "$(npm root -g)/synabun/mcp-server" run setup:embeddings
synabun

1. インストールします。 1つ目のコマンドで SynaBun をインストールします。2つ目のコマンドで、意味検索を支えるモデルをダウンロードします。このモデルがなくても SynaBun は動作しますが、キーワード検索のみとなります。Windows のコマンドプロンプトでは、$(npm root -g) を npm root -g の出力結果に置き換えてください。

2. 起動します。 synabun を実行すると、ニューラルインターフェースが http://localhost:3344 で起動し、ブラウザーでセットアップウィザードが開きます。初回起動時には、ブラウザーツール用の Chromium ビルドもインストールされます。

3. AI ツールに接続します。 ウィザードでプロジェクトを追加し、使用するツールをオンにします。SynaBun は Claude Code、Codex CLI、Gemini CLI、OpenCode に自身を登録し、それぞれのツールに、いつ記憶を呼び出し、いつ記憶するかを伝える短いルールをインストールします。Cursor、Windsurf、その他の MCP ツールでは、同じ手順に表示される設定スニペットをコピーしてください。接続は後から 設定 → AI 接続 で変更できます。

4. 試してみましょう。 AI ツールで新しいセッションを開始し、次のように伝えます。

   デプロイは release ブランチから行い、main からは行わないことを覚えておいてください。

   別のセッションを開始し、次のように尋ねます。

   デプロイ方法について、何を覚えていますか？

   次に http://localhost:3344 を開いて、マップ上の記憶を確認します。/ を押すと検索、a を押すとアシスタントが開きます。タイトルバーの ? ボタンを押すと、使い方の案内が表示されます。

作業中は synabun を起動したままにしてください。Claude Code はこれを通じて記憶にアクセスします。終了するには Ctrl+C を押します。問題がある場合は、synabun doctor でデータとツール接続の状態を確認できます。

ソースから実行する場合は、次のようにします。

git clone --depth=1 https://github.com/danilokhury/Synabun.git
cd Synabun
npm start

npm start は依存関係をインストールし、MCP サーバーをビルドしてアプリを起動します。起動したら、別のターミナルで npm --prefix mcp-server run setup:embeddings を実行すると、意味検索が有効になります。

動作の仕組み

Your AI tool ── MCP ──▶ SynaBun MCP server ──▶ memory.db (SQLite) ◀── Neural Interface (localhost:3344)

• ローカルデータベース。 記憶は、ディスク上の1つの SQLite ファイルに保存されます。それぞれの記憶はキーワード検索と意味検索用にインデックス化されます。意味検索には、マシン上で動作するモデルを使用します。
• MCP サーバー。 AI ツールに remember、recall、reflect、forget、restore などの記憶ツールを提供します。どの MCP クライアントからでも利用できます。
• ニューラルインターフェース。 同じデータベースを読み込む、ポート 3344 上のローカルウェブアプリです。記憶マップ、設定、サイドパネル、アシスタント、自動化機能を備えています。
• ルールとフック。 インストールされたルールは、まとまった作業の前に記憶を呼び出し、その後に記憶するよう各ツールに指示します。Claude Code では、フックもこれに加わり、関連する記憶をセッションに取り込んだり、作業内容を保存するようアシスタントに促したりします。

機能

記憶

• キーワード検索と意味検索。 recall は両方を組み合わせ、トークン予算に合わせた簡潔な結果を返すことができます。
• 独自に定義できるカテゴリ。 各カテゴリの説明によって、そこに何を含めるかをアシスタントに伝えます。
• プロジェクトごとに1つの記憶。 recall は現在のプロジェクトを優先しつつ、別のプロジェクトで得た情報も見つけます。
• 失われにくい設計。 編集内容は改訂履歴に残り、取り消すことができます。削除した記憶はゴミ箱から復元でき、sync はソースファイルが変更された記憶にフラグを付けます。
• バックアップ。 設定 → 記憶とバックアップ で、スケジュール設定されたチェックサム検証済みのバックアップを利用できます。synabun restore-backup --from <backup.zip> はバックアップを確認し、--apply を追加すると復元します。

ニューラルインターフェース

• メモリーマップ。 保存されているすべてを3Dマップで表示します。最上位のカテゴリは大陸、カテゴリは島、似たメモリーは隣同士に配置されます。
• ワークスペース。 メモリーの横にターミナル、ファイルエクスプローラー、ホワイトボードが並びます。
• 検索できる設定。 英語とブラジルポルトガル語に対応しています。
• ワークスペースツアー。 ? ボタンから利用できます。
• スクリーンショット用のショーケースモード。 ?showcase=1 を付けてインターフェースを開くと、変更を保存せずにレイアウトが読み込まれ、個人のコンテンツ（メモリー、セッション名、文字起こし、ターミナル出力、アカウント名、プライベートに見える情報（メールアドレス、ホームフォルダーのパス、ID、キー、電話番号、ほかのプロジェクト名））にぼかしが入ります。?lang=en または ?lang=pt-BR を指定すると、そのページのみ言語が切り替わります。キャンバス上に描画されたマップのラベルは個別にぼかせません。また、ドラッグしたホワイトボードとメモリーの位置は保存されます。

コーディングエージェント

• Claude Code、Codex、OpenCode 用のサイドパネル。 ご自身のアカウントを使って、回答のストリーミング、ツール呼び出し、承認、プラン、再開可能なセッションを利用できます。Gemini CLI と通常のシェルはターミナルタブで開きます。
• SynaBun Assistant。 毎ターンでメモリーを呼び出し、タスクの実行先を提案してワーカーに割り当て、構造化された結果を読み返すアシスタントです。予算上限とトークンゲージで支出を確認できます。
• WhatsApp Link。 3段階の権限レベルを設定し、リンク済みデバイスとしてスマートフォンからアシスタントにメッセージを送れます。docs/whatsapp.md をご覧ください。
• macOS でのコンピューター操作。 アシスタントは、ガードと停止コントロールのもとでデスクトップアプリを認識し、操作できます。
• スタイルガイド。 プロジェクトごとのブランドとデザインシステムを DESIGN.md とデザイントークンとして保存します。エージェントはこれを読み取り、変更は提案のみ行えます。docs/style-guide.md をご覧ください。

自動化とツール

• Automation Studio とスケジュール。 ループとして、またはスケジュールに従って実行するタスクテンプレートです。
• ブラウザーツール。 移動、クリック、入力、読み取り、スクリーンショットの撮影ができます。また、複数の操作を1回の呼び出しにまとめることもできます。docs/browser-v2.md をご覧ください。
• インテグレーション。 Discord、Google Search Console、YouTube Studio、Leonardo.ai、Bluesky 用のツールグループと、X、Facebook、Instagram、LinkedIn、TikTok、WhatsApp Web 用のリーダーを利用できます。ツールプロファイルを使うと、セッションで必要なグループだけに制限できます。
• スキル。 /synabun はメモリーをもとにブレインストーミングを行い、コードと照らしてメモリーを監査し、会話を保存してスケジュールを作成します。/leonardo は画像と動画のプロンプト作成を支援します。
• Claude Code フック。 インストール、分離、測定の方法については、docs/hook-integrity.md をご覧ください。
• AI による判断（任意）。 ご自身の TypeSafe API キーを使うと、固定ルールでは推測が必要な判断（このメモリーは重複しているか、秘密情報を含むか、古くなっているか）を SynaBun に依頼できます。すべての判断にはローカルのフォールバックがあり、キーがなければ何も送信されません。docs/judgments.md をご覧ください。

要件

• Node.js 22.19 以降。
• macOS、Windows、Linux。 コンピューター操作は macOS のみ対応しています。
• 使用するコーディングツール。 インストールし、ご自身のアカウントでサインインしてください。SynaBun にモデルへのアクセスは含まれていません。
• 任意：C/C++ ビルドツール。 ターミナルはネイティブモジュールを使用します。お使いのシステム用のビルド済みバイナリがない場合は、インストール時にコンパイルされます。コンパイルに失敗しても、ターミナル以外の機能はすべて動作します。
• 任意：Discord、YouTube、AI による判断などのインテグレーション用認証情報。 機能を有効にする際に、設定で入力します。

更新

npm install -g synabun@latest
npm --prefix "$(npm root -g)/synabun/mcp-server" run setup:embeddings

SynaBun では、アプリ内から新しいバージョンに更新することもできます。どちらの場合も、更新のたびに2つ目のコマンドを実行してください。検索モデルはインストール済みのパッケージ内にあり、更新によって置き換えられます。リコール時に Local embeddings unavailable; keyword retrieval used. と表示された場合は、これで解決できます。

2026.x からの移行ですか？ npm i -g synabun@latest を手動で一度実行してください。以前はバージョンに日付（2026.9.5）を使っていましたが、現在は通常のセマンティックバージョニング（2.0.0）を使用しています。そのため、古いインストールのアプリ内更新チェックでは 2.0.0 が提示されません。2.0.0 以降は、従来どおりアプリ内アップデーターを利用できます。

ソースから実行していますか？ git pull --ff-only を実行し、続けて npm run mcp:build と npm start を実行してください。

新しいバージョンが初めて起動する前に、SynaBun はデータの検証済みスナップショットを作成し、データフォルダー内の backups/updates に保存します。スナップショットを作成できない場合は、起動せずに停止します。

データとプライバシー

SynaBun が保存するデータはすべて、アプリの外にある1つのフォルダーに保存されます。macOS と Linux では ~/.synabun、Windows では %APPDATA%\synabun です。別の場所を使うには、SYNABUN_DATA_HOME を設定してください。

~/.synabun/
├── .env                 # settings and credentials for integrations
├── data/                # interface state, schedules, logs
├── backups/             # backups and pre-update snapshots
└── mcp-data/memory.db   # your memories

• メモリはお使いのマシン内に保存されます。 データベースはローカルファイルで、検索モデルもローカルで動作します。
• 外部に送信されるデータ。 AI ツールは、プロンプトと、リコールしたメモリを、それぞれのプロバイダーに送信します。オプション機能（AI による判断、WhatsApp、Discord、ブラウザー）は、設定後にそれぞれのサービスと通信します。SynaBun は npm と GitHub で新しいバージョンを確認し、インターフェースは公開 CDN からウェブフォントと1つのスクリプトを読み込みます。
• 信頼できるネットワークでご利用ください。 Neural Interface にはログイン機能がなく、すべてのネットワークインターフェースでリッスンします。ポート 3344 をインターネットに公開しないでください。セキュリティモデルの詳細は SECURITY.md をご覧ください。
• アプリからバックアップしてください。 SynaBun の実行中に memory.db を手動でコピーすると、直近の書き込みが反映されない場合があります。

リンク

• 変更履歴：2.1.0 以前の新機能
• セキュリティ：セキュリティモデルと脆弱性の報告方法
• コントリビューション：バグ報告や機能リクエストは issue として歓迎します。プルリクエストは受け付けていません
• ウェブサイト、ドキュメント、ブログ
• コミュニティ：Discord と X

ライセンス

Apache License, Version 2.0 の下でライセンスされています。

Apache 2.0 の下で、SynaBun を自由に使用、変更、配布できます。プレミアム機能やエンタープライズ向け拡張機能は、別途商用ライセンスで提供される場合があります。詳細は LICENSE-COMMERCIAL.md をご覧ください。サードパーティに関する通知は NOTICE と THIRD-PARTY-LICENSES.md に記載されています。

商標に関する通知

「SynaBun」は、その著作者の商標です。このライセンスは、SynaBun の名称、商標、サービスマーク、またはブランド表示の使用を許可するものではありません。このプロジェクトをフォークする場合、派生物には別の名称を使用する必要があります。

パッケージの検証：ダウンロード可能な VirusTotal レポートと SHA-256 ハッシュ。お使いのバージョンとファイルのハッシュに一致するレポートをご確認ください。レポートには、対象エンジンと分析日が記録されていますが、安全性を保証するものではありません。ウェブサイトの判定結果は URL の評判を示すもので、脆弱性監査ではありません。