Quadro Kanban para planejar o trabalho e executar agentes de programação, como Claude Code e Codex, em workspaces isolados, com revisão de diff e criação de PRs.
- Estrelas
- 28,009
- Forks
- 1,895
- Issues abertas
- 1,507
- Último commit
- ontem
O que é?
Beads (a CLI `bd`) é um rastreador de issues criado para agentes de programação com IA. Em vez de manter planos em arquivos Markdown avulsos, ele armazena tarefas como um grafo com dependências em um banco de dados SQL com controle de versão. Os agentes podem buscar tarefas sem bloqueios em aberto, assumir uma tarefa de forma atômica e concluí-la para liberar as tarefas dependentes, acompanhando trabalhos de longa duração sem perder o contexto.
A camada de armazenamento é o Dolt, um banco de dados SQL com branching e merging no estilo do Git. As tarefas recebem IDs baseados em hash, como `bd-a1b2`, para evitar colisões quando vários agentes ou branches criam issues em paralelo. IDs hierárquicos permitem organizar epics e subtarefas, além de links no grafo como `relates-to`, `duplicates` e `supersedes`. A sincronização entre máquinas é feita com `bd dolt push` e `bd dolt pull` usando um Git remote, e a ferramenta pode rodar integrada ou com um servidor Dolt externo.
`bd init` configura um projeto e pode instalar integrações para Claude Code, Codex, Cursor e outros agentes. A CLI também oferece um modo stealth que funciona sem Git e um backend HTTP experimental para conectar a uma instância compartilhada de `bd serve`.
Recursos principais
- 01Armazena tarefas como um grafo de dependências; `bd ready` lista as tarefas sem bloqueios.
- 02Permite assumir tarefas de forma atômica com `bd update --claim` em fluxos de trabalho com vários agentes.
- 03IDs baseados em hash e branching no Dolt reduzem conflitos de merge entre branches.
- 04IDs hierárquicos para epics e subtarefas, além de tipos de links no grafo.
- 05A compactação semântica resume tarefas antigas já concluídas para economizar espaço na janela de contexto.
- 06Modo sem Git e integrações com agentes como Claude Code, Codex e Cursor.
Casos de uso
- Dar a um agente de programação memória persistente de tarefas em projetos longos com várias etapas.
- Coordenar vários agentes trabalhando no mesmo repositório em branches diferentes.
- Acompanhar issues de planejamento separadamente ao contribuir com projetos open source.
- Executar o acompanhamento de tarefas de forma isolada no CI ou em uma configuração de controle de versão sem Git.
Início rápido
- 1
Instale o bd CLI em todo o sistema
Instale seguindo as instruções oficiais do README - 2
Acesse o diretório do projeto
cd your-project - 3
Inicialize o beads no projeto
bd init
Antes de usar
- Requer um banco de dados com backend Dolt, adicionando uma dependência que a equipe precisa conhecer.
- Alguns comportamentos do backend HTTP diferem do modo local e estão documentados como experimentais.
- Para fazer uma instalação manual segura, são necessários o script de instalação e as etapas de verificação do binário.
Tópicos
Perguntas frequentes
- O que é beads?
- Um rastreador distribuído de issues em grafo, baseado em Dolt, que oferece aos agentes de programação memória persistente de tarefas com dependências via CLI bd. Beads (a CLI `bd`) é um rastreador de issues criado para agentes de programação com IA. Em vez de manter planos em arquivos Markdown avulsos, ele armazena tarefas como um grafo com dependências em um banco de dados SQL com controle de versão. Os agentes podem buscar tarefas sem bloqueios em aberto, assumir uma tarefa de forma atômica e concluí-la para liberar as tarefas dependentes, acompanhando trabalhos de longa duração sem perder o contexto.
- beads é gratuito? Qual é a licença?
- beads é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- beads ainda é mantido?
- Manutenção ativa. O último commit de beads foi em 19 de out. de 2026.
- Para que posso usar beads?
- Dar a um agente de programação memória persistente de tarefas em projetos longos com várias etapas. Coordenar vários agentes trabalhando no mesmo repositório em branches diferentes. Acompanhar issues de planejamento separadamente ao contribuir com projetos open source. Executar o acompanhamento de tarefas de forma isolada no CI ou em uma configuração de controle de versão sem Git.
- Como instalar beads?
- Instale o bd CLI em todo o sistema Acesse o diretório do projeto: cd your-project Inicialize o beads no projeto: bd init
- Onde consigo beads?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/gastownhall/beads
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
App para desktop, dispositivos móveis, web e CLI que executa e coordena vários agentes de programação, como Claude Code, Codex e OpenCode, em worktrees paralelas.
Uma interface local de revisão no navegador para anotar planos de agentes, Markdown, HTML e diffs de código e enviar feedback de volta aos agentes de programação.
App para macOS que permite navegar, editar e organizar skills e agentes de codificação com IA no Claude Code, Cursor, Codex, Windsurf e Amp.
Memória persistente para agentes de programação com IA, que registra sessões automaticamente e injeta contexto relevante em sessões futuras no Claude Code, Cursor, Codex e outros clientes MCP.
Uma coleção de 67 pacotes de habilidades especializadas que transformam o Claude Code em um parceiro de programação para desenvolvimento full stack.