supermemoryai/smfs

What it solves

通常 API 経由でアクセスされる Supermemory コンテナのストレージを、ローカルファイルシステムとして公開します。これにより、ユーザーや AI エージェントが、カスタム API 集成コードを記述することなく、標準 Unix ツール（ls, cat, grep など）やエディタを使用してメモリデータと対話可能になります。

How it works

このプロジェクトは、主に 2 つのアクセス方法を提供します：

1. Filesystem Mount: カーネルを持つ環境（macOS, Linux, Docker）では、FUSE または NFS を使用して Supermemory コンテナを実際のローカルディレクトリとしてマウントします。変更は双方向で同期されます：ローカルでの書き込みはクラウドへアップロードされ、リモートの変更は 30 秒ごとにプルされます。
2. Virtual Bash Tool: ローカルファイルシステムを持たないサーバーレスやエッジ環境（Cloudflare Workers, ブラウザエージェント）向けに、bash 環境をシミュレートする TypeScript パッケージ (@supermemory/bash) を提供します。これにより、エージェントが Unix コマンドやセマンティック検索を実行可能になります。

さらに、マウント内では標準の grep コマンドを上書きするシェルラップ（shell wrapper）が含まれており、標準的な文字列一致ングではなく、Supermemory のインデックスを使用してセマンティック検索を実行できます。

Who it’s for

• Developers：AI メモリコンテナをローカルフォルダのように管理したい開発者。
• AI Agent creators：エージェントに、長期的なメモリを読み書き、検索するための馴染みのある Unix-like なインターフェースを提供したい作成者。

Highlights

• Semantic Grep: マウント内で使用する場合、標準の grep コマンドをセマンティック検索ツールへと変貌させます。
• Bidirectional Sync: ローカルマウントと Supermemory クラウド間の自動バックグラウンド同期。
• Flexible Runtimes: ネイティブ OS マウントと、サーバーレス/エッジ関数用の仮想化 bash 環境の両方をサポートします。
• Configurable Memory Paths: マウント内のどのディレクトリやファイルがメモリパイプラインによってセマンティックインデックス作成が行われるかをユーザーが指定可能です。