Repolode
gastownhall

gastownhall/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.

Alternativa open source a:JiraLinear

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. 1

    Instale o bd CLI em todo o sistema

    Instale seguindo as instruções oficiais do README
  2. 2

    Acesse o diretório do projeto

    cd your-project
  3. 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