Was ist AgentFS?
AgentFS legt alles, was ein Agent anfasst, in einer einzigen SQLite-Datenbank ab, gebaut auf Turso, der SQLite-kompatiblen Engine des Unternehmens. In dieser einen Datei stecken drei Dinge: ein Dateisystem im POSIX-Stil, gespeichert als Inode- und Verzeichniseintrag-Tabellen, ein Key-Value-Speicher für den Zustand und ein nur anhängbares Protokoll der Tool-Aufrufe. Weil es eine Datei ist, ist ein Snapshot einfach eine Kopie der Datenbank, und den Verlauf des Agenten fragst du mit SQL ab, statt ihn aus Logs zu rekonstruieren.
Das Projekt bringt SDKs für TypeScript, Python, Rust und Go mit und eine CLI, die die Datenbank als echtes Dateisystem mountet (FUSE unter Linux, NFS unter macOS), mit `agentfs run` ein Programm in einer Copy-on-Write-Sandbox startet, mit `agentfs timeline` den Verlauf der Tool-Aufrufe ausgibt und die Dateien und den Key-Value-Speicher über MCP oder NFS bereitstellt. Eine optionale Synchronisierung schiebt die Datenbank zu Turso Cloud; die Alternative ist lokale Verschlüsselung im Ruhezustand, beides lässt sich nicht kombinieren.
Lohnt sich AgentFS?
Der Nutzen von AgentFS liegt in der einen Datei. Die Arbeitsdateien eines Agenten, sein Key-Value-Zustand und ein Protokoll jedes aufgerufenen Tools landen in einer SQLite-Datenbank. Einen missglückten Lauf zurückzurollen heißt, einen früheren Snapshot zurückzukopieren, und herauszufinden, was schiefging, ist eine SQL-Abfrage statt einer Suche in Logs. Pekka Enberg und Glauber Costa von Turso haben es am 13. November 2025 angekündigt, das Repository hat rund 3.500 GitHub-Sterne.
Die CLI kann mehr, als das SDK allein vermuten lässt. `agentfs run` startet eine Shell oder einen Coding-Agenten über einem Copy-on-Write-Overlay deines Projekts: Schreibzugriffe gehen in die Datenbank, die Originaldateien bleiben unberührt, unter Linux mit User Namespaces, unter macOS mit Apples Sandbox. `agentfs mount` stellt die Datenbank als gewöhnliches Verzeichnis bereit, sodass Tools wie git und grep unverändert funktionieren. Das README sagt offen, dass git worktrees Agenten nur per Konvention trennen, während das Overlay unterhalb des Agenten durchgesetzt wird. Das npm-Paket verzeichnete 23.397 Downloads in der Woche bis zum 12. November 2026.
Standardmäßig bleiben die Daten lokal, in .agentfs/<id>.db im Projekt. `agentfs serve nfs` lauscht auf 127.0.0.1, Port 11111, sofern du es nicht an eine andere Adresse bindest, und wer diesen Port erreicht, kann die Dateien mounten. Die lokale Verschlüsselung unterstützt AES-256-GCM und AEGIS-Verfahren mit einem Hex-Schlüssel, den du selbst verwaltest; wer die Turso-Cloud-Synchronisierung einschaltet, verzichtet auf Verschlüsselung.
Der Haken: die Reife. Version 0.6.0 vom 5. Februar 2026 war die erste Beta, das README rät weiterhin davon ab, ihm Produktionsdaten ohne Backups anzuvertrauen, und das letzte Release, v0.6.4, erschien am 25. März. Der letzte Commit auf dem Hauptzweig vom 3. Juni war ein Lint-Fix, der Tracker zeigt 59 offene Issues und 18 offene Pull Requests. Schemaänderungen brauchen `agentfs migrate`, und die strengere ptrace-basierte Sandbox ist als experimentell markiert und läuft nur unter Linux.
Unser Fazit: Für alle, die Agenten-Infrastruktur bauen und Rückgängig-Machen und einen Audit-Trail wollen, ohne beides selbst zu schreiben, ist AgentFS das sauberste Design, das es gibt; für einen einzelnen Coding-Agenten auf dem Laptop decken git und ein Container das meiste schon ab.
Wo es sich lohnt
Ein Engineer in einem Unternehmen, das Coding-Agenten auf Kunden-Repositorys laufen lässt
Einen Agenten Dateien frei ändern lassen und die Änderungen verwerfen, wenn der Lauf schiefgeht
Starte den Agenten mit `agentfs run`, damit seine Schreibzugriffe in einer Overlay-Datenbank landen; danach behältst oder verwirfst du diese Datei. Die Software ist kostenlos; die Kosten sind das Beta-Risiko und die Zeit für die Anbindung an deinen Runner.
Ein Plattform-Team, das Prüfern zeigen muss, was ein Agent getan hat
Beantworten, welche Dateien ein Agent geschrieben und welche Tools er in welcher Reihenfolge aufgerufen hat
Erfasse Tool-Aufrufe über das SDK und frage das nur anhängbare Protokoll und die Dateitabellen mit SQL ab oder lies `agentfs timeline`. Wer die Datenbankdatei pro Lauf archiviert, hat die Belege an einem Ort.
Ein Entwickler, der einen Agenten auf Serverless oder im Browser baut
Dem Agenten ein Dateisystem geben, wo sich keine Festplatte mounten lässt
Öffne eine AgentFS-Datenbank über das TypeScript-SDK, das das Projekt auch auf Cloudflare Durable Objects und in WebAssembly zeigt. Die optionale Synchronisierung mit Turso Cloud trägt den Zustand zwischen Maschinen.
Bevor du dich festlegst
- Einrichtung
- Installiere die CLI mit dem curl-Installer von der Release-Seite, dann legt `agentfs init my-agent` die Datei .agentfs/my-agent.db an; die SDKs installierst du mit `npm install agentfs-sdk`, pip oder cargo.
- Integrationen
- Beispiele für Mastra, Claude Agent SDK, OpenAI Agents SDK, Vercel AI SDK mit just-bash, Cloudflare Workers und Firecracker; MCP- und NFS-Server sind in die CLI eingebaut.
- Daten und Datenschutz
- Alles bleibt in einer lokalen SQLite-Datei, solange du keine Turso-Cloud-Synchronisierung einrichtest. Die lokale Verschlüsselung nutzt einen Schlüssel, den du lieferst; der NFS-Server bindet standardmäßig an 127.0.0.1 und gibt die Dateien bei anderer Bindung jedem frei, der den Port erreicht.
- Kosten im großen Maßstab
- Die Software ist kostenlos. Die Turso-Cloud-Synchronisierung ist eine eigene Turso-Rechnung; der Speicher wächst mit jeder Dateiversion und jedem Tool-Aufruf in der Datenbank.
- Grenzen
- Beta; Schema-Upgrades brauchen `agentfs migrate`; nur FUSE unter Linux und NFS unter macOS; die ptrace-Sandbox ist experimentell und nur für Linux; Verschlüsselung und Synchronisierung schließen sich gegenseitig aus.
Was gut ist
- Dateien, Key-Value-Zustand und Tool-Aufrufe in einer SQLite-Datei, abfragbar mit SQL
- Snapshots und Rollback sind eine Dateikopie
- Die Copy-on-Write-Sandbox lässt das echte Projekt unter Linux und macOS unberührt
- SDKs für TypeScript, Python, Rust und Go, dazu MCP- und NFS-Server
Was nicht
- Beta-Software; das README rät von Produktionsdaten ohne Backups ab
- Kein Release seit v0.6.4 vom 25. März 2026
- Verschlüsselung im Ruhezustand und Turso-Cloud-Synchronisierung schließen sich aus
- Keine Lizenzdatei im Wurzelverzeichnis des Repositorys, nur eine im README und in den Paket-Metadaten angegebene Lizenz
Am besten für
Teams, die Agenten-Plattformen oder Sandboxes bauen und jeden Agentenlauf als eine prüfbare, kopierbare Datenbank speichern wollen.
Alternativen zu AgentFS
AgentFS: häufige Fragen
- Lohnt sich AgentFS?
- AgentFS macht aus den Dateien, dem Zustand und dem Tool-Verlauf eines Agenten eine einzige SQLite-Datei, die du abfragen und kopieren kannst: eine saubere Idee, die noch als Beta gilt und seit dem Frühjahr ruhig geworden ist. Wir bewerten es mit 3.7 von 5.
- Was kostet AgentFS?
- Kostenlos und Open Source (MIT, laut README und Paket-Metadaten). Die optionale Synchronisierung läuft über Turso Cloud, das Turso separat abrechnet.
- Welche Nachteile hat AgentFS?
- Beta-Software; das README rät von Produktionsdaten ohne Backups ab; Kein Release seit v0.6.4 vom 25. März 2026; Verschlüsselung im Ruhezustand und Turso-Cloud-Synchronisierung schließen sich aus; Keine Lizenzdatei im Wurzelverzeichnis des Repositorys, nur eine im README und in den Paket-Metadaten angegebene Lizenz.
- Für wen eignet sich AgentFS?
- Teams, die Agenten-Plattformen oder Sandboxes bauen und jeden Agentenlauf als eine prüfbare, kopierbare Datenbank speichern wollen.
- Was kostet AgentFS für ein Team oder im Produktivbetrieb?
- Die Software ist kostenlos. Die Turso-Cloud-Synchronisierung ist eine eigene Turso-Rechnung; der Speicher wächst mit jeder Dateiversion und jedem Tool-Aufruf in der Datenbank.
- Ist AgentFS sicher für Firmendaten?
- Alles bleibt in einer lokalen SQLite-Datei, solange du keine Turso-Cloud-Synchronisierung einrichtest. Die lokale Verschlüsselung nutzt einen Schlüssel, den du lieferst; der NFS-Server bindet standardmäßig an 127.0.0.1 und gibt die Dateien bei anderer Bindung jedem frei, der den Port erreicht.
- Was sind die besten Alternativen zu AgentFS?
- Die nächsten Alternativen, die wir getestet haben, sind OpenSandbox, Anthropic Sandbox Runtime (srt) und Beads.
Antworten geprüft am 13. Nov. 2026.