plannotator coloca um ponto de checagem humano na frente de cada diff de agente

Existe um momento específico no desenvolvimento assistido por agentes em que as coisas pioram em vez de melhorar. O agente termina uma tarefa, imprime um resumo e pede para você aceitar. Você rola a tela. O diff tem quatrocentas linhas. Você aprova, porque ler de verdade levaria mais tempo do que ter escrito sozinho.
plannotator, um projeto com cerca de 10.500 estrelas e subindo rápido esta semana, é uma tentativa de consertar esse momento. É uma superfície de revisão local, no navegador, que se acopla a um agente de código e abre quando o agente tem algo para decidir. Você marca o plano, o documento ou o diff, e seus comentários voltam ao agente como próxima entrada.
O slogan é sobre ficar no loop. A arquitetura é sobre algo mais estreito e mais útil: transformar a atenção humana em uma etapa de fato, em vez de uma opção.
Como ele se conecta
Ele não substitui o seu agente. Ele se pluga em um. O README lista Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp, DeepSeek Harness e Pi, e a Inbox também funciona com assistentes pessoais como Grok Bot, Muse, Hermes e OpenClaw. A conexão passa pelos plugins, hooks e comandos de cada harness, e é por isso que a profundidade da integração varia conforme a ferramenta.
Os comandos têm o formato conhecido:
/plannotator-review # uncommitted changes
/plannotator-review <github-pr-url> # a pull request
/plannotator-annotate README.md # a file
/plannotator-annotate https://docs.rs # a URL
/plannotator-last # the agent's last message
plannotator inbox # the queue
No Codex, os comandos de barra viram `!plannotator ...` ou os skills empacotados. O modo plano não precisa de comando nenhum: ele está ligado nos hooks de cada harness, então quando o agente escreve um plano, a superfície de revisão abre sozinha. Esse detalhe importa mais do que parece. Um ponto de checagem que depende de você lembrar de chamar é um ponto de checagem que fica de fora nos dias em que você está ocupado, e são esses os dias em que ele importa.
A revisão cobre Git, GitButler, Jujutsu, Perforce, GitHub e GitLab, então a superfície não fica presa a um único forge. Você comenta linhas, sugere código, e os comentários voltam ao agente em vez de irem para uma thread de PR que ninguém lê.
A caixa de entrada é a parte interessante
Revisão com um único agente é um problema resolvido com uma solução entediante: abrir um diff e deixar comentários.
A Inbox é o que o time construiu para a situação em que a maioria das pessoas está de fato, que é vários agentes rodando ao mesmo tempo. É uma janela local onde os agentes deixam mensagens, perguntas, arquivos e revisões guiadas enquanto continuam trabalhando. Você responde uma pergunta com um clique, anota um arquivo e aperta enviar quando chega a hora. Nada mantém uma sessão de agente aberta enquanto isso, e sua resposta volta para a sessão que perguntou.
Essa única frase resolve um impasse real. O padrão comum do human-in-the-loop é o agente parar e esperar. Com um agente, tudo bem. Com quatro, você é o processo mais lento do sistema, e três deles queimam contexto enquanto você termina o almoço. Uma caixa de entrada assíncrona deixa o agente estacionar a pergunta em vez da sessão.
Claude Code, Pi e OpenCode se conectam por plugins, então as respostas chegam no turno seguinte. Todo o resto chega por MCP com `plannotator inbox mcp`, e `plannotator inbox --help` também serve de documento que o agente lê para aprender o protocolo. É uma peça pequena de design com efeito grande: o texto de ajuda é a especificação de integração.
Por que um navegador, e por que local
Um diff no terminal é bom para ler código e ruim para ler qualquer outra coisa. Revisar uma especificação de produto, um mockup HTML ou um relatório renderizado no pager é um exercício de apertar os olhos, e os agentes hoje produzem essas três coisas com frequência. Renderizá-las no navegador e deixar quem revisa colocar marcações sobre o resultado é a superfície certa para esse tipo de artefato.

A seção de privacidade do README é incomumente específica para uma ferramenta desse tamanho, e vale citar o conteúdo em vez de resumir. Não há telemetria. Planos, diffs, anotações, rascunhos e histórico ficam locais por padrão. Cada superfície consulta o GitHub pela última versão ao carregar, e essa checagem não pode ser desligada. A revisão Git local pode rodar `git ls-remote` contra o seu origin configurado para detectar o branch padrão e uma base desatualizada, e essa consulta dispara quando a revisão abre, quando o diff carrega, quando você troca de base e quando aperta fetch. Uma página de revisão ociosa não faz nenhuma chamada de rede, o que é uma promessa mais forte do que a da maioria das ferramentas.
O conteúdo sai da máquina apenas quando um recurso de rede precisa dele: a anotação de URL busca a página, a revisão do GitHub usa sua CLI autenticada, o Ask AI envia a pergunta selecionada e o contexto para o provedor configurado, e o compartilhamento sobe texto cifrado para um serviço de paste.
Para uma ferramenta que fica em cima do código-fonte, esse nível de transparência é o instinto certo. O modo de falha típico do tooling para agentes é o ajudante prestativo que manda seu repositório para um servidor sem avisar, e a única defesa do usuário é um mantenedor que documenta as fronteiras antes de ser perguntado.
A implicação desconfortável
Tudo neste projeto é uma aposta de que a restrição do trabalho com agentes é a largura de banda de revisão humana, e não a capacidade do modelo.
A aposta me parece correta. As pessoas que conheço e que rodam vários agentes passam o dia lendo: planos, diffs, saída de testes, resumos do que o agente acha que fez. A parte de geração é rápida e está ficando mais rápida. A parte de verificação é limitada pela velocidade com que uma pessoa lê e decide.
Há um efeito de segunda ordem que vale nomear. Uma superfície de revisão que captura decisões cria um registro delas. plannotator tem um comando archive que navega em modo somente leitura pelas decisões de plano salvas, e as anotações persistem no diretório de dados, então revisões de terminal e revisões do app se acumulam no mesmo lugar. Quando você tem algumas centenas de planos aprovados com os comentários que os moldaram, você possui algo que nenhuma sessão individual contém: uma descrição de como o seu time decide.
Esse é o ativo. O visualizador de diff qualquer um constrói. O rastro do raciocínio, não.
Onde ainda dói
Duas coisas, ambas inerentes.
A primeira é que ferramentas de revisão melhoram a revisão, e revisão não é a mesma coisa que correção. Uma aprovação bem anotada de uma arquitetura ruim continua sendo a aprovação de uma arquitetura ruim, e uma superfície arrumada faz aprovar parecer diligência. A Inbox em especial facilita esvaziar uma fila, e esvaziar uma fila é um comportamento diferente de entendê-la.
A segunda é que a ferramenta adiciona um navegador, um servidor local e uma camada de hooks a um fluxo que antes era um terminal. São três coisas a mais para quebrar, e quando um hook quebra a falha é silenciosa: o agente segue sem o ponto de checagem, e você descobre depois.
Os dois são custos aceitáveis pelo que se compra, que é um lugar para a pessoa ficar. A alternativa, que é o que a maioria dos times faz hoje, é ler uma transcrição de chat e torcer para as partes importantes estarem lá.
Se você testar uma coisa só
Rode `/plannotator-review` na sua próxima alteração não commitada e comente três linhas, mesmo sem ter nada a dizer. Os comentários são o de menos. O que você aprende é quanto tempo uma revisão de verdade leva quando a superfície foi desenhada para isso, e esse número é o seu novo teto de vazão. Quase nenhum time já mediu isso.
Artigos relacionados
175 mil assinaturas não trazem ele de volta. Isto traria.
A campanha enquadra tudo como lealdade contra governança. É, na verdade, um plebiscito sobre um modelo de gestão que nunca havia sido testado.
A regra de exportação mudou o alvo: do chip para o cliente
A regra não proíbe chip nenhum. Ela muda a unidade de controle do objeto para a relação: quem é o cliente, não onde está o servidor.
O conselho criou um comitê de exportação na mesma semana do balanço
Só o resultado virou notícia. O comitê de controle de exportação é o que pode mudar de fato como a empresa opera.
A Nvidia nunca formou um banco de sucessores. Essa é a descoberta.
A empresa passou trinta e três anos decidindo, sem dizer, que a pergunta sobre quem vem depois não era urgente.