Plannotator
backnotprop · Programação
O Plannotator é uma ferramenta local de revisão de código com IA que roda no navegador e foi feita para agentes de programação. Ele abre o plano que o seu agente acabou de escrever, ou o código que ele acabou de alterar, numa janela do navegador onde você destaca texto, deixa comentários e devolve tudo ao agente como feedback estruturado. Pense nele como uma ferramenta de anotação de markdown para a saída do agente. Roda na sua máquina, é gratuito e de código aberto, e se conecta a agentes como Claude Code, Codex, Copilot CLI, Gemini CLI e OpenCode.
Sobre Plannotator
O que é o Plannotator
O Plannotator é uma camada visual para o momento em que um agente de IA escreveu um plano, mas ainda não construiu nada. Em vez de rolar um bloco longo de texto no terminal, você vê o mesmo documento renderizado como uma página web. Pode selecionar uma frase, anexar um comentário e apertar enviar. O agente recebe o seu feedback e revisa o trabalho. O projeto se descreve como uma superfície de revisão, e é exatamente isso. Ele fica entre o agente e o próximo passo da tarefa.
O atrativo está no momento. Pegar uma suposição errada num plano custa alguns minutos. Pegar o mesmo erro depois que o código está escrito custa bem mais. O Plannotator se apoia nessa brecha, sobretudo para quem usa agentes em recursos grandes, onde uma decisão de projeto errada pode se espalhar por dezenas de arquivos.
Também vale saber o que ele não é. O Plannotator não escreve código e não hospeda nada para você. Tudo roda localmente. Seus planos, diffs e comentários ficam na sua máquina. Se um fluxo de trabalho depende de um espaço de trabalho compartilhado na nuvem, você terá que encaixar o Plannotator em volta disso, e não o contrário. Outro limite: ele vive ao lado de um agente de programação, então não serve sozinho se você já não roda ferramentas de agente como Claude Code ou Codex nesta máquina.
Primeiros passos
- Rode o instalador da sua plataforma. No macOS, Linux ou WSL é
curl -fsSL https://plannotator.ai/install.sh | bash. No Windows, rode o equivalente no PowerShell ou no Prompt de Comando. - Deixe o instalador se integrar aos seus agentes. Ele detecta quais agentes de programação estão presentes e adiciona os hooks, os comandos de barra e as skills correspondentes.
- Abra um terminal novo e confira se o comando funciona rodando
plannotator --version. - No seu agente de programação, dispare uma revisão. Os comandos incluem
/plannotator-annotate <file|dir|url>,/plannotator-review [PR_URL]e/plannotator-lastpara a mensagem mais recente do agente. - O navegador abre o documento, você marca e seus comentários voltam direto ao agente.
Informações do produto
Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de Plannotator.
Ideal para
Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.
Usuários
- Desenvolvedores que rodam agentes de programação com IA e querem orientar os planos antes de o código ser escrito
- Criadores individuais que lançam recursos com Claude Code ou Codex e revisam diffs sozinhos
- Líderes de equipe que querem comentar um PR ou uma especificação sem sair do fluxo no editor
Tarefas
- Marcar um plano escrito pelo agente para que a próxima revisão corresponda à sua intenção
- Revisar alterações locais ou um pull request do GitHub e do GitLab linha por linha
- Anotar um artefato HTML renderizado que o agente produziu
Cenários
- Uma refatoração grande em que uma escolha de projeto errada tocaria dezenas de arquivos
- Trabalho noturno quando você quer as notas de revisão capturadas num navegador em vez de num chat que precisa ser rolado
- Revisar o PR de um colega que mexe em código que você não tem aberto localmente
Principais recursos
Revisão do plano antes de o agente agir
O núcleo do Plannotator é pegar problemas enquanto corrigi-los ainda sai barato. Quando o seu agente propõe um plano, o plano abre no navegador com o texto disposto para leitura. Você seleciona uma seção, digita um comentário e envia. O agente recebe suas notas como um lote e reescreve o plano. Esse ciclo permite anotar planos de IA antes de um único arquivo mudar. Para quem já viu um agente construir com toda a confiança a coisa errada por vinte minutos, este é o recurso que justifica a instalação.
Revisão de código com um visualizador de diff completo
Quando o agente começa a escrever código, o Plannotator passa a revisá-lo. Alterações locais e pull requests remotas abrem lado a lado, então você comenta linhas específicas e sugere substituições. Ele lida com Git, GitButler, Jujutsu, Perforce, GitHub e GitLab. Isso cobre a maioria dos stacks que as pessoas realmente usam. Seus comentários no nível da linha voltam ao agente do mesmo jeito que os comentários do plano.
Anotação de artefatos HTML
Cada vez mais, os agentes produzem HTML: um mockup de painel, um relatório, uma pequena página interativa. O Plannotator renderiza esse HTML no navegador e deixa você anotar o resultado renderizado em vez do código-fonte. É um recurso pequeno que resolve um incômodo real. Ler tags cruas é lento. Agora você não precisa mais.
Amplo suporte a agentes a partir de um só instalador
O instalador detecta quais agentes você tem e configura cada um. A lista compatível inclui Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp e Pi. Ele usa hooks onde o agente os aceita e comandos de barra onde encaixam melhor. Você não fica fazendo malabarismo com nove guias de configuração separados. Isso importa se você alterna entre agentes em projetos diferentes.
Privacidade local em primeiro lugar
O Plannotator roda na sua máquina numa aba do navegador e afirma que não coleta dados de uso. Planos, diffs e comentários ficam locais até você enviá-los ao seu próprio agente. Para equipes que lidam com código privado, essa é uma diferença real em relação a ferramentas que querem que você suba o contexto para um serviço hospedado.
Prós e contras
Prós
- Gratuito e de código aberto, sem assinatura ou preço por assento
- A instalação é um único script que configura todos os agentes detectados para você
- A revisão do plano pega erros de projeto antes que virem código
- Os comentários de revisão voltam direto ao agente em vez de ficarem num chat separado
- Tudo fica local, o que combina com bases de código privadas
Contras
- Só ajuda se você já roda um agente de programação, então sozinho não serve
- O terminal integrado pede Node.js e npm no Windows e em algumas configurações de Linux, e sem eles alguns recursos ficam limitados
- As skills extras e a opção de deixar o modelo iniciar skills por conta própria vêm desativadas por padrão, então você precisa ativá-las na instalação
Perguntas frequentes
Sim. O Plannotator é gratuito e de código aberto, e o projeto não lista planos pagos. Não há nada para assinar, e o código é público no GitHub.
Conteúdo relacionado
Explore ferramentas, skills e artigos relacionados a Plannotator.
Alternativas a Plannotator
Forefront
Forefront · ProgramaçãoO Forefront é uma plataforma web para construir com IA de código aberto. Você ajusta os principais modelos de linguagem de código aberto com seus próprios dados, avalia o desempenho deles e os roda por uma API ou os exporta para hospedar por conta própria. Desenvolvedores que querem a conveniência de uma plataforma fechada, mas fazem questão de ser donos dos modelos e dos dados, são o público-alvo aqui.
Startkit
StartKit.AI · ProgramaçãoStartkit é um boilerplate para criar produtos de SaaS com IA e wrappers de IA. Pense nele como um boilerplate para startups de IA com as partes chatas já conectadas: autenticação, pagamentos com Stripe e Lemon Squeezy, limites de uso, e-mail transacional e um kit inicial de API de IA que conversa com OpenAI, Anthropic, Groq ou Llama. Você clona o repositório, define seu preço e começa pela parte do produto que as pessoas realmente pagam. Ele é feito em Next.js sobre React e Tailwind, então boa parte do código boilerplate já parece familiar.
Testim
Tricentis · ProgramaçãoO Testim é uma plataforma de automação de testes com IA para criar e executar testes de ponta a ponta em aplicações web, mobile e Salesforce. Ele se apoia no aprendizado de máquina para manter os testes estáveis quando uma interface muda, então as equipes gastam menos tempo consertando seletores quebrados. Nada mal para uma ferramenta de testes automatizados que você pode começar a usar hoje. Você cria testes gravando ações no navegador e depois adiciona JavaScript quando precisa de mais controle. É uma escolha sólida para equipes de QA ocupadas.