devdotfast /whiteboard
open-source canvas for thoughtful software design
★ 3,536⑂ 183👁 3⑃ 1,361● 64▤ 36
+2
日增长
+58
周增长
3,536
stars
183
forks
3
watchers
1,361
prs
64
issues
36
releases
README
Whiteboard
an open-source canvas for thoughtful software design
Download for macOS, Windows, and Linux ·
Website ·
Roadmap ·
Discord
Whiteboard is an open-source desktop app where humans and agents can architect software together in a common workspace.
Whiteboard plugs into the tools you already use - e.g. Claude Code, Codex, etc. – and gives your agent an SDK to draw on an in-app canvas to describe its work.
Here’s a 1 min demo video explaining more: https://www.youtube.com/watch?v=ChPn3ftULWE
Quickstart
1. Download Whiteboard and open the app. On macOS
you can also run brew install --cask devdotfast/tap/whiteboard.
2. Connect Claude Code, Codex, or another coding agent from the welcome screen.
3. Ask your agent to review your current branch against up-to-date main and
open the result in Whiteboard.
Guidance
In our experience, Whiteboard works best with models like GPT-6 Sol and Claude Opus 5.5 for their intelligence, cost, and speed tradeoff.
Here are a few example prompts of how to use Whiteboard effectively. We are working hard to make sure the right choices are baked in by default to the system prompt - part of why this system is open source! - but in the meantime:
For a new API change
hey, this stack of commits is set up so i can get an [api] to do [objective]
i'd like to see:
- proposed api
- examples
- motivations for this (if available to you in context/in the repo)
and then we can dive into implementation + explaining how things worked.
For a change to add telemetry:
Can you explain to me the telemetry changes from the newest posthog pr https://github.com/devdotfast/whiteboard/commit/4837e107946e27ebad50c282eb0f2585210d2a35 -- what are we tracking, how can we build good dashboards or product waterfalls from it? what do we do for hangs, errors, crashes etc... use whiteboard
If you see anything you don't like, highlight it in your clipboard and give it your agent, and it can re-draw on the Whiteboard to suit your needs!
Why does this exist?
Diagrams that lead to code
Pure HTML tools didn’t provide easy affordances to connect a spec or diagram to code; this is especially tricky since tradeoffs are often only discovered after a first pass at implementation. In Whiteboard, when you click on visualizations like a sequence diagram, an entity relationship diagram, or a quote from the agent’s trace, you can jump to the underlying code directly. When navigating code, you get keybindings and LSP support from VSCode out of the box.
Semantic diff viewer
Raw diff views can be very noisy, so we wrote a semantic, AST-aware diff viewer in Rust so you can only view the code changes which are relevant to you. We’ve set up some sane defaults: large added functions are summarized as pseudocode, and things like unit tests and documentation changes are collapsed / hidden. This is all customizable with a WASM-based plugin system.
Decision log
We found it difficult to reason aTop issues
#829Issues From First Run Inside Dev Container8 comments · 2026-10-01#1218Native BYOK support for visual reviews and Ask without an external coding agent2 comments · 2026-10-16#1091Privacy page missing2 comments · 2026-10-12#1499Bring back batch review comments in Diff view1 comments · 2026-11-03#1454Feature Request: Cursor support1 comments · 2026-10-30#1092Add Kotlin as an optional language group in Whiteboard Desktop1 comments · 2026-10-12#1090Feature request: Github Comments1 comments · 2026-10-11#1000wip: improve search highlight experience1 comments · 2026-10-07
Discussions
#1543Access control for share links (restrict to specific people / org / repo collaborators)0 comments · 2026-11-13#1196remote hosts feedback and suggestions0 comments · 2026-10-16#879ask agent feedback and suggestions0 comments · 2026-10-02#987Support for plugins as new tab3 comments · 2026-10-01#986Support for tauri and web embedding like tldaw.3 comments · 2026-10-01#812Whiteboard roadmap and feedback4 comments · 2026-09-30
Latest release
Whiteboard 0.5.2 v0.5.2 2026-11-09-- First of all, sorry about popping the toast and the update badge, its fixed in this version! Animations: tours, clips and previews (experimental, off by default) - An animation whose frames carry code gets a tour: Expand becomes Tour, and the panel and frames move together (1483). - Animations paint in as they stream instead of popping in (1483). - New clip block: one continuous timeline you play, pause and jump around by markers (1483). - Scene cards can take a form (window, bars, cylinder…), an outline and a colour, so a database reads differently from a service (1498, 1
News & coverage (6)
Hacker NewsShow HN: Whiteboard (YC W26) – An open-source IDE for thoughtful software design▲ 424 · 143 comments · 2026-09-24YouTubeWhiteboards that live in Git: Folio boards2026-10-02Brown Daily HeraldGet to know the election-result prediction model developed by Brown students2024-09-27Gonzo MLChain-of-Thought → Whiteboard-of-Thought2024-07-15DataDrivenInvestorNo Whiteboard: Hiring Companies That Don’t Require a Coding Test2022-01-06DiceWhiteboard Interviews Absolutely Terrify You: Survey2018-10-17