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:
curl -fsSL https://plannotator.ai/install.sh | bash
En Windows PowerShell:
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:
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:
/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:
- El agente termina su plan y pide salir del modo plan (el README llama a este paso
ExitPlanMode). - Se dispara un hook y un servidor local abre el plan en tu navegador.
- Haces tus anotaciones y luego apruebas o rechazas.
- 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:
/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 tuPATHpuede 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/configesLocalForward 19432 localhost:19432. En un contenedor, o si quieres otro puerto, definePLANNOTATOR_REMOTE=1yPLANNOTATOR_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.0sin 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=noneno 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=0para recuperar el flujo clásico. - El plugin no se actualiza. Ejecuta
claude plugin marketplace update plannotator, luegoclaude plugin update plannotator@plannotatory después reinicia. - Quieres quitarlo. Haz una prueba con
plannotator uninstall --dry-runy luego ejecutaplannotator 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.





Escribe una respuesta