sfs - sistema de arquivos com um cérebro compartilhado entre vários agentes de IA

Olá. Como eu estava usando vários agentes de IA como Claude Code e Codex em diferentes dispositivos/sessões, fiquei frustrado porque cada agente acumulava contexto separadamente, e o agente em outro dispositivo hoje não sabia do que um agente tinha organizado ontem — então criei isto.

O conceito principal é um "cérebro compartilhado entre vários agentes".

Se vários agentes compartilharem a mesma pasta (por exemplo, ./shared), wiki, arquivos de memória, documentos de planejamento e artefatos de trabalho ficam todos reunidos em um único cérebro compartilhado. As decisões registradas por um agente podem ser lidas diretamente por agentes em outros dispositivos/sessões, e é possível rastrear quem mudou o quê, em qual dispositivo e quando.

Casos de uso:

• Contexto de issues de clientes compartilhado entre um Support agent e um Engineering agent
• Compartilhamento de alterações em arquivos/pastas entre Mac mini e Macbook
• Wiki da empresa (company brain) construída em comum pelos membros da equipe a partir de seus próprios agents

sfs monta qualquer pasta como um volume sincronizado:

$ sfs mnt ./shared --remote s3://my-bucket/workspace  

Os arquivos da pasta montada são simplesmente arquivos reais no disco, então todos os editores/ferramentas/agentes podem usá-los imediatamente, sem integração separada. Se você montar o mesmo remote em outro dispositivo, os mesmos arquivos aparecem lá também.

No começo pensei que talvez bastasse usar algo como Google Drive, mas ao testá-lo na prática como workspace de agentes, encontrei os seguintes problemas:

• O Google Drive frequentemente descarrega arquivos locais para economizar espaço em disco, então era comum o agente precisar baixá-los novamente da nuvem sempre que tentava ler um arquivo
• Como usa um modelo de montagem por streaming, era frequente o Claude ficar bloqueado enquanto carregava arquivos
• Desde o início, não foi projetado como uma ferramenta para workflows de agentes de IA (parte do pressuposto de que humanos a usarão clicando na GUI)

sfs mantém todos os arquivos sempre como arquivos reais no disco local (sem offload) e sincroniza em segundo plano, então os agentes podem ler e escrever imediatamente como se fossem arquivos comuns.

Principais recursos:

• Integração com armazenamento em nuvem: S3, GCS
• Rastreamento de alterações: com sfs log, é possível ver quem/quando/em qual dispositivo alterou qual arquivo. Como o armazenamento é baseado em endereçamento por conteúdo, o conteúdo de arquivos sobrescritos ou excluídos também é preservado
• Offline-first: a pasta continua totalmente utilizável mesmo sem rede, e faz push automaticamente quando a conexão volta
• Segurança contra conflitos: edições simultâneas são reproduzidas de forma determinística na ordem (lamport, time, device)
• macOS, Linux

Instalação:

brew install runbear-io/tap/sfs  

Ainda está em uma versão inicial, então feedback/issues são muito bem-vindos. Obrigado!