O que é Beads?
O Beads troca as listas de tarefas em markdown que os agentes de programação mantêm por um pequeno rastreador de issues que eles podem consultar. Cada tarefa recebe um ID baseado em hash, como bd-a1b2; as tarefas se ligam umas às outras como bloqueios, pais ou duplicatas, e `bd ready` mostra só o trabalho que não tem nada em aberto na frente. Um agente assume uma tarefa com `bd update --claim`, que define responsável e status em um só passo, e a fecha com `bd close`, que libera o que ela estava bloqueando. `bd remember` guarda fatos do projeto que `bd prime` devolve no início da próxima sessão.
O armazenamento é o Dolt, um banco de dados SQL com controle de versão. Por padrão ele roda embutido na CLI com um único escritor; o modo servidor se conecta a um dolt sql-server para vários escritores ao mesmo tempo. As máquinas sincronizam com `bd dolt push` e `bd dolt pull` contra uma ref no seu remoto git existente. `bd init` também escreve orientações em AGENTS.md e instala hooks para Claude Code, Codex e Cursor. O projeto saiu de steveyegge/beads para a organização gastownhall; o caminho antigo redireciona.
Beads vale a pena?
O Beads resolve bem um problema estreito: o agente que na terça esquece o que planejou na segunda. Em vez de um PLAN.md que fica desatualizado, o agente pede a `bd ready --json` o trabalho desbloqueado e registra o que encontra como novas tarefas. O repositório tem cerca de 28.700 estrelas no GitHub, chegou à v1.0.0 em 3 de abril de 2026 e lançou a v1.3.4 em 4 de novembro, com uma release candidate da v1.4.0 publicada em 13 de novembro.
O backend Dolt é o motivo de os merges saírem limpos. IDs por hash impedem que dois agentes em dois branches criem o mesmo número de tarefa, e o Dolt mescla linhas célula a célula em vez de como linhas de texto. O modo embutido padrão mantém o banco em .beads/ e permite um escritor por vez; vários agentes escrevendo ao mesmo tempo precisam do modo servidor. O arquivo .beads/issues.jsonl é uma exportação para visualizadores, não um backup, o que surpreende quem espera arquivos simples no git.
Por padrão, ele é discreto. A exportação de OpenTelemetry fica desligada até você definir BD_OTEL_ENABLED, e chamadas a modelos só acontecem em comandos opcionais: a compactação, que resume tarefas fechadas há tempo para poupar contexto, e a detecção de duplicatas por IA usam por padrão o Claude Haiku 4.5 com sua própria chave da Anthropic (a MiniMax é o outro provedor suportado). O projeto se protege contra repositórios hostis: um .beads/.env versionado não pode definir comandos nem helpers de credenciais, e o cliente HTTP experimental se recusa a enviar um token por http sem criptografia a um servidor que não seja local.
O porém: o ritmo de mudanças. O rastreador mostra cerca de 1.070 issues abertas e 697 pull requests abertos, e as atualizações podem incluir migrações de esquema que, em um banco compartilhado, um clone designado precisa rodar antes que os outros façam bootstrap. Ian Bull, em um texto longo publicado em janeiro, viu que o Claude ignora o Beads se não for mandado consultá-lo e que as instruções do CLAUDE.md se perdem ao longo de uma sessão longa, então hooks ou prompts explícitos continuam necessários.
Nossa opinião: para um agente em uma tarefa curta, um checklist em markdown basta; quando entram dois agentes, duas máquinas ou uma refatoração de uma semana, o Beads guarda o plano em uma forma que o agente consegue consultar e o git consegue levar.
Onde ele se destaca
Um desenvolvedor solo fazendo uma migração de uma semana com Claude Code
Retomar exatamente de onde a sessão de ontem parou
Rode `bd init` e deixe-o instalar os hooks do Claude Code; o agente registra cada problema descoberto como tarefa e `bd prime` recupera o trabalho em aberto na manhã seguinte. Sem custo além do próprio agente, já que a compactação é opcional.
Uma equipe de quatro pessoas com agentes em branches e notebooks diferentes
Compartilhar um único grafo de tarefas sem conflitos de merge em um arquivo de plano
Suba um dolt sql-server com `bd init --server` para escritores simultâneos e sincronize com `bd dolt push` e `bd dolt pull` contra o remoto git da equipe. A cada atualização uma pessoa precisa rodar antes a migração de esquema, algo que vale escrever no runbook da equipe.
Uma pessoa que contribui para um projeto open source
Acompanhar o próprio planejamento sem adicionar arquivos ao repositório de outra pessoa
`bd init --stealth` mantém o Beads local, e `bd init --contributor` envia as tarefas de planejamento para um repositório separado, assim os pull requests levam só código.
Antes de decidir
- Configuração
- `brew install beads` ou `npm install -g @beads/bd`, depois `bd init` no projeto; ele escreve orientações em AGENTS.md e hooks de agente, a menos que você passe --skip-agents ou --stealth.
- Integrações
- Claude Code, Codex, Cursor e Factory Droid via `bd setup`; um servidor beads-mcp no PyPI; saída JSON para qualquer agente; um backend HTTP experimental via `bd serve` e `bd connect`.
- Dados e privacidade
- As tarefas ficam em um banco Dolt dentro de .beads/ e sincronizam com uma ref no seu remoto git. A telemetria é opcional via OpenTelemetry. A compactação e a detecção de duplicatas por IA só enviam o texto das tarefas para a Anthropic ou a MiniMax se você as rodar com uma chave.
- Custo em escala
- O software é grátis. A compactação gasta tokens do Claude Haiku 4.5; um servidor Dolt para escritores simultâneos roda na sua própria infraestrutura.
- Limites
- O modo embutido aceita um só escritor; migrações de esquema exigem atualizações coordenadas; o backend HTTP é experimental e recusa algumas operações; cerca de 1.070 issues abertas.
O que é bom
- `bd ready` entrega aos agentes só o trabalho desbloqueado, em JSON
- IDs por hash e merges célula a célula do Dolt evitam colisões de tarefas entre branches
- Sincroniza pelo remoto git que você já tem
- Telemetria desligada por padrão; chamadas a modelos só em comandos opcionais
O que não é
- O modo embutido permite um só escritor; agentes em paralelo precisam de um servidor Dolt
- Migrações de esquema exigem atualização coordenada em bancos compartilhados
- Cerca de 1.070 issues abertas e 697 pull requests abertos
- Os agentes ainda precisam de hooks ou prompts para usá-lo com constância
Ideal para
Desenvolvedores que usam Claude Code, Codex ou vários agentes em trabalhos de vários dias e querem o plano guardado como tarefas consultáveis em vez de markdown.
Alternativas ao Beads
Beads: perguntas frequentes
- Beads vale a pena?
- O Beads dá aos agentes de programação uma lista de tarefas que sobrevive ao fim de uma sessão e ao merge de um branch, ao custo de um banco de dados, migrações de esquema frequentes e um rastreador de issues próprio bem cheio. Damos nota 4.0 de 5.
- Quanto custa Beads?
- Grátis e open source (MIT). A compactação opcional e a detecção de duplicatas por IA chamam um modelo com sua própria chave da Anthropic ou da MiniMax.
- Quais são as desvantagens de Beads?
- O modo embutido permite um só escritor; agentes em paralelo precisam de um servidor Dolt; migrações de esquema exigem atualização coordenada em bancos compartilhados; cerca de 1.070 issues abertas e 697 pull requests abertos; os agentes ainda precisam de hooks ou prompts para usá-lo com constância.
- Para quem Beads é indicado?
- Desenvolvedores que usam Claude Code, Codex ou vários agentes em trabalhos de vários dias e querem o plano guardado como tarefas consultáveis em vez de markdown.
- Quanto custa Beads para uma equipe ou em produção?
- O software é grátis. A compactação gasta tokens do Claude Haiku 4.5; um servidor Dolt para escritores simultâneos roda na sua própria infraestrutura.
- Beads é seguro para dados da empresa?
- As tarefas ficam em um banco Dolt dentro de .beads/ e sincronizam com uma ref no seu remoto git. A telemetria é opcional via OpenTelemetry. A compactação e a detecção de duplicatas por IA só enviam o texto das tarefas para a Anthropic ou a MiniMax se você as rodar com uma chave.
- Quais são as melhores alternativas ao Beads?
- As alternativas mais próximas que analisamos são claude-mem, Vibe Kanban e Spec Kit.
Respostas verificadas em 13 de nov. de 2026.
Você faz o Beads? Mostre esta nota no seu site
