Meta tags:
description= The filesystem for agents. Contribute to coderabbitai/agentfs development by creating an account on GitHub.;
Headings (most frequently used words):
agentfs, navigation, using, the, repository, about, files, is, why, how, footer, resources, stars, watchers, forks, menu, latest, commit, history, folders, and, what, getting, started, works, faq, learn, more, license, releases, packages, contributors, languages, cli, sdk, examples, different, from, implement, at, filesystem, layer, instead, of, containers, or, vms, blog, posts,
Text of the page (most frequently used words):
agentfs (59), agent (57), the (43), and (32), #filesystem (30), for (27), with (24), using (18), you (17), sdk (17), github (15), agents (15), hello (13), that (10), sqlite (10), code (10), files (10), can (9), repository (9), state (9), from (8), file (8), bash (7), database (7), examples (7), more (7), await (7), your (7), txt (7), security (6), just (6), cli (6), use (6), sandbox (6), this (5), readme (5), about (5), fuse (5), every (5), all (5), another (5), provides (5), run (5), what (5), tool (5), changelog (5), navigation (4), forks (4), stars (4), command (4), blog (4), specification (4), complete (4), user (4), manual (4), query (4), mount (4), source (4), system (4), isolation (4), also (4), how (4), read (4), key (4), storage (4), claude (4), const (4), install (4), cat (4), 2024 (4), signed (4), support (4), copilot (4), status (3), report (3), resources (3), execution (3), write (3), filesystems (3), motivation (3), turso (3), learn (3), stored (3), behavior (3), change (3), works (3), like (3), nfs (3), why (3), git (3), while (3), docker (3), management (3), linux (3), call (3), directory (3), single (3), snapshot (3), value (3), research (3), assistant (3), date (3), open (3), documentation (3), mnt (3), history (3), commit (3), actions (3), quality (3), tab (3), window (3), refresh (3), session (3), reload (3), sign (3), developers (3), customer (3), enterprise (3), grade (3), features (3), build (3), action (2), time (2), not (2), community (2), footer (2), watching (2), watchers (2), custom (2), properties (2), activity (2), www (2), llamaindex (2), making (2), coding (2), safe (2), browser (2), copy (2), overlays (2), overlay (2), sql (2), working (2), layer (2), block (2), because (2), everything (2), structured (2), which (2), essential (2), auditability (2), debugging (2), provide (2), environments (2), where (2), containers (2), vms (2), via (2), through (2), check (2), out (2), branches (2), into (2), directories (2), work (2), similar (2), level (2), worktrees (2), worktree (2), safely (2), version (2), could (2), inside (2), audit (2), move (2), announcement (2), post (2), based (2), creates (2), toolcall (2), analysis (2), see (2), cloudflare (2), workers (2), firecracker (2), mounted (2), openai (2), mastra (2), 1000 (2), now (2), web_search (2), output (2), operations (2), preferences (2), echo (2), macos (2), timeline (2), started (2), success (2), view (2), any (2), following (2), line (2), access (2), abstractions (2), items (2), dist (2), workspace (2), toml (2), testing (2), spec (2), gitignore (2), scripts (2), licenses (2), devcontainer (2), commands (2), last (2), message (2), name (2), 758 (2), commits (2), latest (2), menu (2), must (2), star (2), settings (2), insights (2), projects (2), coderabbitai (2), universe (2), training (2), integrations (2), stories (2), center (2), business (2), fixes (2), products (2), secret (2), perform, share, personal, information, manage, cookies, contact, docs, privacy, terms, 2026, inc, languages, contributors, packages, releases, mit, license, running, browsers, webassembly, sandboxing, mounting, behind, introducing, posts, process, compatible, technical, schema, guide, gives, capabilities, devices, first, tables, second, ahead, log, enables, snapshotting, travel, forking, capturing, third, such, serverless, there, way, device, note, approach, fine, too, remote, protocols, mechanisms, virtio, implement, instead, let, multiple, separate, allowing, independent, copies, but, solves, problem, lower, nothing, prevents, modifying, outside, its, anything, else, purely, conventional, enforced, wide, cannot, bypassed, letting, untrusted, operates, below, handles, untracked, useful, beyond, controlled, are, complementary, rather, than, competing, answers, happened, sandboxes, answer, both, together, trails, namespaces, achieve, mounts, only, uses, difference, persistence, queryability, upper, machine, tmp, bwrap, bubblewrap, different, faq, heart, implemented, does, piece, stores, invokes, lives, trail, store, context, posix, accessible, three, interfaces, details, durable, objects, interactive, vercel, minimal, nfsv3, anthropic, framework, contains, demonstrate, integrate, some, popular, frameworks, results, record, tools, tracking, readdir, pdfbuffer, pdf, writefile, get, prefs, dark, theme, set, ephemeralagent, ephemeral, memory, persistent, identifier, import, npm, project, bin, welcome, exit, program, experimental, duration, execute_code, pending, api_call, error, 300ms, read_file, 50ms, 1200ms, path, directly, inspect, init, created, initialize, curl, fssl, https, getting, entire, runtime, between, machines, control, deploy, runs, portability, point, restore, later, reproduce, exact, states, test, scenarios, roll, back, mistakes, reproducibility, operation, recorded, debug, issues, analyze, meet, compliance, requirements, benefits, interface, managing, host, libraries, programmatic, rust, python, typescript, consists, explicitly, designed, traditional, applications, need, software, beta, may, still, contain, bugs, unexpected, caution, production, data, ensure, have, backups, warning, folders, tags, main, fork, notification, notifications, tursodatabase, forked, public, pull, requests, dismiss, alert, switched, accounts, appearance, search, pricing, event, talks, workshops, next, partners, company, forum, events, webinars, resource, connect, premium, advanced, add, ons, trust, evaluate, industries, government, manufacturing, financial, services, healthcare, industry, nonprofits, startups, team, enterprises, stage, businesses, improvements, across, one, place, developer, articles, sponsors, trending, repos, explore, customize, certifications, scanning, leak, prevention, protection, vulnerability, detection, remediation, secure, cloud, development, codespaces, enforcement, automation, ship, tasks, automated, hosting, review, collaboration, platform, skip, content,
Text of the page (random words):
github coderabbitai agentfs the filesystem for agents github skip to content navigation menu sign in products platform github repository hosting code review and collaboration copilot ai coding agent for tasks projects and automated work build ship actions ci cd and automation code quality quality analysis fixes and enforcement codespaces cloud development environments secure code security vulnerability detection and remediation secret protection secret scanning and leak prevention all features developers learn documentation training certifications build build with copilot customize copilot integrations explore trending repos github sponsors developer articles changelog changelog your source for the latest features improvements and fixes across github products all in one place businesses by stage enterprises team startups nonprofits by industry healthcare financial services manufacturing government see all industries evaluate github why github customer stories business insights trust center add ons github advanced security enterprise grade code security copilot for business enterprise grade ai features premium support enterprise grade 24 7 support resources learn connect documentation resource center blog events webinars community forum customer stories integrations support customer support training github status company about partners changelog github universe github universe the event for developers by developers talks workshops and what s next for github pricing search sign in sign up appearance settings you signed in with another tab or window reload to refresh your session you signed out in another tab or window reload to refresh your session you switched accounts on another tab or window reload to refresh your session dismiss alert message coderabbitai agentfs repository navigation code pull requests 1 1 actions projects security and quality insights more items agentfs public forked from tursodatabase agentfs notifications you must be signed in to change notification settings fork 2 2 star 2 2 you must be signed in to star a repository about the filesystem for agents www agentfs ai resources readme activity custom properties stars 2 stars watchers 0 watching forks 2 forks report repository main branches tags go to file code open more actions menu latest commit history 758 commits 758 commits folders and files name name last commit message last commit date claude commands claude commands devcontainer devcontainer github github cli cli examples examples licenses licenses sandbox sandbox scripts scripts sdk sdk gitignore gitignore changelog md changelog md manual md manual md readme md readme md spec md spec md testing md testing md dist workspace toml dist workspace toml view all files repository files navigation readme more items agentfs the filesystem for agents ️ warning this software is in beta it may still contain bugs and unexpected behavior use caution with production data and ensure you have backups what is agentfs agentfs is a filesystem explicitly designed for ai agents just as traditional filesystems provide file and directory abstractions for applications agentfs provides the storage abstractions that ai agents need the agentfs repository consists of the following sdk typescript python and rust libraries for programmatic filesystem access cli command line interface for managing agent filesystems mount agentfs on host filesystem with fuse on linux and nfs on macos access agentfs files with a command line tool agentfs specification sqlite based agent filesystem specification why agentfs agentfs provides the following benefits for agent state management auditability every file operation tool call and state change is recorded in a sqlite database file query your agent s complete history with sql to debug issues analyze behavior or meet compliance requirements reproducibility snapshot an agent s state at any point with cp agent db snapshot db restore it later to reproduce exact execution states test what if scenarios or roll back mistakes portability the entire agent runtime files state history is stored in a single sqlite file move it between machines check it into version control or deploy it to any system where turso runs read more about the motivation for agentfs in the announcement blog post getting started using the cli install the agentfs cli curl fssl https agentfs ai install bash initialize an agent filesystem agentfs init my agent created agent filesystem agentfs my agent db agent id my agent inspect the agent filesystem agentfs fs my agent ls using agent my agent f hello txt agentfs fs my agent cat hello txt hello from agent you can also use a database path directly agentfs fs agentfs my agent db cat hello txt hello from agent view the agent s action timeline agentfs timeline my agent id tool status duration started 4 execute_code pending 2024 01 05 09 44 20 3 api_call error 300ms 2024 01 05 09 44 15 2 read_file success 50ms 2024 01 05 09 44 10 1 web_search success 1200ms 2024 01 05 09 43 45 you can mount an agent filesystem using fuse linux or nfs macos agentfs mount my agent mnt echo hello mnt hello txt cat mnt hello txt hello you can also run a program in an experimental sandbox with the agent filesystem mounted at agent agentfs run bin bash welcome to agentfs echo hello from agent agent hello txt cat agent hello txt hello from agent exit read the user manual for complete documentation using the sdk install the sdk in your project npm install agentfs sdk use it in your agent code import agentfs from agentfs sdk persistent storage with identifier const agent await agentfs open id my agent creates agentfs my agent db or use ephemeral in memory database const ephemeralagent await agentfs open key value operations await agent kv set user preferences theme dark const prefs await agent kv get user preferences filesystem operations await agent fs writefile output report pdf pdfbuffer const files await agent fs readdir output tool call tracking await agent tools record web_search date now 1000 date now 1000 1 5 query ai results examples this source repository also contains examples that demonstrate how to integrate agentfs with some popular ai frameworks mastra research assistant using the mastra ai framework claude agent sdk research assistant using anthropic s claude agent sdk openai agents research assistant using openai agents sdk firecracker minimal firecracker vm with agentfs mounted via nfsv3 ai sdk just bash interactive ai agent using vercel ai sdk with just bash for command execution cloudflare workers ai agent using ai sdk just bash on cloudflare workers with durable objects storage see the examples directory for more details how agentfs works agentfs is an agent filesystem accessible through an sdk that provides three essential interfaces for agent state management filesystem a posix like filesystem for files and directories key value a key value store for agent state and context toolcall a toolcall audit trail for debugging and analysis at the heart of agentfs is the agent filesystem a complete sqlite based storage system for agents implemented using turso everything an agent does every file it creates every piece of state it stores every tool it invokes lives in a single sqlite database file faq how is agentfs different from x bubblewrap provides filesystem isolation using linux namespaces and overlays while you could achieve similar isolation with a bwrap call that mounts read only and uses tmp overlay on the working directory the key difference is persistence and queryability with agentfs the upper filesystem is stored in a single sqlite database file which you can query snapshot and move to another machine read more about the motivation in the announcement blog post docker sandbox and agentfs are complementary rather than competing agentfs answers what happened and what s the state while docker sandboxes answer how do i run this safely you could use both together run an agent inside a docker sandbox for security while using agentfs inside that sandbox for structured state management and audit trails git worktrees let you check out multiple branches of a repository into separate directories allowing agents to work on independent copies of the source code similar to agentfs but agentfs solves the problem at a lower level with git worktrees nothing prevents an agent from modifying files outside its worktree another agent s worktree system files or anything else on the filesystem the isolation is purely conventional not enforced agentfs provides filesystem level copy on write isolation that s system wide and cannot be bypassed letting you safely run untrusted agents and because it operates below git it also handles untracked files making it useful beyond just version controlled source code why implement agentfs at the filesystem layer instead of using containers or vms the filesystem layer gives us capabilities that block devices can t first because everything is stored in structured sqlite tables you can query the filesystem which is essential for auditability and debugging agent behavior second sqlite s write ahead log enables snapshotting and time travel forking by capturing every filesystem change third we can provide an sdk that works in environments such as serverless or the browser where there s no way to mount a block device at all note that this approach works fine with containers and vms too you can use agentfs via remote filesystem protocols like nfs or through mechanisms like virtio fuse learn more user manual complete guide to using the agentfs cli and sdk agent filesystem specification technical specification of the agent filesystem sqlite schema sdk examples working code examples using agentfs turso database an in process sql database compatible with sqlite blog posts introducing agentfs the motivation behind agentfs agentfs with fuse mounting agent filesystems using fuse agentfs with overlay filesystem sandboxing agents with copy on write overlays ai agents with just bash safe bash command execution for agents agentfs in the browser running agentfs in browsers with webassembly making coding agents safe using llamaindex using agentfs with llamaindex license mit about the filesystem for agents www agentfs ai resources readme activity custom properties stars 2 stars watchers 0 watching forks 2 forks report repository releases packages contributors languages footer 2026 github inc footer navigation terms privacy security status community docs contact manage cookies do not share my personal information you can t perform that action at this time
|