supermemoryai/smfs

What it solves

Supermemory 容器儲存，通常透過 API 存取，現在被暴露為本地檔案系統。這讓使用者與 AI 代理程式無需撰寫自定義的 API 整合程式碼，即可利用標準 Unix 工具（如 ls, cat, 和 grep）以及編輯器來與其記憶資料進行互動。

How it works

該專案提供兩種主要的存取方式：

1. Filesystem Mount: 對於具有核心（macOS, Linux, Docker）的環境，它透過 FUSE 或 NFS 將 Supermemory 容器掛載為真實的本地目錄。變更會進行雙向同步：本地寫入會上傳至雲端，遠端變更則每 30 秒拉取一次。
2. Virtual Bash Tool: 對於缺乏本地檔案系統的無伺服器（Serverless）或邊緣運算（Edge）環境（如 Cloudflare Workers, 瀏覽器代理程式），它提供了一個 TypeScript 套件 (@supermemory/bash)，模擬 bash 環境，讓代理程式可以執行 Unix 命令與語義搜尋。

此外，它包含一個 shell wrapper，當在掛載點內使用時，會覆蓋標準的 grep 命令，改為透過 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: 允許使用者指定掛載點內的哪些目錄或檔案會被記憶體管線（memory pipeline）處理以進行語義索引。