Whiteboard é um app de desktop open source para revisar o código que seu agente de IA escreve com diagramas de sequência conectados ao código, diffs resumidos e um registro das decisões que o agente tomou por conta própria. Foi criado pela /dev/fast, uma startup de YC W26, e funciona junto com Claude Code e Codex em vez de substituí-los. Tem licença MIT e roda em macOS e Linux.
Status no momento da publicação desta nota (25 de setembro de 2026): Whiteboard está marcado como beta, a versão mais recente é a v0.1.2 e saem versões novas várias vezes por semana. Verifique o repositório antes de seguir os passos abaixo.
Que problema Whiteboard resolve?
Resolve a distância entre a rapidez com que seu agente escreve código e a rapidez com que você consegue entendê-lo. Seus fundadores são quatro ex tech leads que bateram com essa parede em seu próprio projeto. À medida que mais PRs escritos por agentes eram mergeados sem que ninguém os entendesse completamente, começaram a sentir o que chamam de “dívida cognitiva” (cognitive debt). Chegou um ponto em que era difícil contribuir para seu próprio código.
Se isso soa familiar, é o mesmo problema que tratamos em A Nova Dívida Técnica Não Está no Código. Whiteboard é uma tentativa concreta de resolvê-lo. A ideia é recriar a sessão em frente a um quadro branco com outro desenvolvedor, da qual você sai entendendo de verdade o sistema.
O que é Whiteboard?
Whiteboard é um ambiente de code review com um canvas integrado. Não é outro agente de código. Você continua usando Claude Code, Codex ou o agente que já tem. Whiteboard fornece a esse agente um SDK para que ele desenhe em um canvas dentro do app uma descrição do seu próprio trabalho.
Por dentro é uma cópia vendorizada de Code OSS, a base open source do VS Code. Quando você pula de um diagrama para o código, tem os atalhos de teclado e o suporte LSP do VS Code sem precisar configurar nada. O time vendoriza Code OSS em vez de manter patches por cima, e diz que incorpora regularmente os patches de segurança do upstream.
Um detalhe importante: você não consegue editar arquivos em Whiteboard, pelo menos na v0.1.2. É um lugar para ler e revisar, não para escrever.
O que Whiteboard mostra que um diff normal não mostra?
Mostra três coisas que uma visualização de diff normal não oferece.
Diagramas de sequência e diagramas entidade-relacionamento conectados ao código
O agente pode desenhar diagramas de sequência (sequence diagrams) e diagramas entidade-relacionamento (ER diagrams) da mudança que fez. Um diagrama de sequência mostra passo a passo como os componentes de um fluxo se comunicam. Um diagrama entidade-relacionamento mostra as tabelas de dados e como elas se relacionam. Clique em uma etapa do diagrama de sequência e você chega às linhas exatas que a implementam. O mesmo acontece com as citações do trace do agente, que é o registro do que ele fez durante a sessão.
Os fundadores começaram com artefatos HTML e os abandonaram por essa razão. Um diagrama estático é difícil de conectar com o código, e os trade-offs quase sempre aparecem apenas após uma primeira implementação.
Um diff semântico em vez de um linha por linha
Whiteboard inclui um visualizador de diffs escrito em Rust que entende a estrutura do código, não apenas linhas de texto. É o que em inglês se chama semantic diff, e a biblioteca é open source: diffr. De início:
- funções novas grandes são resumidas como pseudocódigo, que você pode expandir para o código real;
- as assinaturas das funções sempre ficam visíveis;
- as mudanças em testes e documentação são colapsadas ou ocultadas.
Tudo isso pode ser personalizado com plugins em WASM.
Um registro das decisões do agente
É o decision log: um registro de quais requisitos você definiu e quais decisões o agente tomou sem perguntar. Os agentes podem consultar seus próprios traces e vinculá-los ao whiteboard. Assim você pode verificar se uma instrução como “use uma única transação para o histórico e o estado de retomada” chegou de verdade à implementação, e detectar as decisões que ninguém pediu.
Como instalar Whiteboard e começar a usá-lo com Claude Code ou Codex?
Você baixa o app, conecta seu agente e pede uma revisão. O README documenta três etapas:
- Baixe Whiteboard em install.dev.fast e abra o app.
- A partir da tela de boas-vindas, conecte Claude Code, Codex ou outro agente de código.
- Peça ao seu agente que revise sua branch atual contra um
mainatualizado e que abra o resultado em Whiteboard.
Essa é toda a configuração que o projeto documenta. No momento da publicação desta nota não há um site de documentação separado, apenas o README e um servidor do Discord. As notas de versão também mostram que o suporte para OpenCode chegou na versão 0.0.32.
Os prompts de exemplo do README sugerem uma abordagem conversacional. Para uma mudança de API, conte ao agente o que seus commits buscam alcançar. Depois peça que ele apresente a API proposta, exemplos e a motivação, e somente então que ele explique a implementação.
Se algo do canvas não funciona para você, selecione e copie. Whiteboard deixa a seleção em sua área de transferência. Cole no chat do seu agente e peça que ele redsenhe.
Whiteboard funciona no Windows?
Não. No momento da publicação desta nota, Whiteboard só roda em macOS e Linux, e o único build para Linux é para Fedora. Um dos fundadores disse no Hacker News que outras distribuições podem ser solicitadas. Não há build para Windows nem um plano anunciado para tê-lo.
Whiteboard é gratuito?
Sim. O app de desktop tem licença MIT, é gratuito e funciona com suas cópias locais do git. O site anuncia uma versão hosteada para times como “em breve”. No Hacker News, um dos fundadores foi menos categórico: por enquanto o app é gratuito, open source e apenas local, e ainda estão decidindo sobre a versão hosteada. O time diz que o que construir continuará sendo auto-hospedável.
O app coleta telemetria anônima. Segundo o projeto, não inclui seu código, seus diffs, seus prompts nem a saída do modelo, e você pode desativá-la.
Por que não pedir ao agente um diagrama em Mermaid?
Essa foi a crítica mais forte no thread do Show HN. Um diagrama em texto que seu agente escreve em um arquivo não custa nada e não requer um app novo. Um comentarista também argumentou que Whiteboard é na verdade uma única funcionalidade (um servidor com uma interface gráfica em cima) do que um produto completo.
A diferença é a conexão com o código. Um arquivo Mermaid é uma imagem. No Whiteboard, um passo de um diagrama de sequência é um link para um intervalo de linhas, com um editor e LSP por trás. Além disso vêm o diff semântico e o registro de decisões, que um arquivo de diagrama não te dá. Se vale a pena depende de quanto código escrito por agentes você de verdade revisa. Leve em conta também que um comentarista reportou que o download para macOS pesa 736 MB.
Como o Whiteboard se encaixa com a revisão de código automática?
Whiteboard lida com as mudanças que precisam de uma pessoa, e um revisor automático cuida do resto. Os fundadores sugerem combiná-lo com um revisor automático como Greptile. As mudanças pequenas são revisadas automaticamente, e as que exigem critério humano escalam para uma sessão de Whiteboard.
É o oposto de ferramentas em que um agente revisa outro. Cobrimos essa abordagem em Como fazer code review com Claude Code e outros agentes com Open Code Review. Whiteboard é para o momento em que você precisa entender a mudança você mesmo.
Os fundadores dizem que equipes da Salesforce e Modal já o usam para revisar mudanças de arquitetura e especificação. É uma afirmação do próprio time e não foi verificada independentemente.
Que limitações o Whiteboard tem hoje?
O README as enumera abertamente:
- Você não pode editar arquivos. Os fundadores dizem que estão avaliando uma função de edição, mas ainda não definiram como deveria funcionar.
- Revisões que abrangem vários repositórios não são bem suportadas.
- Revisões compartilhadas não se atualizam. Se você compartilha uma revisão e depois a muda, os outros não verão as mudanças até que você a compartilhe novamente.
Some a isso a etiqueta beta, os builds só para macOS e Fedora, e um ritmo de versões tão rápido que o que se escreve hoje pode ficar desatualizado em semanas.
Vale a pena testar o Whiteboard?
Teste se você usa macOS ou Fedora e já deixa um agente escrever funcionalidades completas. Whiteboard não faz o agente escrever código melhor. O que faz é reduzir o custo de entender esse código antes de fazer merge, e é justamente aí onde a maioria de nós está ficando para trás. Se você só precisa gerar diagramas de arquitetura do zero, Archify se encaixa melhor.