Premiers Pas

De l'installation à votre premier workspace en moins de deux minutes. Beadbox s'appuie sur le CLI bd, vous allez donc installer les deux.

1Installer le CLI beads

La commande bd est le moteur derrière Beadbox. Elle gère vos issues, épics et dépendances localement avec un stockage basé sur Git.

brew install beads

Nécessite Homebrew. Installe le binaire bd dans votre PATH.

Vérifiez l'installation :

bd --version

Vous devriez voir le numéro de version. Si la commande est introuvable, assurez-vous que le répertoire d'installation est dans votre PATH.

2Installer Beadbox

Beadbox est une application de bureau native. Choisissez l'installateur pour votre plateforme.

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

Ou téléchargez le DMG directement depuis GitHub Releases.

Apple Silicon (.dmg)Intel (.dmg)

3Premier lancement

Ouvrez Beadbox. La suite dépend de votre configuration.

Nouveau sur beads ? Pas encore de workspaces ?

Beadbox vérifie la présence du CLI bd au démarrage. S'il ne le trouve pas, vous verrez un écran d'accueil avec les instructions d'installation et un bouton "Vérifier à nouveau".

Une fois bd détecté, vous verrez une carte Démarrage Rapide. Choisissez un dossier de projet, cliquez sur Configurer le Workspace, et Beadbox exécute bd pour vous. Votre workspace est prêt ; toutes les données restent locales sur votre machine.

Vous utilisez déjà bd ? Vous avez des workspaces existants ?

Beadbox détecte les workspaces depuis votre ~/.beads/registry.json et tout répertoire de projet contenant un dossier .beads/. Cliquez sur un workspace pour l'ouvrir. Votre arbre d'épics se charge avec des indicateurs de statut en direct.

Les modifications depuis le terminal se propagent en temps réel. Lancez bd update <id> --status closed dans votre terminal et regardez le statut se mettre à jour dans Beadbox en moins de deux secondes, sans rafraîchissement.

4Ce que vous voyez

L'écran principal comporte trois zones :

Écran principal de Beadbox montrant l'arbre d'épics à gauche, le panneau de détails à droite et la barre de filtres en haut

En-tête

Basculez entre les workspaces, consultez l'état de la connexion et déclenchez un rafraîchissement manuel. Les paramètres de raccourcis clavier sont aussi ici.

Barre de filtres

Filtrez par statut, priorité, responsable ou recherche en texte libre. Triez par date de modification, création, priorité ou statut. Les filtres persistent par workspace.

Arbre d'épics (gauche)

Vue hiérarchique de vos épics et de leurs enfants. Développez pour voir les badges de statut, les indicateurs de priorité et les compteurs de progression. Cliquez sur n'importe quel bead pour voir ses détails.

Panneau de détails (droite)

Métadonnées complètes du bead : description, commentaires, dépendances, critères d'acceptation. Tout est rendu en markdown.

Prochaines étapes