Memory Ferry

Memory Ferry · 记忆摆渡 は、AIエージェント向けのローカルファーストでクロスデバイス対応の長期記憶・再利用可能なスキルレイヤーです。通常のVaultフォルダをiCloud Drive、OneDrive、Dropbox、Syncthing、またはマウントしたNASに置き、Codex、Claude Code、Cursor、OpenCode、DeepSeek Harness、Gemini CLI、GitHub Copilot CLI、MiniMax Codeを同じメモリに接続できます。

中国語説明 · 英語ユーザーガイド · 中国語ユーザーマニュアル

バージョン 0.6.0-beta.1 はエンドツーエンド暗号化を提供しません。パスワード、APIキー、トークン、秘密鍵、リカバリコード、その他の機密情報を保存しないでください。

存在する理由

• クロスコンピュータ: ホスト型コントロールプレーンやデータベースデーモンなしで通常のファイルを同期します。

• クロスエージェント: メモリをモデルベンダーに固定せず、単一のMCPおよびCLI契約を公開します。

• オフラインフレンドリー: 各書き込みは独立した不変のJSONイベントであり、後で同期されます。

• 競合耐性: 同時追加が互いに上書きすることはなく、更新は決定的に収束します。

• 再利用可能なスキル: macOSおよびWindowsで、コンテンツハッシュにより単一のVaultソースをエージェント固有のスキルディレクトリにコピーします。

• 低コスト: すでに運用しているストレージと同期ソフトウェアを再利用します。

Related MCP server: ClawMem MCP Server

対応エージェント

クイックスタート

Node.js 20以降が必要です:

npm install -g memory-ferry@beta

memory-ferry init "/path/to/your/synced/MemoryFerryVault"
memory-ferry agents install all
memory-ferry remember "Prefer concise answers" --kind preference --scope global
memory-ferry recall "answer style"
memory-ferry ui

ベータ期間中は、明示的な @beta タグを使用してください。アップグレードまたはアンインストールは次のように行います:

npm install -g memory-ferry@beta
npm uninstall -g memory-ferry

ダッシュボードはループバック専用で、ブラウザで開き、英語と中国語に対応し、複数のVaultを管理し、エージェントの接続・切断、Vaultコンテンツの安全な移行を行い、実行中は5分ごとにスキルを調整します。

Windows ポータブルアプリ

Windows x64リリースはポータブルな MemoryFerry.exe です。インストーラも個別のNode.jsインストールも不要です。EXEを恒久的なフォルダに置いてダブルクリックします。コンソールウィンドウなしで起動し、ローカルダッシュボードを開きます。コマンドライン出力が必要な場合は、同梱の MemoryFerry-CLI.cmd を使用してください。

ベータ版は商用コード署名がされていないため、Windowsに「発行元不明」の警告が表示される場合があります。同梱のSHA-256ファイルを確認し、SmartScreenを有効にしたままにしてください。

ストレージモデル

MemoryFerryVault/
├── memory-ferry.json
├── memory/events/<device-id>/<date>/<event-id>.json
└── skills/<skill-name>/...

デバイスID、クロック、イベントキャッシュ、オプションのOllama埋め込みインデックスは、同期フォルダの外部に保持されます。VaultにはライブのSQLiteデータベース、WAL、ロックファイルは含まれません。

アップグレード互換性

Memory Ferryは既存のAgent Vault Syncインストールを認識します:

• agent-vault.json が受け入れられ、古いファイルを削除せずに新しい memory-ferry.json コンパニオンマニフェストが作成されます。

• 新しい状態が存在しない場合、~/.agent-vault-sync の状態は ~/.memory-ferry に移行されます。

• AGENT_VAULT_* 環境変数は、対応する MEMORY_FERRY_* のフォールバックとして残ります。

• エージェントを再接続すると、古い管理対象の agent-vault エントリが削除され、memory-ferry が書き込まれます。

• レガシーの agent-vault CLIエイリアスは、ベータ移行期間中も利用可能です。

重要なVaultはアップグレード前にバックアップし、別のコンピュータで同じVaultを開く前に、同期クライアントが完了するのを待ってください。

オプションのセマンティックリコール

ローカルのOllamaが利用可能な場合、recall と context はセマンティック類似度とUnicode/CJKテキストスコアリングをブレンドします。MEMORY_FERRY_EMBED=off を設定するか、--no-semantic を渡すと、テキストのみの検索を使用します。埋め込みインデックスはローカルに保持され、クラウド同期または移行後、最初のクエリが返される前に修復されます。

開発

npm ci
npm run test:all
npm audit --omit=dev
npm pack --dry-run

WindowsリリースはGitHub Actionsでビルドおよびスモークテストされます。CONTRIBUTING.md、SECURITY.md、architecture.md を参照してください。

ライセンス

MIT。スタンドアロンリリースには、Node.jsおよびサードパーティのライセンス表示も含まれます。