viktor/beadboard
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
60 commits 1 branch 0 tags 22 MiB
Find a file
zenchantlive 1ae7efb31b feat(skills): formalize agent coordination via beadboard-driver 
We moved from ad-hoc task claims to a strictly defined 'Skill' system.

Triumphs:
- Implemented the 'beadboard-driver' skill, which encodes our project-specific coordination protocols (claim, reservation, handoff).
- This ensures that any AI operative (or human supervisor) can participate in the project lifecycle using a unified CLI-driven state machine.
- Decoupled high-level mission logic from low-level file mutations, allowing for easier agent skill composition in the future.

Raw Honest Moment:
Initially, we were just 'winging it' with manual status updates. Formalizing this into a skill was a necessary step to ensure our collaboration is repeatable and resilient to agent context swaps.
2026-02-14 00:23:41 -08:00
.beads feat(logic): establish derived-activity engine and agent-session protocols 2026-02-14 00:19:59 -08:00
assets readme pics 2026-02-13 00:20:44 -08:00
docs docs(beads): etch project history into memory bank and finalize skill-bb 2026-02-14 00:21:25 -08:00
scripts feat(ui): Enhance Graph and Kanban UX (bb-18e) 2026-02-12 23:37:27 -08:00
skills/beadboard-driver feat(skills): formalize agent coordination via beadboard-driver 2026-02-14 00:23:41 -08:00
src docs(beads): etch project history into memory bank and finalize skill-bb 2026-02-14 00:21:25 -08:00
tests docs(beads): etch project history into memory bank and finalize skill-bb 2026-02-14 00:21:25 -08:00
tools docs(beads): etch project history into memory bank and finalize skill-bb 2026-02-14 00:21:25 -08:00
.eslintrc.json chore(repo): ignore local beads runtime lock and screenshot artifacts 2026-02-12 23:39:43 -08:00
.gitattributes chore: initialize beadboard baseline 2026-02-11 17:42:51 -08:00
.gitignore chore(repo): ignore local beads runtime lock and screenshot artifacts 2026-02-12 23:39:43 -08:00
AGENTS.md docs(beads): etch project history into memory bank and finalize skill-bb 2026-02-14 00:21:25 -08:00
bb.ps1 docs(beads): etch project history into memory bank and finalize skill-bb 2026-02-14 00:21:25 -08:00
eslint.config.mjs chore: clear lint warnings and finalize shared epic chip strip 2026-02-13 12:44:14 -08:00
image-1.png readme pics 2026-02-13 00:20:44 -08:00
image.png readme pics 2026-02-13 00:20:44 -08:00
LICENSE chore: initialize beadboard baseline 2026-02-11 17:42:51 -08:00
next-env.d.ts Add tracer-bullet Kanban baseline with live issues read path 2026-02-11 17:55:26 -08:00
next.config.ts feat: establish tokenized kanban design foundation 2026-02-11 18:38:51 -08:00
package-lock.json feat(ui): Enhance Graph and Kanban UX (bb-18e) 2026-02-12 23:37:27 -08:00
package.json docs(beads): etch project history into memory bank and finalize skill-bb 2026-02-14 00:21:25 -08:00
postcss.config.js feat: establish tokenized kanban design foundation 2026-02-11 18:38:51 -08:00
README.md readme pics 2026-02-13 00:20:44 -08:00
tailwind.config.ts Persist root UI/tailwind/responsive guard refinements from stash backlog 2026-02-11 21:25:46 -08:00
tsconfig.json chore: initialize beadboard baseline 2026-02-11 17:42:51 -08:00

README.md

BeadBoard

The Windows-native Control Center for Beads.

BeadBoard is a high-performance local dashboard for managing your software development tasks. Built on the Beads protocol, it provides a unified, visualization-rich interface over your distributed project landscape. alt text

🚀 Why BeadBoard?

Most task managers are siloes. BeadBoard is a lens over your source code.

  • Source of Truth: Reads directly from .beads/issues.jsonl in your repo. No database sync skew.
  • Windows Optimized: Built from the ground up to handle Windows paths, drive letters, and filesystem performance.
  • Zero Latency: Optimistic UI updates make interactions feel instant.

✨ Core Features

1. Multi-Project Registry & Scanner

Stop context switching between repos.

  • Project Registry: Persist your favorite project roots for one-click access.
  • Auto-Discovery: Built-in filesystem scanner finds Bead-enabled projects across your drives.
  • Aggregate Mode: View tasks from all registered projects in a single unified board.

2. Interactive Kanban Dashboard (/)

Manage your flow state. Kanban Dashboard

  • Live Updates: Boards refresh automatically when the underlying JSONL files change (e.g., via CLI).
  • Progressive Disclosure: Task details, metadata, and relations are tucked away until you need them.
  • Smart Filtering: Filter by priority, assignee, status, or full-text search across thousands of beads.

3. Dependency Graph Explorer (/graph)

Understand the "Why" and "What's Next". alt text

  • Epic-Centric Layout: Automatically groups tasks by Epic for logical clustering.
  • True DAG Visualization: Uses Dagre layout engine to enforce a strict Left-to-Right dependency flow.
    • Left: Incoming Blockers
    • Center: Focus Task
    • Right: Unlocks / Downstream
  • Focus Mode: Minimizable dependency strip and deep-linking support for sharing exact views.
  • Smart Metadata: See bead counts, priorities, and status health at a glance.

🛠️ Stack

  • Framework: Next.js 15 (App Router)
  • UI Engine: React 19 + Framer Motion
  • Styling: Tailwind CSS + Custom Design System
  • Type Safety: Strict TypeScript

⚡ Quick Start

  1. Install: npm install
  2. Run: npm run dev
  3. Explore: Open http://localhost:3000

🤝 Contribution

  • Typecheck: npm run typecheck
  • Test: npm run test