Development & Automation

Whiteboard: An Open-Source Review Tool That Links AI Coding Agent Designs to Code.

Whiteboard is a free open-source desktop app where Claude Code and Codex leave designs and decision records on a canvas, and you review the linked code and AST-aware diffs from the diagrams.

· Huuush

Whiteboard: An Open-Source Review Tool That Links AI Coding Agent Designs to Code

Key takeaways

  1. 1Whiteboard is an MIT open-source app that links the designs and decisions coding agents like Claude Code and Codex leave on a canvas to real code review.
  2. 2You jump from diagrams and traces to code, and use the Decision Log and a Rust-based AST-aware diff to see the context of a change.
  3. 3Installers are available for macOS, Windows, Ubuntu, and Fedora, and agents connect through MCP. Editing files in the app and multi-repo review are limited.
Whiteboard screen where selecting a sequence diagram shows its linked code

Whiteboard is an open-source desktop app where an AI coding agent draws and explains its work on a canvas, and a person clicks a design diagram or decision record to jump straight to the related code and review it. You connect it to tools like Claude Code and Codex, and it was built by Sid, Alex, Ketan, and Milan of /dev/fast, a YC W26 team. It was released on Hacker News as a Show HN on September 25, 2026 (Korea time), and it is free to use under the MIT license.

Source: YouTube devfast (yc w26), 2026-09-24 17:50 KST

How Whiteboard connects design and code

Whiteboard provides an SDK and MCP connection so an agent can write designs and work notes on the canvas inside the app. The team wanted to bring back, for agent work, the experience of understanding a system together with another developer at a whiteboard. If you understand the role of AI agents and MCP, this connection approach is easy to follow.

Jump from a diagram straight to code

Click a citation point in a sequence or ER diagram or in an agent trace, and it takes you to the related code location. The editor is based on Code OSS, so it uses your VS Code key bindings and LSP as they are.

Sequence diagram and linked code screen from the Whiteboard demo
Source: GitHub devdotfast/whiteboard

The agent's decision log and AST-aware diff

The decision log started from the problem that it is hard to tell how decisions an agent made on its own, and their effects, led to code changes. You can look at requirements, implementation, and the decisions the agent made independently, tied to the trace.

The AST-aware diff viewer, built in Rust, shows changes by syntax unit. By default, it summarizes large added functions as pseudocode and collapses or hides unit test and documentation changes. You can change how things are displayed with WASM plugins.

Install it and connect your coding agent

You can get the app from the official install page. v0.1.3, released on September 26, 2026, provides a macOS Apple Silicon DMG, a Windows installer and ZIP, an Ubuntu .deb, and a Fedora .rpm.

  1. Install and launch the app.
  2. On the first screen, connect the coding agent you use, such as Claude Code or Codex.
  3. For example, ask, "Review the current branch against the latest main and open it in Whiteboard."

The connection uses MCP. The Claude Code plugin runs ~/.local/bin/whiteboard mcp as a stdio server, and the Codex plugin uses the bundled whiteboard-mcp. Cursor can also register the local whiteboard mcp command. Before writing, the agent calls whiteboard api session_get_instructions '{}' to get the app's latest writing instructions.

The repo README recommends GPT-6 Sol and Claude Opus 5.5. If you are reviewing a new API change, you can ask something like, "Show the API you proposed, a usage example, and why you designed it that way in a diagram." For a part you do not like, you can copy it and pass it to the agent to ask it to redraw. To run it for development yourself, get Node.js 24 and pnpm 11 ready and run pnpm install and pnpm dev. The post on Google's AI agent runtime, AX also helps with looking at related agent runtime environments.

Free MIT app and a plan for team hosting

The desktop app is free open source under the MIT license and runs on a local checkout. Anonymous telemetry does not include code, diffs, prompts, or model output, and you can turn it off in settings. A team hosting version with session management, trajectory storage, and multiplayer review is in the works as a paid product, and the team plans to keep supporting self-hosting. The GitHub repo had 1,972 stars as of September 28, 2026, and commits were still landing the same day.

What to know before you use it

  • You cannot edit files directly inside the app.
  • Handling several repositories together in one review is still limited.
  • If you edit a shared review, the change does not automatically show up on the other person's screen, so you need to share the updated version again.

How to put a whole marketing team into your AI agent

Sources

Frequently asked questions

What kind of tool is Whiteboard?
It is an open-source desktop app that gathers the designs and decision records an AI coding agent wrote onto a canvas, and lets you jump from each item to the related code for review.
Which coding agents can I connect?
It provides Claude Code and Codex plugins, and you can also connect Cursor and others through MCP.
Is Whiteboard free?
The desktop app is free under the MIT license. A team hosting version with session management and multiplayer review is in the works as a paid product.
Which operating systems does it support?
v0.1.3 provides installers for macOS Apple Silicon, Windows, Ubuntu, and Fedora.
What are the current limitations?
You cannot edit files in the app, and handling several repositories in one review is limited. After sharing, you must share edits again for the other person to see them.

Related articles