O que é AgentFS?
O AgentFS guarda tudo o que um agente toca em um único banco SQLite construído sobre o Turso, o motor compatível com SQLite da empresa. Dentro desse arquivo há três coisas: um sistema de arquivos no estilo POSIX armazenado como tabelas de inodes e entradas de diretório, um armazenamento chave-valor para o estado e um registro só de acréscimo das chamadas de ferramentas. Como é um arquivo só, um snapshot é uma simples cópia do banco, e o histórico do agente é consultado com SQL em vez de reconstruído a partir de logs.
O projeto traz SDKs para TypeScript, Python, Rust e Go, e uma CLI que monta o banco como um sistema de arquivos real (FUSE no Linux, NFS no macOS), executa um programa em um sandbox de cópia na escrita com `agentfs run`, mostra o histórico de chamadas com `agentfs timeline` e serve os arquivos e o armazenamento chave-valor por MCP ou NFS. A sincronização opcional envia o banco para o Turso Cloud; a criptografia local em repouso é a alternativa, e as duas não podem ser combinadas.
AgentFS vale a pena?
O que há de útil no AgentFS é o arquivo único. Os arquivos de trabalho do agente, seu estado chave-valor e o registro de cada ferramenta chamada vão para um único banco SQLite, então desfazer uma execução ruim é copiar de volta um snapshot anterior, e descobrir o que deu errado é uma consulta SQL, não uma garimpagem em logs. Pekka Enberg e Glauber Costa, da Turso, o anunciaram em 13 de novembro de 2025, e o repositório tem cerca de 3.500 estrelas no GitHub.
A CLI faz mais do que o SDK sozinho sugere. `agentfs run` inicia um shell ou um agente de programação sobre uma camada de cópia na escrita do seu projeto: as gravações vão para o banco e os arquivos originais ficam intactos, usando user namespaces no Linux e o sandbox da Apple no macOS. `agentfs mount` expõe o banco como um diretório comum, para que ferramentas como git e grep funcionem sem mudanças. O README admite com franqueza que git worktrees separam agentes só por convenção, enquanto a camada é imposta abaixo do agente. O pacote npm registrou 23.397 downloads na semana até 12 de novembro de 2026.
Por padrão os dados ficam locais, em .agentfs/<id>.db dentro do projeto. `agentfs serve nfs` escuta em 127.0.0.1, porta 11111, a menos que você o vincule a outro endereço, e qualquer pessoa que alcance essa porta pode montar os arquivos. A criptografia local aceita AES-256-GCM e cifras AEGIS com uma chave hexadecimal gerenciada por você; ativar a sincronização com o Turso Cloud elimina a criptografia.
O porém: maturidade. A versão 0.6.0, de 5 de fevereiro de 2026, foi a primeira beta, o README ainda desaconselha confiar dados de produção a ele sem backups, e a versão mais recente, v0.6.4, saiu em 25 de março. O último commit no branch principal, em 3 de junho, foi uma correção de lint, e o tracker mostra 59 issues abertas e 18 pull requests abertos. Mudanças de esquema exigem `agentfs migrate`, e o sandbox mais rígido baseado em ptrace está marcado como experimental e só para Linux.
Nossa opinião: para quem constrói infraestrutura de agentes e quer desfazer e trilha de auditoria sem escrever isso do zero, o AgentFS é o design mais limpo disponível; para um único agente de programação no seu notebook, git e um contêiner já resolvem quase tudo.
Onde ele se destaca
Um engenheiro de uma empresa que roda agentes de programação em repositórios de clientes
Deixar um agente alterar arquivos livremente e descartar as mudanças se a execução der errado
Inicie o agente com `agentfs run` para que as gravações caiam em um banco de camada; depois guarde ou descarte esse arquivo. O software é gratuito; o custo é o risco da beta e o tempo de integrá-lo ao seu runner.
Uma equipe de plataforma que precisa mostrar aos auditores o que um agente fez
Responder quais arquivos um agente gravou e quais ferramentas chamou, e em que ordem
Registre as chamadas de ferramentas pelo SDK e consulte com SQL o registro só de acréscimo e as tabelas de arquivos, ou leia `agentfs timeline`. Arquivar o banco de cada execução mantém as evidências em um só lugar.
Um desenvolvedor que constrói um agente em serverless ou no navegador
Dar ao agente um sistema de arquivos onde nenhum disco pode ser montado
Abra um banco AgentFS pelo SDK de TypeScript, que o projeto também demonstra no Cloudflare Durable Objects e em WebAssembly. A sincronização opcional com o Turso Cloud leva o estado entre máquinas.
Antes de decidir
- Configuração
- Instale a CLI com o instalador curl da página de versões; depois `agentfs init my-agent` cria .agentfs/my-agent.db. Os SDKs são instalados com `npm install agentfs-sdk`, pip ou cargo.
- Integrações
- Exemplos para Mastra, Claude Agent SDK, OpenAI Agents SDK, Vercel AI SDK com just-bash, Cloudflare Workers e Firecracker; servidores MCP e NFS embutidos na CLI.
- Dados e privacidade
- Tudo fica em um arquivo SQLite local, a menos que você configure a sincronização com o Turso Cloud. A criptografia local em repouso usa uma chave fornecida por você; o servidor NFS se vincula a 127.0.0.1 por padrão e, vinculado a outro endereço, expõe os arquivos a quem alcançar a porta.
- Custo em escala
- O software é gratuito. A sincronização com o Turso Cloud é uma cobrança separada da Turso; o armazenamento cresce a cada versão de arquivo e chamada de ferramenta mantida no banco.
- Limites
- Beta; atualizações de esquema exigem `agentfs migrate`; apenas FUSE no Linux e NFS no macOS; o sandbox ptrace é experimental e só para Linux; criptografia e sincronização são mutuamente exclusivas.
O que é bom
- Arquivos, estado chave-valor e chamadas de ferramentas em um único arquivo SQLite consultável com SQL
- Snapshots e reversão são uma cópia de arquivo
- O sandbox de cópia na escrita deixa o projeto real intacto no Linux e no macOS
- SDKs para TypeScript, Python, Rust e Go, além de servidores MCP e NFS
O que não é
- Software em beta; o README desaconselha dados de produção sem backups
- Nenhuma versão desde a v0.6.4, de 25 de março de 2026
- Criptografia em repouso e sincronização com o Turso Cloud não podem ser usadas juntas
- Não há arquivo de licença na raiz do repositório, apenas uma licença declarada no README e nos metadados dos pacotes
Ideal para
Equipes que constroem plataformas de agentes ou sandboxes e querem guardar cada execução como um banco que pode ser inspecionado e copiado.
Alternativas ao AgentFS
AgentFS: perguntas frequentes
- AgentFS vale a pena?
- O AgentFS transforma os arquivos, o estado e o histórico de ferramentas de um agente em um único arquivo SQLite que você pode consultar e copiar, uma ideia limpa que ainda leva o rótulo de beta e desacelerou desde o primeiro semestre. Damos nota 3.7 de 5.
- Quanto custa AgentFS?
- Gratuito e de código aberto (MIT, segundo o README e os metadados dos pacotes). A sincronização opcional vai para o Turso Cloud, cobrado à parte pela Turso.
- Quais são as desvantagens de AgentFS?
- Software em beta; o README desaconselha dados de produção sem backups; nenhuma versão desde a v0.6.4, de 25 de março de 2026; criptografia em repouso e sincronização com o Turso Cloud não podem ser usadas juntas; não há arquivo de licença na raiz do repositório, apenas uma licença declarada no README e nos metadados dos pacotes.
- Para quem AgentFS é indicado?
- Equipes que constroem plataformas de agentes ou sandboxes e querem guardar cada execução como um banco que pode ser inspecionado e copiado.
- Quanto custa AgentFS para uma equipe ou em produção?
- O software é gratuito. A sincronização com o Turso Cloud é uma cobrança separada da Turso; o armazenamento cresce a cada versão de arquivo e chamada de ferramenta mantida no banco.
- AgentFS é seguro para dados da empresa?
- Tudo fica em um arquivo SQLite local, a menos que você configure a sincronização com o Turso Cloud. A criptografia local em repouso usa uma chave fornecida por você; o servidor NFS se vincula a 127.0.0.1 por padrão e, vinculado a outro endereço, expõe os arquivos a quem alcançar a porta.
- Quais são as melhores alternativas ao AgentFS?
- As alternativas mais próximas que analisamos são OpenSandbox, Anthropic Sandbox Runtime (srt) e Beads.
Respostas verificadas em 13 de nov. de 2026.