How devdotfast/whiteboard works
Whiteboard is a desktop workspace for humans and coding agents to create and inspect software reviews. An agent connects through the review interface, contributes diagrams and trace context, and the desktop presents the result alongside code and semantic diffs. Users can follow visualizations to source, inspect agent decisions, and share reviews. The README documents major capabilities; the sampled files show selected UI, protocol, trace-storage, and diff components, so some subsystem links below are documented rather than verified in implementation.
Main entry points: App.tsx Review UI · review-client.ts Review client · agent-client.ts Agent review API · reviewDiffViewService.ts Semantic diff
Components 18
Review workflow
- Review client
packages/review/app/src/host/review-client.ts - Review protocol
packages/review-protocol/src/review-api-client.ts - Agent review API
packages/review/src/review-api/agent-client.ts - Review services
packages/review/src/server
Desktop experience
- Review UI
packages/review/app/src/App.tsx - Review session
packages/review/app/src/host/review-session.tsx - Code editor
apps/review-desktop/code-oss/src/vs/review/browser/reviewPaneCompositePartService.ts
Code analysis
- Semantic diff
apps/review-desktop/code-oss/src/vs/review/services/reviewDiffViewService.ts - Diff viewer
packages/review/app/src/App.tsx - Local VCS
packages/local-vcs/src/vcs.ts
Agent traces
- Trace handling
packages/trace-core/src/review-agent-traces.ts - Trace storage client
packages/trace-core/src/store-client.ts - Trace store API
packages/trace-protocol/src/store-api.ts
Review sharing
- Share client
packages/review/src/sharing/client.ts - Share routes
packages/review/src/sharing/routes.ts - Shared review
Other components
- Human reviewer
- Coding agent
Connections 18
- Human reviewer → Coding agent: requests review
- Coding agent → Review UI: opens result
- Coding agent → Agent review API: submits review
- Review UI → Review session: uses session
packages/review/app/src/App.tsx - Review UI → Review client: uses client
packages/review/app/src/App.tsx - Review client → Review protocol: calls protocol
packages/review/app/src/host/review-client.ts - Agent review API → Review services: serves requests
- Review UI → Diff viewer: renders diff
packages/review/app/src/App.tsx - Diff viewer → Semantic diff: shows changes
- Semantic diff → Local VCS: compares revisions
- Human reviewer → Code editor: navigates source
- Coding agent → Trace handling: records decisions
- Trace handling → Trace storage client: stores traces
- Trace storage client → Trace store API: uses store API
packages/trace-core/src/store-client.ts - Review UI → Share client: shares review
- Share client → Share routes: uses routes
- Share routes → Shared review: publishes review
- Shared review → Human reviewer: opens review