Primeiros Passos

Da instalação ao seu primeiro workspace em menos de dois minutos. O Beadbox envolve o CLI bd, então você vai instalar ambos.

1Instalar o CLI beads

O comando bd é o motor por trás do Beadbox. Ele gerencia seus issues, épicos e dependências localmente usando armazenamento baseado em Git.

brew install beads

Requer Homebrew. Instala o binário bd no seu PATH.

Verifique a instalação:

bd --version

Você deve ver o número da versão. Se o comando não for encontrado, certifique-se de que o diretório de instalação está no seu PATH.

2Instalar o Beadbox

O Beadbox é um app desktop nativo. Escolha o instalador para sua plataforma.

brew tap beadbox/cask && brew install --cask beadbox

Ou baixe o DMG diretamente do GitHub Releases.

Apple Silicon (.dmg)Intel (.dmg)

3Primeira execução

Abra o Beadbox. O que acontece a seguir depende da sua configuração.

Novo no beads? Sem workspaces ainda?

O Beadbox verifica se o CLI bd está disponível na inicialização. Se não encontrar, você verá uma tela de boas-vindas com instruções de instalação e um botão "Verificar novamente".

Quando o bd for detectado, você verá um cartão de Início Rápido. Escolha uma pasta de projeto, clique em Configurar Workspace, e o Beadbox executa bd pra você. Seu workspace está pronto; todos os dados ficam locais na sua máquina.

Já usa o bd? Tem workspaces existentes?

O Beadbox detecta workspaces do seu ~/.beads/registry.json e de qualquer diretório de projeto que contenha uma pasta .beads/. Clique em um workspace para abri-lo. Sua árvore de épicos carrega com indicadores de status ao vivo.

Alterações feitas no terminal propagam em tempo real. Execute bd update <id> --status closed no seu terminal e veja o status atualizar no Beadbox em até dois segundos, sem refresh.

4O que você vê

A tela principal tem três zonas:

Tela principal do Beadbox mostrando a árvore de épicos à esquerda, painel de detalhes à direita e barra de filtros no topo

Cabeçalho

Alterne entre workspaces, veja o status da conexão e acione uma atualização manual. As configurações de atalhos de teclado também ficam aqui.

Barra de filtros

Filtre por status, prioridade, responsável ou busca por texto. Ordene por atualizado, criado, prioridade ou status. Os filtros persistem por workspace.

Árvore de épicos (esquerda)

Visualização hierárquica dos seus épicos e seus filhos. Expanda para ver badges de status, indicadores de prioridade e contagens de progresso. Clique em qualquer bead para ver seus detalhes.

Painel de detalhes (direita)

Metadados completos do bead: descrição, comentários, dependências, critérios de aceitação. Tudo renderizado como markdown.

Próximos passos