tursodatabase/agentfs

What it solves

AgentFS 提供一套专门为 AI 代理管理状态、文件与历史的存储系统。它通过记录每一次操作、维护持久化文件系统，并确保代理环境可携且可重现，解决了传统文件系统或容器在代理状态管理上常见的困难。

How it works

AgentFS 使用基于 SQLite 的存储系统（由 Turso 提供支持）将代理的所有操作存放于单一数据库文件中。它提供三种主要接口：

• Filesystem：类 POSIX 系统，用于管理文件和目录。
• Key-Value Store：用于保存代理的状态与上下文。
• Toolcall Audit Trail：记录代理调用的每个工具，以供调试与分析。

用户可以通过 SDK（TypeScript、Python、Rust）或 CLI 与 AgentFS 交互，CLI 允许使用 FUSE（Linux）或 NFS（macOS）挂载文件系统。

Who it’s for

此工具针对需要结构化状态管理、调试审计以及在隔离环境中安全运行代理的开发者设计。

Highlights

• Auditability：每一次文件操作与工具调用皆以 SQL 记录，使代理的历史可查询。
• Reproducibility：代理状态可快照与恢复，以重现精确的执行状态或回滚错误。
• Portability：整个运行时（包括文件与历史）都封装在单一 SQLite 文件中。
• Isolation：提供文件系统层级的写时复制隔离，安全运行不受信任的代理。