Case study

beads-reader

A dispatch cockpit for coding-agent workers, built test-first over a distributed issue tracker.

GoTypeScriptReactPWA

From issue tracker to dispatch cockpit

beads-reader is a Go and React dashboard over a distributed issue tracker. An operator can launch coding-agent workers against tracked issues from the UI, then verify the receipts of what those workers actually did — the dashboard doesn’t just display work, it dispatches and checks it.

Built test-first, shipped small

  • ~28K LOC total, with more test code than source in both languages: 8,440 Go test lines against 4,750 source lines, and ~7,600 TypeScript test lines.
  • Ships as a single embedded binary; installable on a phone as a PWA.
  • The tracker CLI stays the source of truth — snapshots and real-time updates are derived from it, never written around it.

Why it matters

Agent-era tooling has to prove what happened, not just show status. beads-reader’s dispatch-and-verify loop and its test-heavy build are the same discipline applied at two levels: the tool checks its agents, and the test suite checks the tool.

Availability

The code is private; a walkthrough is available on request.

← All work