Per iniziare

Dall'installazione al tuo primo workspace in meno di due minuti. Beadbox avvolge il CLI bd, quindi installerai entrambi.

1Installare il CLI beads

Il comando bd è il motore dietro Beadbox. Gestisce i tuoi issue, epics e dipendenze in locale usando un archivio supportato da Git.

brew install beads

Richiede Homebrew. Installa il binario bd nel tuo PATH.

Verifica l'installazione:

bd --version

Dovresti vedere il numero di versione. Se il comando non viene trovato, assicurati che la directory di installazione sia nel tuo PATH.

2Installare Beadbox

Beadbox è un'applicazione desktop nativa. Scegli l'installer per la tua piattaforma.

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

Oppure scarica il DMG direttamente da GitHub Releases.

Apple Silicon (.dmg)Intel (.dmg)

3Primo avvio

Apri Beadbox. Cosa succede dopo dipende dalla tua configurazione.

Nuovo su beads? Nessun workspace ancora?

Beadbox cerca il CLI bd all'avvio. Se non lo trova, vedrai una schermata di benvenuto con le istruzioni di installazione e un pulsante "Controlla di nuovo".

Una volta rilevato bd, vedrai una scheda Avvio rapido. Scegli una cartella di progetto, clicca su Configura Workspace, e Beadbox esegue bd per te. Il tuo workspace è pronto; tutti i dati restano in locale sul tuo computer.

Usi già bd? Hai workspace esistenti?

Beadbox rileva i workspace dal tuo ~/.beads/registry.json e da qualsiasi directory di progetto che contenga una cartella .beads/. Clicca su un workspace per aprirlo. Il tuo albero di epics si carica con indicatori di stato in tempo reale.

Le modifiche dal terminale si propagano in tempo reale. Esegui bd update <id> --status closed nel tuo terminale e osserva lo stato aggiornarsi in Beadbox entro due secondi, senza bisogno di ricaricare.

4Cosa vedrai

La schermata principale ha tre zone:

Schermata principale di Beadbox che mostra l'albero degli epics a sinistra, il pannello dei dettagli a destra e la barra dei filtri in alto

Intestazione

Passa tra i workspace, controlla lo stato della connessione e attiva un aggiornamento manuale. Anche le impostazioni delle scorciatoie da tastiera si trovano qui.

Barra dei filtri

Filtra per stato, priorità, assegnatario o ricerca full-text. Ordina per aggiornamento, creazione, priorità o stato. I filtri persistono per workspace.

Albero degli epics (sinistra)

Vista gerarchica dei tuoi epics e dei loro figli. Espandi per vedere i badge di stato, gli indicatori di priorità e i conteggi di avanzamento. Clicca su qualsiasi bead per aprirne i dettagli.

Pannello dei dettagli (destra)

Tutti i metadati del bead: descrizione, commenti, dipendenze, criteri di accettazione. Tutto renderizzato come markdown.

Prossimi passi