Plannotator: cómo revisar y anotar el plan de tu agente de código antes de que escriba una sola línea

Plannotator abre el plan de tu agente de código en el navegador para que lo marques y le envíes comentarios antes de que se escriba el código. Aquí tienes la instalación, los comandos y la letra pequeña sobre privacidad.

Graphic of a browser window with a marked-up plan and comment bubbles, illustrating the Plannotator tool for reviewing coding agent plans.

Tu agente de código acaba de proponer un plan de doce pasos y quiere tu visto bueno antes de empezar a reescribir tu proyecto. Lo lees por encima en la terminal, escribes «looks good» (se ve bien) y cruzas los dedos para que el paso nueve no borre algo que te gusta.

Plannotator es una herramienta de código abierto que cambia esa lectura rápida por una sesión de revisión en condiciones: el plan se abre en tu navegador, lo comentas línea por línea y tus notas vuelven directamente al agente. Así se configura y se usa antes de que se escriba cualquier código.

Qué necesitas

  • Un agente de código compatible. El README menciona Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp y Pi.
  • Una terminal y un navegador. Plannotator es, en palabras de su README, «a local, browser-based review surface» (una superficie de revisión local basada en el navegador).
  • Git, que según la documentación de instalación de Plannotator necesita el instalador para las skills.

Plannotator es gratuito, tiene doble licencia Apache 2.0 o MIT y, a 15 de noviembre de 2026, su repositorio de GitHub (backnotprop/plannotator) muestra unas 11.400 estrellas. Se creó el 28 de diciembre de 2025, y su última versión, la v0.28.65, se publicó ese mismo día. Los comandos de abajo están copiados de su README y su documentación a 15 de noviembre de 2026 y cotejados con esas páginas; las líneas de shell pasan una comprobación de sintaxis, pero no instalamos Plannotator para este artículo.

Paso 1: instala el programa

En macOS, Linux o WSL:

Terminal
curl -fsSL https://plannotator.ai/install.sh | bash

En Windows PowerShell:

Código
irm https://plannotator.ai/install.ps1 | iex

Según la documentación, el instalador añade el comando plannotator, verifica la descarga con su suma de comprobación SHA-256 e instala hooks y skills básicas para los agentes que encuentre. En la primera ejecución te pregunta si quieres añadir skills adicionales; la respuesta por defecto es que no. Comprueba que ha funcionado:

Código
plannotator --version

Si te pone nervioso pasar un script directamente a tu shell, la documentación ofrece una instalación solo del binario (--minimal) y una forma de fijar una versión y verificar su procedencia.

Paso 2: conecta tu agente

Claude Code necesita un paso extra. Dentro de Claude Code, ejecuta:

Código
/plugin marketplace add backnotprop/plannotator
/plugin install plannotator@plannotator

Después reinicia Claude Code. Según el README, Codex y Gemini CLI no necesitan nada más (Gemini requiere la versión 0.36.0 o posterior), OpenCode necesita "plugin": ["@plannotator/opencode@latest"] en opencode.json, y Pi usa pi install npm:@plannotator/pi-extension. Si los hooks y las skills son nuevos para ti, nuestra guía de las skills de agente de Claude Code explica todas las piezas.

Paso 3: haz que tu agente escriba un plan

Aquí no tienes que escribir ningún comando. El README explica que el modo plan se conecta a través de los hooks de cada agente, así que la próxima vez que tu agente termine un plan, la pantalla de revisión se abrirá sola.

Entre bastidores, el flujo que describe el README es este:

  1. El agente termina su plan y pide salir del modo plan (el README llama a este paso ExitPlanMode).
  2. Se dispara un hook y un servidor local abre el plan en tu navegador.
  3. Haces tus anotaciones y luego apruebas o rechazas.
  4. Si rechazas, el agente recibe comentarios estructurados y revisa el plan. Un diff del plan muestra qué ha cambiado.

La web de Plannotator dice que puedes comentar secciones, marcar texto para eliminarlo o escribir sustituciones, y después aprobar o rechazar con esos comentarios adjuntos.

Resultado esperado: una pestaña del navegador con tu plan, lista para anotar.

Paso 4: anota cosas que ya tienes

Plannotator no se limita a los planes. Estos comandos salen del README:

Código
/plannotator-last
/plannotator-annotate README.md
/plannotator-annotate src/
/plannotator-review

El primero anota el último mensaje de tu agente. El segundo y el tercero sirven para marcar un archivo o una carpeta. El último abre un visor de diferencias al estilo de un pull request para tus cambios sin confirmar, y en su lugar puedes pasarle la URL de un PR de GitHub o de un merge request de GitLab. En Codex, cambia las barras por las skills $plannotator-*.

Qué hace con tus datos

El README afirma que Plannotator «does not collect usage telemetry or analytics» (no recopila telemetría de uso ni analíticas), y que los planes, los diffs y las anotaciones se quedan en local por defecto. También enumera excepciones que conviene conocer:

  • Cada pantalla de revisión consulta GitHub al cargarse para ver cuál es la última versión. El README dice que, por ahora, no hay forma de desactivar esa comprobación.
  • «Ask AI» envía la pregunta y el contexto relevante al proveedor que tengas configurado.
  • Compartir un plan genera un enlace. Según el README, los planes pequeños se empaquetan dentro del propio enlace, sin cifrar, así que cualquiera que tenga el enlace puede leerlos. Los grandes se cifran antes de subirse, y los pastes alojados caducan a los 7 días.

Errores comunes y cómo solucionarlos

  • plannotator: command not found. Abre una terminal nueva. La documentación indica que tu PATH puede haber cambiado.
  • La página de revisión no carga por SSH o dentro de un contenedor. Por SSH, el README dice que Plannotator pasa al puerto fijo 19432, y la línea para tu ~/.ssh/config es LocalForward 19432 localhost:19432. En un contenedor, o si quieres otro puerto, define PLANNOTATOR_REMOTE=1 y PLANNOTATOR_PORT=9999, y reenvía ese puerto. ¿Nuevo en SSH? Consulta nuestra guía de claves SSH.
  • El modo remoto está totalmente abierto. El README advierte de que en modo remoto el servidor escucha en 0.0.0.0 sin inicio de sesión, así que cualquiera que llegue al puerto puede usarlo. Mantén ese puerto cerrado a las redes en las que no confíes.
  • No aparece ninguna ventana. PLANNOTATOR_BROWSER=none no abre ningún navegador, y la URL de la sesión siempre se imprime en pantalla.
  • Claude ya no te espera. En Claude Code 2.1.287 o posterior, según el README, Claude termina su turno y tu decisión le llega más tarde como un mensaje. Define PLANNOTATOR_CLAUDE_MOD=0 para recuperar el flujo clásico.
  • El plugin no se actualiza. Ejecuta claude plugin marketplace update plannotator, luego claude plugin update plannotator@plannotator y después reinicia.
  • Quieres quitarlo. Haz una prueba con plannotator uninstall --dry-run y luego ejecuta plannotator uninstall. Por defecto conserva tus planes y tu historial.

La conclusión

Un plan que de verdad lees sale más barato que un diff que luego tienes que deshacer. Si además dejas que tu agente maneje un navegador, echa un vistazo a nuestra configuración de Chrome DevTools MCP.

Fuentes

Enlaces comprobados por última vez el 15 de noviembre de 2026.

Escrito por Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

Acerca de Mindloop Experience

Respuestas

Escribe una respuesta

Más de Mindloop Experience

Ver todo de Mindloop Experience

Puedes aplaudir hasta 50 veces.