Primeros pasos

De la instalación a tu primer workspace en menos de dos minutos. Beadbox envuelve el CLI bd, así que instalarás ambos.

1Instalar el CLI beads

El comando bd es el motor detrás de Beadbox. Gestiona tus issues, epics y dependencias localmente usando almacenamiento respaldado por Git.

brew install beads

Requiere Homebrew. Instala el binario bd en tu PATH.

Verifica la instalación:

bd --version

Deberías ver el número de versión. Si el comando no se encuentra, asegúrate de que el directorio de instalación esté en tu PATH.

2Instalar Beadbox

Beadbox es una aplicación de escritorio nativa. Elige el instalador para tu plataforma.

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

O descarga el DMG directamente desde GitHub Releases.

Apple Silicon (.dmg)Intel (.dmg)

3Primer inicio

Abre Beadbox. Lo que sucede depende de tu configuración.

¿Nuevo en beads? ¿Sin workspaces todavía?

Beadbox busca el CLI bd al iniciar. Si no lo encuentra, verás una pantalla de bienvenida con instrucciones de instalación y un botón "Verificar de nuevo".

Una vez que se detecta bd, verás una tarjeta de Inicio rápido. Elige una carpeta de proyecto, haz clic en Configurar Workspace, y Beadbox ejecuta bd por ti. Tu workspace está listo; todos los datos se quedan en tu máquina.

¿Ya usas bd? ¿Tienes workspaces existentes?

Beadbox detecta workspaces desde tu ~/.beads/registry.json y cualquier directorio de proyecto que contenga una carpeta .beads/. Haz clic en un workspace para abrirlo. Tu árbol de epics se carga con indicadores de estado en vivo.

Los cambios desde la terminal se propagan en tiempo real. Ejecuta bd update <id> --status closed en tu terminal y observa cómo el estado se actualiza en Beadbox en menos de dos segundos, sin necesidad de recargar.

4Lo que verás

La pantalla principal tiene tres zonas:

Pantalla principal de Beadbox mostrando el árbol de epics a la izquierda, el panel de detalles a la derecha y la barra de filtros arriba

Encabezado

Cambia entre workspaces, consulta el estado de conexión y ejecuta una actualización manual. Los ajustes de atajos de teclado también están aquí.

Barra de filtros

Filtra por estado, prioridad, asignado o búsqueda de texto completo. Ordena por actualización, creación, prioridad o estado. Los filtros persisten por workspace.

Árbol de epics (izquierda)

Vista jerárquica de tus epics y sus hijos. Expande para ver insignias de estado, indicadores de prioridad y conteos de progreso. Haz clic en cualquier bead para abrir sus detalles.

Panel de detalles (derecha)

Todos los metadatos del bead: descripción, comentarios, dependencias, criterios de aceptación. Todo renderizado como markdown.

Siguientes pasos