Erste Schritte

Von der Installation bis zum ersten Workspace in unter zwei Minuten. Beadbox baut auf dem bd CLI auf, daher installieren Sie beides.

1beads CLI installieren

Der bd-Befehl ist die Engine hinter Beadbox. Er verwaltet Ihre Issues, Epics und Abhängigkeiten lokal mit Git-basiertem Speicher.

brew install beads

Erfordert Homebrew. Installiert die bd-Binary in Ihren PATH.

Installation überprüfen:

bd --version

Die Versionsnummer sollte angezeigt werden. Falls der Befehl nicht gefunden wird, stellen Sie sicher, dass das Installationsverzeichnis in Ihrem PATH enthalten ist.

2Beadbox installieren

Beadbox ist eine native Desktop-App. Wählen Sie das Installationsprogramm für Ihre Plattform.

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

Oder laden Sie die DMG direkt von GitHub Releases herunter.

Apple Silicon (.dmg)Intel (.dmg)

3Erster Start

Öffnen Sie Beadbox. Was als Nächstes passiert, hängt von Ihrem Setup ab.

Neu bei beads? Noch keine Workspaces?

Beadbox prüft beim Start, ob das bd CLI vorhanden ist. Falls es nicht gefunden wird, sehen Sie einen Willkommensbildschirm mit Installationsanweisungen und einer "Erneut prüfen"-Schaltfläche.

Sobald bd erkannt wird, erscheint eine Schnellstart-Karte. Wählen Sie einen Projektordner, klicken Sie auf Workspace einrichten, und Beadbox führt bd für Sie aus. Ihr Workspace ist bereit; alle Daten bleiben lokal auf Ihrem Rechner.

Nutzen Sie bd bereits? Haben Sie bestehende Workspaces?

Beadbox erkennt Workspaces aus Ihrer ~/.beads/registry.json und allen Projektverzeichnissen, die einen .beads/-Ordner enthalten. Klicken Sie auf einen Workspace, um ihn zu öffnen. Ihr Epic-Baum wird mit Live-Statusindikatoren geladen.

Änderungen aus dem Terminal werden in Echtzeit übertragen. Führen Sie bd update <id> --status closed in Ihrem Terminal aus und beobachten Sie, wie sich der Status in Beadbox innerhalb von zwei Sekunden aktualisiert, ohne manuelles Neuladen.

4Was Sie sehen

Der Hauptbildschirm besteht aus drei Bereichen:

Beadbox-Hauptbildschirm mit dem Epic-Baum links, dem Detailbereich rechts und der Filterleiste oben

Kopfzeile

Wechseln Sie zwischen Workspaces, sehen Sie den Verbindungsstatus und lösen Sie eine manuelle Aktualisierung aus. Tastaturkürzel-Einstellungen befinden sich hier ebenfalls.

Filterleiste

Filtern Sie nach Status, Priorität, Zuständigem oder per Volltextsuche. Sortieren Sie nach Aktualisierung, Erstellung, Priorität oder Status. Filter bleiben pro Workspace erhalten.

Epic-Baum (links)

Hierarchische Ansicht Ihrer Epics und deren Unterelemente. Aufklappen zeigt Status-Badges, Prioritätsindikatoren und Fortschrittszähler. Klicken Sie auf ein bead, um dessen Details zu öffnen.

Detailbereich (rechts)

Vollständige bead-Metadaten: Beschreibung, Kommentare, Abhängigkeiten, Akzeptanzkriterien. Alles als Markdown gerendert.

Nächste Schritte

  • Lernen Sie die Tastaturkürzel für Vim-artige Navigation (j/k/h/l, gg, G).
  • Lesen Sie die beads-CLI-Dokumentation, um mehr über Epics, Abhängigkeiten und Dolt-basierte Versionskontrolle zu erfahren.