December 2025 Summaries

AgentFS introduces a filesystem abstraction tailored for agents, emphasizing auditability, reproducibility, and portability, achieved through a copy-on-write overlay filesystem. This system allows users to isolate agent activities by creating a SQLite-backed filesystem that interacts with the host filesystem without altering it, using an SDK compatible with TypeScript, Python, and Rust. The agentfs run command facilitates this process by mounting the host filesystem to a sandbox environment, where file modifications by agents are isolated to a writable delta layer, preserving the integrity of the host system. On Linux, this is implemented using FUSE and namespaces, while macOS employs NFS and sandbox-exec for similar functionality, ensuring agents can operate without affecting host files. This approach allows agents to work on shared source code while maintaining separate environments, supporting a seamless development workflow without compromising system stability.

AgentFS introduces a virtualized filesystem for browser-based agents, addressing their inability to leverage traditional command-line tools like mkdir or git, which are central to their training data. Built on a SQLite foundation with Turso's Rust-based rewrite and utilizing a WASM build, AgentFS enables agents to operate within the browser without server infrastructure. It supports both in-memory and persistent storage through the Origin Private File System (OPFS) and allows data synchronization across devices using Turso Cloud. This approach maintains the Unix-inspired "everything is a file" philosophy, facilitating familiar file-based workflows in a secure, isolated, and auditable manner. An example of its utility is demonstrated by implementing Git functionality in the browser, offering seamless integration with popular libraries like isomorphic-git.

AgentFS introduces a novel abstraction for managing agent states by leveraging SQLite to form a unified filesystem for AI agents, compatible with TypeScript and Rust SDKs and soon Python. It allows developers to integrate AgentFS into various projects and offers a standardized SQLite schema with an SDK, enabling seamless integration with existing systems. By utilizing the Filesystem in Userspace (FUSE) interface, AgentFS can be mounted as a POSIX filesystem, granting agents compatibility with a wide range of Unix tools without the need for integration effort. This setup provides real-time observability, allowing developers to monitor agent activities and debug with familiar Unix commands like ls, cat, and tail. The FUSE support in AgentFS bridges the gap between the SQLite-backed filesystem's portability and queryability and the native filesystem-centric tools, making it ideal for coding agents and ensuring agent state remains auditable and portable.