Beads: memória persistente para agentes de IA

Beads é um tracker de issues distribuído em grafo, projetado para dar memória persistente a agentes de IA como Claude Code, Cursor e Codex. O repositório gastownhall/beads cruzou 21.474 stars no GitHub em abril de 2026, com 89 releases e 324 contribuidores. Escrito em Go e licenciado sob MIT, ele resolve um problema real do vibe coding: agentes esquecem o contexto entre sessões, e markdowns bagunçados não dão conta de tarefas longas com dependências. Beads substitui esses arquivos por um banco SQL versionado (powered by Dolt — banco que combina SQL com versionamento estilo Git) que armazena issues, dependências e progresso de forma estruturada. O agente consulta o grafo, sabe o que já foi feito, o que está bloqueado e o que vem depois — sem precisar reler 10 mil linhas de plano. É CLI, instala uma vez, funciona em qualquer projeto. Para quem usa IA para programar, é uma das ferramentas mais relevantes do trimestre.

O que faz

Beads é um banco de dados de issues que vive ao lado do seu projeto e conversa com o agente de IA via CLI ou MCP (Model Context Protocol — protocolo que conecta ferramentas externas a agentes como Claude). Cada issue vira um nó no grafo, com status, dependências, prioridade e histórico.

Quando você pede para o agente “implementar o login”, ele consulta o grafo, identifica 3 issues relacionadas (criar tabela de usuários, adicionar middleware, criar formulário), checa quais estão bloqueadas e começa pela ordem certa. Ao terminar, atualiza o status sozinho — sem prompt manual.

A diferença para um TODO.md é estrutural: dependências viram arestas do grafo, não bullets aninhados. O agente consegue responder perguntas como “o que está pronto para mergear?” ou “qual issue desbloqueia mais trabalho?”. E como roda em Dolt, todo o histórico fica auditável e versionado.

Por que está em alta

O salto começou em março de 2026, quando Steve Yegge — engenheiro veterano com passagem por Google e Amazon — publicou um ensaio defendendo que agentes de IA precisam de memória estruturada para escalar. Beads era o exemplo prático citado.

Em 30 dias, o repositório saltou de cerca de 4.000 para 21.474 stars (medido em 24/04/2026). Os 89 releases publicados e o ritmo de commits diários (último commit há 0 dias) mostram que o projeto não é experimento de fim de semana — é ferramenta em produção.

A integração nativa com Claude Code via MCP acelerou a adoção: quem já usa Cursor, Claude Code ou Codex conecta Beads em uma linha de configuração. Topics oficiais do GitHub: agents, claude-code, coding.

Métrica	Valor
Stars	21.474
Licença	MIT
Último update	24/04/2026
Linguagem	Go
Contributors	324

Para quem serve / Para quem NÃO serve

Serve para: quem já incorporou agentes de IA no fluxo de desenvolvimento e sente o atrito da falta de memória entre sessões. Founders técnicos construindo MVPs com vibe coding, times pequenos onde o agente toca várias frentes em paralelo, e devs em projetos longos onde o contexto se perde.

Também serve para quem terceiriza partes da stack para o agente (frontend, testes, scripts auxiliares) e precisa de um backlog que ambos — humano e IA — consultam como fonte de verdade.

NÃO serve para: projetos pequenos resolvidos em uma única sessão de chat. Se a tarefa é uma landing page de 2 horas, Beads é overkill. Também não substitui Linear, Jira ou GitHub Issues em times grandes — é uma camada paralela focada no agente, não um substituto de PM.

A curva de aprendizado é baixa para quem já vive no terminal, mas exige instalar binário Go e configurar MCP. Quem não topa CLI vai sofrer no setup.

Alternativas

Concorrentes diretos resolvendo o mesmo problema de memória para agentes:

Linear — issue tracker SaaS, US$ 8/usuário/mês. Tem MCP oficial. Melhor para times; pior para uso solo offline ou projetos pessoais.
GitHub Issues — gratuito, integrado ao repo. Falta grafo de dependências nativo; agentes leem como lista plana e perdem contexto.
Cline Memory Bank — open-source, focado no agente Cline. Usa markdown estruturado, não banco SQL. Mais simples, menos auditável.

Para quem já automatiza outras frentes com IA — caso de quem usa IA para otimizar Google Ads — a lógica é a mesma: estruturar contexto reduz erro e acelera resultado.

Veredicto

Se você programa com agentes de IA mais de 3 horas por semana, instale Beads esta semana. O custo é zero (MIT), a curva é uma tarde de configuração, e o ganho aparece na primeira tarefa que dura mais de uma sessão. Para quem ainda não automatizou nada com IA, comece pelo guia de vibe coding antes — Beads sem agente é só um issue tracker comum.

Fonte: beads no GitHub