Planning and synthetic demo¶
From the repository root (Node 26):
pnpm --dir dashboard install --frozen-lockfile
pnpm --dir dashboard build
node dashboard/dist/cli.js serve --fixture
The default browser address is http://127.0.0.1:8766. No private overlay is read in fixture mode and session planning is disabled. No model or cloud account is needed. For an extended, fully invented portfolio on a separate port:
node dashboard/dist/cli.js serve --jsonl dashboard/fixtures/beads.demo.jsonl --port 8876
Do not pass a private config for this demo. It contains 73 issues across 12 invented projects: open, in-progress, blocked, closed and deferred tasks; quarter-boundary completions; one undated closure; one conflicting plan; and an excluded epic. Expected quarterly counts: Q3 planned 71 / completed 12; Q4 planned 0 / completed 11; unknown closure 1; conflicting plan 1.
The original 30-issue fixture is retained and enriched with quarter labels. The extended fixture was constructed independently, never scrubbed from real exports.
Using plans¶
Use an explicit ignored dashboard/dashboard.json overlay with project ids and local repository paths. Only configured Git repository roots can receive plans. Save records the current commit and dirty status; Cancel changes only the plan. No process starts. Runtime records live in ignored dashboard/data/.
Claude Code can work directly in an owning repository. Update its existing Beads tracker after acceptance, then reload the dashboard. File-based snapshots must be re-exported by their producer. No hooks are installed globally.
Experimental qualification¶
The optional scripts/qualify-local.py and scripts/qualify-runner.py use temporary synthetic files on macOS. Supply --expected-version explicitly, --output to a private directory, and --model for the model probe. They do not download models or authorize real execution. The adapter requires an explicit runtime contract. No machine-specific qualification results are shipped.
Roadmap and measurement¶
Quarter labels express current intent, not immutable commitments. Closed counts use UTC closure timestamps; missing timestamps remain unknown. Epics are excluded. Human time, agent runtime, historical throughput and cycle time need separate explicit records. Next steps: optional session links with idempotent events, reviewed quarter baselines, manual time entries and only then historical charts. A Claude Stop event is not task acceptance. Personal and work trackers stay separate.