Intensivo Grátis 21–22/11Intensivo gratuito de 2 dias em Vibecoding (21–22/11 às 16:00 MSK) · Turma 3 começa 23/11Inscrever-se grátis →Turma 3 (23/11)
LançamentoCódigo / SDK · Pronto p/ usoGitHub Trending AI→ original

Plannotator permite comentar os planos de 10 agentes de IA no navegador: 100 estrelas no GitHub em um dia

Quando um agente de IA entrega um plano de trinta itens ou altera vinte arquivos, responder a ele com um parágrafo no terminal é incômodo. O Plannotator abre o plano ou o diff no navegador: você comenta as linhas necessárias, clica em Send e as observações vão para o agente. A ferramenta funciona com 10 agentes, entre eles Claude Code e Codex, e somou 100 estrelas no GitHub em um dia. Assim, revisar o trabalho do agente fica parecido com a revisão de um pull request comum.

Processado por IA de GitHub Trending AI; editado por Hamidun News
Plannotator permite comentar os planos de 10 agentes de IA no navegador: 100 estrelas no GitHub em um dia
Fonte: GitHub Trending AI. Colagem: Hamidun News.
Ouvir artigo
Ficha técnica e números-chave
ParâmetroDados
Fonte originalGitHub Trending AI ↗
Editor-chefe
Todos os dados ficam localmenteo Plannotator não armazena planos nem histórico em servidor
Dado-chave #2Instalação com um único comando, install.sh: ele encontra os agentes e configura os hooks
Dado-chave #3/plannotator-review abre um diff ou PR, /plannotator-last abre a resposta do agente

Imagine: você pediu a um agente de IA que finalizasse um projeto, e ele devolveu um plano de trinta itens ou correções em vinte arquivos. Ler isso no terminal e responder com um longo parágrafo é incômodo, e metade das observações acaba se perdendo. O Plannotator resolve esse problema. É um projeto open source da backnotprop que abre o plano ou o diff do agente no navegador, onde você comenta linhas específicas e envia as observações de volta. A ferramenta é compatível com 10 agentes de código, do Claude Code ao Codex, e somou cerca de 100 estrelas no GitHub em um dia, entrando nas tendências.

Como isso funciona na prática

Os autores descrevem o Plannotator como a camada de revisão que faltava entre o humano e o trabalho com múltiplos agentes. Trata-se de uma interface local no navegador, conectada ao agente por meio de plugins, hooks e comandos. Quando o agente propõe uma solução, monta um plano ou termina uma tarefa, a interface se abre sozinha no navegador. Você marca o texto, comenta, aprova ou rejeita. Se aprovar, o agente segue em frente. Se rejeitar, ele recebe um feedback estruturado, refaz o plano, e a interface mostra o que mudou entre as versões.

Os agentes suportados são: Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp, DeepSeek Harness e Pi. Já o Plannotator Inbox funciona com assistentes pessoais: Grok Bot, Muse, Hermes e OpenClaw. Trata-se de uma única janela local onde os agentes deixam mensagens, perguntas, arquivos e análises enquanto continuam trabalhando. Você pode responder a uma pergunta com um clique. A sessão do agente não fica parada aguardando, e sua resposta chega como o próximo passo dele. Os demais agentes se conectam via MCP.

O que dá para comentar

Primeiro, documentos: markdown, especificações, HTML, pastas inteiras e URLs. O comando /plannotator-annotate aceita um caminho ou endereço, e /plannotator-last abre a última mensagem do agente.

Segundo, código. O /plannotator-review mostra as alterações não commitadas, um pull request do GitHub ou um merge request do GitLab a partir de um link. São suportados Git, GitButler e Jujutsu. Você pode comentar linhas, sugerir correções e enviar tudo ao agente. O agente também consegue dividir um diff grande em "capítulos": primeiro a essência da mudança, depois as consequências e, por fim, o código de apoio. Cada capítulo tem uma breve descrição ao lado do diff real.

Terceiro, sites em execução. O comando plannotator annotate http://localhost:5173 abre sua aplicação local por meio de um proxy, e você comenta a página real, com o hot reload funcionando normalmente. Para o terminal existe o Herdr Annotate: ele marca texto no console e nas respostas dos agentes, e as anotações são salvas no diretório de dados compartilhado do Plannotator.

Um plano pode ser enviado a um colega por link: ele deixa suas anotações, e você importa esses comentários para o seu agente. Materiais pequenos ficam dentro do próprio link; os grandes são criptografados antes do upload e removidos após 7 dias. Qualquer pessoa com o link completo pode ler o conteúdo. O compartilhamento pode ser desativado pela variável PLANNOTATOR_SHARE=disabled. Planos aprovados também podem ser salvos automaticamente em um repositório de notas com tags e backlinks, ou no Bear e no Notion.

Instalação e limitações

Um único instalador (curl com install.sh) baixa o binário das GitHub Releases, detecta os agentes instalados e configura, para cada um, hooks, skills e comandos slash. Se você quiser apenas o binário, pode impedir que o instalador altere as configurações dos agentes. Para Claude Code e Copilot CLI há plugins disponíveis no marketplace; para OpenCode e Pi, extensões separadas; e para o modo de terminal, brew install plannotator/tap/plannotator-tui.

Os dados ficam apenas localmente, não há nada no servidor do Plannotator, e não é possível recuperá-los remotamente. A desinstalação padrão remove os componentes instalados, mas preserva seus planos, histórico e configurações. A limpeza completa exige a flag --purge, e, em caminhos não padronizados ou configurações corrompidas, o comando para e explica o que fazer manualmente.

Há ressalvas:

  • No Codex, os hooks ainda são experimentais, e no Windows nativo o instalador exibe instruções para configuração manual.
  • Para o Droid, estão disponíveis apenas os comandos, sem interceptação de planos.
  • O Gemini CLI precisa estar na versão 0.36.0 ou superior.
  • Em sessões SSH, o Plannotator muda para uma porta fixa; em devcontainer e Docker, a porta é definida separadamente.

Por que isso importa para quem desenvolve

A revisão do agente ganha a mesma forma da revisão de um colega: comentários em linhas específicas, em vez de respostas longas no chat. Se você roda vários agentes ao mesmo tempo, a Inbox unificada evita ficar alternando entre terminais. No Claude Code na versão 2.1.287 ou superior, plano, revisão de código e anotações não fazem o Claude esperar: ele encerra o turno, e a sua decisão chega depois, como mensagem.

Para testar rapidamente: instale a ferramenta e execute /plannotator-last no agente que você já usa. A partir daí, o plano se abrirá no navegador assim que o agente o propuser.

História

Perguntas frequentes sobre a notícia

Como isso funciona na prática?

Os autores descrevem o Plannotator como a camada de revisão que faltava entre o humano e o trabalho com múltiplos agentes. Trata-se de uma interface local no navegador, conectada ao agente por meio de plugins, hooks e comandos. Quando o agente propõe uma solução, monta um plano ou termina uma tarefa, a interface se abre sozinha no navegador. Você marca o texto, comenta, aprova ou rejeita. Se aprovar, o agente segue em frente.

O que dá para comentar?

Primeiro, documentos: markdown, especificações, HTML, pastas inteiras e URLs. O comando /plannotator-annotate aceita um caminho ou endereço, e /plannotator-last abre a última mensagem do agente. Segundo, código. O /plannotator-review mostra as alterações não commitadas, um pull request do GitHub ou um merge request do GitLab a partir de um link. São suportados Git, GitButler e Jujutsu. Você pode comentar linhas, sugerir correções e enviar tudo ao agente.

O que se sabe sobre Instalação e limitações?

Um único instalador (curl com install.sh) baixa o binário das GitHub Releases, detecta os agentes instalados e configura, para cada um, hooks, skills e comandos slash. Se você quiser apenas o binário, pode impedir que o instalador altere as configurações dos agentes. Para Claude Code e Copilot CLI há plugins disponíveis no marketplace; para OpenCode e Pi, extensões separadas; e para o modo de terminal, brew install plannotator/tap/plannotator-tui.

ZK
Zhemal Khamidun — CPO da Alpina Digital, gerente de produto do AlpinaGPT. Cria produtos de IA desde 2019. O Hamidun News é um projeto pessoal que virou um agregador em produção com mais de 6.000 leitores.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
O que você acha?
Carregando comentários…