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: 允许用户指定挂载点内的哪些目录或文件会被内存 pipeline 流程进行语义索引。