Qu’est-ce que AgentFS ?
AgentFS range tout ce qu'un agent touche dans une seule base SQLite construite sur Turso, le moteur compatible SQLite de l'entreprise. Ce fichier contient trois choses : un système de fichiers de type POSIX stocké sous forme de tables d'inodes et d'entrées de répertoire, un magasin clé-valeur pour l'état, et un journal en ajout seul des appels d'outils. Comme tout tient dans un fichier, un instantané est une simple copie de la base, et l'historique de l'agent s'interroge en SQL au lieu d'être reconstitué à partir des logs.
Le projet fournit des SDK pour TypeScript, Python, Rust et Go, et une CLI qui monte la base comme un vrai système de fichiers (FUSE sous Linux, NFS sous macOS), lance un programme dans un bac à sable en copie sur écriture avec `agentfs run`, affiche l'historique des appels avec `agentfs timeline` et sert les fichiers et le magasin clé-valeur via MCP ou NFS. Une synchronisation facultative envoie la base vers Turso Cloud ; le chiffrement local au repos est l'autre option, et les deux ne se combinent pas.
AgentFS vaut-il le coup ?
L'intérêt d'AgentFS tient au fichier unique. Les fichiers de travail d'un agent, son état clé-valeur et la trace de chaque outil appelé aboutissent dans une seule base SQLite : annuler une exécution ratée revient à recopier un instantané antérieur, et comprendre ce qui a mal tourné est une requête SQL plutôt qu'une fouille dans les logs. Pekka Enberg et Glauber Costa, de Turso, l'ont annoncé le 13 novembre 2025, et le dépôt compte environ 3 500 étoiles sur GitHub.
La CLI va plus loin que le SDK seul. `agentfs run` lance un shell ou un agent de code au-dessus d'une couche en copie sur écriture de votre projet : les écritures vont dans la base et les fichiers d'origine restent intacts, avec les user namespaces sous Linux et le bac à sable d'Apple sous macOS. `agentfs mount` expose la base comme un répertoire ordinaire, si bien que des outils comme git et grep fonctionnent sans changement. Le README reconnaît franchement que les git worktrees ne séparent les agents que par convention, alors que la couche est imposée sous l'agent. Le paquet npm a enregistré 23 397 téléchargements la semaine précédant le 12 novembre 2026.
Par défaut, les données restent en local, dans .agentfs/<id>.db du projet. `agentfs serve nfs` écoute sur 127.0.0.1, port 11111, sauf si vous le liez ailleurs, et quiconque atteint ce port peut monter les fichiers. Le chiffrement local prend en charge AES-256-GCM et les algorithmes AEGIS avec une clé hexadécimale que vous gérez ; activer la synchronisation Turso Cloud exclut le chiffrement.
Le hic : la maturité. La version 0.6.0 du 5 février 2026 était la première bêta, le README déconseille toujours de lui confier des données de production sans sauvegardes, et la dernière version, v0.6.4, date du 25 mars. Le dernier commit sur la branche principale, le 3 juin, corrigeait le lint, et le suivi affiche 59 issues ouvertes et 18 pull requests ouvertes. Les changements de schéma exigent `agentfs migrate`, et le bac à sable plus strict fondé sur ptrace est marqué expérimental et réservé à Linux.
Notre avis : pour qui construit une infrastructure d'agents et veut l'annulation et une piste d'audit sans les écrire soi-même, AgentFS est la conception la plus propre du moment ; pour un seul agent de code sur votre portable, git et un conteneur couvrent déjà l'essentiel.
Là où il fait la différence
Un ingénieur dans une entreprise qui fait tourner des agents de code sur les dépôts de ses clients
Laisser un agent modifier librement des fichiers et jeter les changements si l'exécution tourne mal
Lancez l'agent avec `agentfs run` pour que ses écritures aillent dans une base de couche ; gardez ou jetez ce fichier ensuite. Le logiciel est gratuit ; le coût, c'est le risque de la bêta et le temps de l'intégrer à votre runner.
Une équipe plateforme qui doit montrer aux auditeurs ce qu'a fait un agent
Dire quels fichiers un agent a écrits et quels outils il a appelés, dans quel ordre
Enregistrez les appels d'outils via le SDK et interrogez en SQL le journal en ajout seul et les tables de fichiers, ou lisez `agentfs timeline`. Archiver la base de chaque exécution garde les preuves au même endroit.
Un développeur qui construit un agent en serverless ou dans le navigateur
Donner à l'agent un système de fichiers là où aucun disque ne peut être monté
Ouvrez une base AgentFS avec le SDK TypeScript, que le projet montre aussi sur Cloudflare Durable Objects et en WebAssembly. La synchronisation facultative avec Turso Cloud transporte l'état d'une machine à l'autre.
Avant de vous engager
- Mise en route
- Installez la CLI avec l'installeur curl de la page des versions, puis `agentfs init my-agent` crée .agentfs/my-agent.db ; les SDK s'installent avec `npm install agentfs-sdk`, pip ou cargo.
- Intégrations
- Exemples pour Mastra, Claude Agent SDK, OpenAI Agents SDK, Vercel AI SDK avec just-bash, Cloudflare Workers et Firecracker ; serveurs MCP et NFS intégrés à la CLI.
- Données et confidentialité
- Tout reste dans un fichier SQLite local sauf si vous configurez la synchronisation Turso Cloud. Le chiffrement local au repos utilise une clé que vous fournissez ; le serveur NFS se lie à 127.0.0.1 par défaut et, lié ailleurs, expose les fichiers à quiconque atteint le port.
- Coût à grande échelle
- Le logiciel est gratuit. La synchronisation Turso Cloud est une facture Turso distincte ; le stockage grossit avec chaque version de fichier et chaque appel d'outil conservés dans la base.
- Limites
- Bêta ; les mises à niveau de schéma exigent `agentfs migrate` ; FUSE sous Linux et NFS sous macOS uniquement ; le bac à sable ptrace est expérimental et réservé à Linux ; chiffrement et synchronisation s'excluent.
Les points forts
- Fichiers, état clé-valeur et appels d'outils dans un seul fichier SQLite interrogeable en SQL
- Instantanés et retour arrière se résument à une copie de fichier
- Le bac à sable en copie sur écriture laisse le vrai projet intact sous Linux et macOS
- SDK pour TypeScript, Python, Rust et Go, plus des serveurs MCP et NFS
Les points faibles
- Logiciel en bêta ; le README déconseille les données de production sans sauvegardes
- Aucune version depuis la v0.6.4 du 25 mars 2026
- Le chiffrement au repos et la synchronisation Turso Cloud ne peuvent pas être utilisés ensemble
- Pas de fichier de licence à la racine du dépôt, seulement une licence déclarée dans le README et les métadonnées des paquets
Idéal pour
Les équipes qui construisent des plateformes d'agents ou des bacs à sable et veulent stocker chaque exécution comme une base inspectable et copiable.
Alternatives à AgentFS
AgentFS : questions fréquentes
- AgentFS vaut-il le coup ?
- AgentFS transforme les fichiers, l'état et l'historique d'outils d'un agent en un seul fichier SQLite que vous pouvez interroger et copier, une idée nette qui reste étiquetée bêta et s'est faite discrète depuis le printemps. Nous lui donnons 3.7 sur 5.
- Combien coûte AgentFS ?
- Gratuit et open source (MIT, selon le README et les métadonnées des paquets). La synchronisation facultative passe par Turso Cloud, facturé à part par Turso.
- Quels sont les inconvénients de AgentFS ?
- Logiciel en bêta ; le README déconseille les données de production sans sauvegardes; aucune version depuis la v0.6.4 du 25 mars 2026; le chiffrement au repos et la synchronisation Turso Cloud ne peuvent pas être utilisés ensemble; pas de fichier de licence à la racine du dépôt, seulement une licence déclarée dans le README et les métadonnées des paquets.
- À qui s’adresse AgentFS ?
- Les équipes qui construisent des plateformes d'agents ou des bacs à sable et veulent stocker chaque exécution comme une base inspectable et copiable.
- Combien coûte AgentFS pour une équipe ou en production ?
- Le logiciel est gratuit. La synchronisation Turso Cloud est une facture Turso distincte ; le stockage grossit avec chaque version de fichier et chaque appel d'outil conservés dans la base.
- AgentFS est-il sûr pour les données de l’entreprise ?
- Tout reste dans un fichier SQLite local sauf si vous configurez la synchronisation Turso Cloud. Le chiffrement local au repos utilise une clé que vous fournissez ; le serveur NFS se lie à 127.0.0.1 par défaut et, lié ailleurs, expose les fichiers à quiconque atteint le port.
- Quelles sont les meilleures alternatives à AgentFS ?
- Les alternatives les plus proches que nous avons testées sont OpenSandbox, Anthropic Sandbox Runtime (srt) et Beads.
Réponses vérifiées le 13 nov. 2026.