¿Qué es AgentFS?
AgentFS guarda todo lo que toca un agente en una sola base de datos SQLite construida sobre Turso, el motor compatible con SQLite de la empresa. Dentro de ese archivo hay tres cosas: un sistema de archivos de estilo POSIX almacenado como tablas de inodos y entradas de directorio, un almacén clave-valor para el estado y un registro de solo anexado de las llamadas a herramientas. Como es un único archivo, una instantánea es una simple copia de la base de datos, y el historial del agente se consulta con SQL en lugar de reconstruirse a partir de logs.
El proyecto incluye SDK para TypeScript, Python, Rust y Go, y una CLI que monta la base de datos como un sistema de archivos real (FUSE en Linux, NFS en macOS), ejecuta un programa en un sandbox de copia en escritura con `agentfs run`, muestra el historial de llamadas con `agentfs timeline` y sirve los archivos y el almacén clave-valor por MCP o NFS. La sincronización opcional envía la base de datos a Turso Cloud; el cifrado local en reposo es la alternativa, y no se pueden combinar.
¿Merece la pena AgentFS?
Lo útil de AgentFS es el archivo único. Los archivos de trabajo del agente, su estado clave-valor y el registro de cada herramienta que llamó acaban en una sola base de datos SQLite, así que deshacer una ejecución fallida es copiar de vuelta una instantánea anterior, y averiguar qué salió mal es una consulta SQL y no una búsqueda entre logs. Pekka Enberg y Glauber Costa, de Turso, lo anunciaron el 13 de noviembre de 2025, y el repositorio tiene unas 3.500 estrellas en GitHub.
La CLI hace más de lo que sugiere el SDK por sí solo. `agentfs run` arranca un shell o un agente de programación sobre una capa de copia en escritura de tu proyecto: las escrituras van a la base de datos y los archivos originales no se tocan, con user namespaces en Linux y el sandbox de Apple en macOS. `agentfs mount` expone la base de datos como un directorio normal para que herramientas como git y grep funcionen sin cambios. El README reconoce con franqueza que los git worktrees solo separan a los agentes por convención, mientras que la capa se impone por debajo del agente. El paquete de npm registró 23.397 descargas en la semana hasta el 12 de noviembre de 2026.
Por defecto guarda los datos en local, en .agentfs/<id>.db dentro del proyecto. `agentfs serve nfs` escucha en 127.0.0.1, puerto 11111, salvo que lo enlaces a otra dirección, y cualquiera que llegue a ese puerto puede montar los archivos. El cifrado local admite AES-256-GCM y cifrados AEGIS con una clave hexadecimal que gestionas tú; activar la sincronización con Turso Cloud descarta el cifrado.
La pega: la madurez. La versión 0.6.0 del 5 de febrero de 2026 fue la primera beta, el README todavía desaconseja confiarle datos de producción sin copias de seguridad, y la última versión, v0.6.4, salió el 25 de marzo. El último commit en la rama principal, del 3 de junio, fue una corrección de lint, y el tracker muestra 59 issues abiertas y 18 pull requests abiertas. Los cambios de esquema requieren `agentfs migrate`, y el sandbox más estricto basado en ptrace está marcado como experimental y solo para Linux.
Nuestra opinión: para quien construye infraestructura de agentes y quiere deshacer y una pista de auditoría sin escribirlas desde cero, AgentFS es el diseño más limpio que hay; para un solo agente de programación en tu portátil, git y un contenedor ya cubren casi todo.
Dónde se gana su sitio
Un ingeniero de una empresa que ejecuta agentes de programación sobre repositorios de clientes
Dejar que un agente cambie archivos libremente y descartar los cambios si la ejecución sale mal
Arranca el agente con `agentfs run` para que sus escrituras caigan en una base de datos de capa; después conserva o descarta ese archivo. El software es gratis; el coste es el riesgo de la beta y el tiempo de integrarlo en tu runner.
Un equipo de plataforma que debe enseñar a los auditores lo que hizo un agente
Responder qué archivos escribió un agente y qué herramientas llamó, y en qué orden
Registra las llamadas a herramientas con el SDK y consulta con SQL el registro de solo anexado y las tablas de archivos, o lee `agentfs timeline`. Archivar la base de datos de cada ejecución mantiene las pruebas en un solo sitio.
Un desarrollador que construye un agente en serverless o en el navegador
Dar al agente un sistema de archivos donde no se puede montar ningún disco
Abre una base de datos AgentFS con el SDK de TypeScript, que el proyecto también muestra en Cloudflare Durable Objects y en WebAssembly. La sincronización opcional con Turso Cloud lleva el estado de una máquina a otra.
Antes de decidirte
- Puesta en marcha
- Instala la CLI con el instalador curl de la página de versiones; luego `agentfs init my-agent` crea .agentfs/my-agent.db. Los SDK se instalan con `npm install agentfs-sdk`, pip o cargo.
- Integraciones
- Ejemplos para Mastra, Claude Agent SDK, OpenAI Agents SDK, Vercel AI SDK con just-bash, Cloudflare Workers y Firecracker; servidores MCP y NFS integrados en la CLI.
- Datos y privacidad
- Todo queda en un archivo SQLite local salvo que configures la sincronización con Turso Cloud. El cifrado local en reposo usa una clave que aportas tú; el servidor NFS se enlaza a 127.0.0.1 por defecto y, si se enlaza a otra dirección, expone los archivos a cualquiera que llegue al puerto.
- Coste a escala
- El software es gratis. La sincronización con Turso Cloud es una factura aparte de Turso; el almacenamiento crece con cada versión de archivo y llamada a herramienta guardada en la base de datos.
- Límites
- Beta; las actualizaciones de esquema requieren `agentfs migrate`; solo FUSE en Linux y NFS en macOS; el sandbox ptrace es experimental y solo para Linux; cifrado y sincronización se excluyen mutuamente.
Lo bueno
- Archivos, estado clave-valor y llamadas a herramientas en un único archivo SQLite que se consulta con SQL
- Las instantáneas y la vuelta atrás son una copia de archivo
- El sandbox de copia en escritura deja intacto el proyecto real en Linux y macOS
- SDK para TypeScript, Python, Rust y Go, además de servidores MCP y NFS
Lo malo
- Software en beta; el README desaconseja usar datos de producción sin copias de seguridad
- Ninguna versión desde la v0.6.4 del 25 de marzo de 2026
- El cifrado en reposo y la sincronización con Turso Cloud no se pueden usar a la vez
- No hay archivo de licencia en la raíz del repositorio, solo una licencia declarada en el README y en los metadatos de los paquetes
Ideal para
Equipos que construyen plataformas de agentes o sandboxes y quieren guardar cada ejecución como una base de datos que se puede inspeccionar y copiar.
Alternativas a AgentFS
AgentFS: preguntas frecuentes
- ¿Merece la pena AgentFS?
- AgentFS convierte los archivos, el estado y el historial de herramientas de un agente en un único archivo SQLite que puedes consultar y copiar: una idea limpia que sigue etiquetada como beta y que ha bajado el ritmo desde la primavera. Le damos un 3.7 sobre 5.
- ¿Cuánto cuesta AgentFS?
- Gratis y de código abierto (MIT, según el README y los metadatos de los paquetes). La sincronización opcional va a Turso Cloud, que Turso factura aparte.
- ¿Qué inconvenientes tiene AgentFS?
- Software en beta; el README desaconseja usar datos de producción sin copias de seguridad; ninguna versión desde la v0.6.4 del 25 de marzo de 2026; el cifrado en reposo y la sincronización con Turso Cloud no se pueden usar a la vez; no hay archivo de licencia en la raíz del repositorio, solo una licencia declarada en el README y en los metadatos de los paquetes.
- ¿Para quién es AgentFS?
- Equipos que construyen plataformas de agentes o sandboxes y quieren guardar cada ejecución como una base de datos que se puede inspeccionar y copiar.
- ¿Cuánto cuesta AgentFS para un equipo o en producción?
- El software es gratis. La sincronización con Turso Cloud es una factura aparte de Turso; el almacenamiento crece con cada versión de archivo y llamada a herramienta guardada en la base de datos.
- ¿Es AgentFS seguro para los datos de la empresa?
- Todo queda en un archivo SQLite local salvo que configures la sincronización con Turso Cloud. El cifrado local en reposo usa una clave que aportas tú; el servidor NFS se enlaza a 127.0.0.1 por defecto y, si se enlaza a otra dirección, expone los archivos a cualquiera que llegue al puerto.
- ¿Cuáles son las mejores alternativas a AgentFS?
- Las alternativas más cercanas que hemos analizado son OpenSandbox, Anthropic Sandbox Runtime (srt) y Beads.
Respuestas comprobadas el 13 nov 2026.