Whiteboard: Een open-source IDE voor doordacht softwareontwerp

Whiteboard integreert met tools die je al gebruikt — zoals Claude Code, Codex, etc. — en biedt je agent een SDK om op een canvas in de app te tekenen om diens werk te beschrijven.

Een demo-video van 1 minuut waarin meer wordt uitgelegd is te vinden hier: https://www.youtube.com/watch?v=ChPn3ftULWE

Snelstart

  1. Download Whiteboard en open de applicatie.
  2. Verbind Claude Code, Codex, of een andere coding-agent via het welkomstscherm.
  3. Vraag je agent om je huidige branch te reviewen tegenover de meest actuele main branch en open het resultaat in Whiteboard.

Richtlijnen

Op basis van onze ervaring werkt Whiteboard het beste met modellen zoals GPT-6 Luna en Claude Opus 5.5, vanwege de balans tussen intelligentie, kosten en snelheid.

Hieronder volgen enkele voorbeeldprompts om Whiteboard effectief te gebruiken. We werken hard om ervoor te zorgen dat de juiste keuzes standaard in de systeemprompt zijn ingebakken (een van de redenen waarom dit systeem open source is), maar in de tussentijd kun je het volgende gebruiken:

Voor een nieuwe API-wijziging:

"Hé, deze reeks commits is zo opgezet dat ik een [api] kan maken om [doel] te bereiken. Ik zou graag het volgende willen zien:
* voorgestelde api
* voorbeelden
* motivaties hiervoor (indien beschikbaar in de context/in de repo)
Daarna kunnen we dieper ingaan op de implementatie en de uitleg over hoe de zaken werken."

Voor een wijziging om telemetrie toe te voegen:

"Kun je me de telemetrie-wijzigingen uitleggen uit de nieuwste PostHog PR [link naar commit] — wat tracken we, hoe kunnen we hier goede dashboards of product waterfalls van bouwen? Wat doen we voor hangs, errors, crashes etc... gebruik whiteboard"

Als je iets ziet dat je niet bevalt, markeer dit dan in je klembord en geef het aan je agent; deze kan het vervolgens op het Whiteboard aanpassen aan jouw behoeften.

Waarom bestaat dit?

Diagrammen die leiden naar code

Pure HTML-tools boden geen eenvoudige mogelijkheden om een specificatie of diagram te verbinden met code; dit is extra lastig omdat afwegingen vaak pas worden ontdekt na een eerste implementatiepoging. In Whiteboard kun je direct naar de onderliggende code springen wanneer je klikt op visualisaties zoals een sequentiediagram, een entity-relationship diagram, of een citaat uit de trace van de agent. Bij het navigeren door code krijg je direct de sneltoetsen en LSP-ondersteuning van VSCode.

Semantische diff-viewer

Ruwe diff-weergaven kunnen erg onoverzichtelijk zijn. Daarom hebben we in Rust een semantische, AST-aware diff-viewer geschreven, zodat je alleen de codewijzigingen ziet die voor jou relevant zijn. We hebben enkele logische standaardinstellingen geconfigureerd: grote toegevoegde functies worden samengevat als pseudocode, en zaken als unit tests en documentatiewijzigingen worden ingeklapt of verborgen. Dit is volledig aanpasbaar via een WASM-gebaseerd pluginsysteem.

Beslissingslogboek

We merkten dat het lastig was om te redeneren over welke set beslissingen onze agenten autonoom hadden genomen en hoe dat een wijziging beïnvloedde. Daarom hebben we tools gebouwd waarmee agenten hun eigen traces op het Whiteboard kunnen opvragen en koppelen. Zo kun je de eisen die je hebt gesteld visualiseren, begrijpen hoe deze zijn geïmplementeerd en inzien welke beslissingen de agent autonoom heeft genomen.

Open source, op je eigen machine

Whiteboard is gelicenseerd onder MIT en werkt met je lokale checkouts. Er is een hosted product voor teams gepland, maar alles zal altijd self-hostable blijven.

Bekende beperkingen

  • Je kunt momenteel geen bestanden bewerken in Whiteboard. Als dit een gewenste functie is, dien dan een issue in.
  • Het werken met en browsen door bestanden over meerdere repositories in een enkele review wordt nog niet goed ondersteund.
  • Hoewel je reviews tussen machines kunt delen via de deelknop, verschijnen updates die na het delen zijn gemaakt niet voor anderen. Je zult de review opnieuw moeten delen.

Bijdragen

Bijdragen en feedback zijn welkom. Lees CONTRIBUTING.md voor de setup en de pull request workflow, en volg de Code of Conduct. Meld kwetsbaarheden zoals beschreven in SECURITY.md. Vragen? Stel ze op Discord.

Privacy

Whiteboard werkt met lokale checkouts. Anonieme telemetrie bevat geen code, diffs, Whiteboard-tekst, prompts of model-output. Lees het privacy-overzicht, inspecteer de volledige telemetrie-referentie, of schakel telemetrie op elk gewenst moment uit.

Licentie

Whiteboard is beschikbaar onder de MIT-licentie. De geïntegreerde Code-OSS fork behoudt de MIT-licentie van Microsoft en third-party meldingen; zie apps/review-desktop/LICENSE en apps/review-desktop/UPSTREAM.

Over het gebruik van Code OSS

Omdat iedereen gespecialiseerde agent-TUI's en desktop-apps gebruikt, gebruiken we onze teksteditors nu alleen nog voor het reviewen van regel-voor-regel diffs. We dachten daarom: waarom niet een teksteditor maken die specifiek bedoeld is voor het reviewen van code? In dat geval was het logisch om te beginnen met de meest succesvolle open source editor als basis.

We maken gebruik van Code OSS (vendoring), in tegenstelling tot andere forks die patches bijhouden, omdat coding-agents moeite hebben met patches en er veel zaken in de standaard VS Code zitten (bijv. ongeveer 45% van de codebase is tegenwoordig Copilot) die we niet nodig hebben.

We monitoren regelmatig de upstream Code OSS en mergen security- en feature-patches zodra deze beschikbaar komen.

Invloeden