Votre agent de code vient de proposer un plan en douze étapes et attend votre feu vert avant de réécrire votre projet. Vous le survolez dans le terminal, tapez « looks good » (ça me va) et priez pour que l’étape neuf ne supprime pas quelque chose auquel vous tenez.
Plannotator est un outil open source qui remplace ce survol par une vraie séance de relecture : le plan s’ouvre dans votre navigateur, vous le commentez ligne par ligne, et vos notes repartent directement vers l’agent. Voici comment l’installer et l’utiliser avant que la moindre ligne de code ne soit écrite.
Ce qu’il vous faut
- Un agent de code compatible. Le README cite Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp et Pi.
- Un terminal et un navigateur. Plannotator est, selon son README, « a local, browser-based review surface » (une interface de relecture locale, dans le navigateur).
- Git, dont l’installateur a besoin pour les skills, d’après la documentation d’installation de Plannotator.
Plannotator est gratuit, sous double licence Apache 2.0 ou MIT, et au 15 novembre 2026 son dépôt GitHub (backnotprop/plannotator) affiche environ 11 400 étoiles. Il a été créé le 28 décembre 2025, et sa dernière version, la v0.28.65, a été publiée ce jour-là. Les commandes ci-dessous sont copiées de son README et de sa documentation au 15 novembre 2026 et vérifiées sur ces pages ; les lignes de shell passent un contrôle de syntaxe, mais nous n’avons pas installé Plannotator pour cet article.
Étape 1 : installer le programme
Sous macOS, Linux ou WSL :
curl -fsSL https://plannotator.ai/install.sh | bash
Sous Windows PowerShell :
irm https://plannotator.ai/install.ps1 | iex
D’après la documentation, l’installateur ajoute la commande plannotator, vérifie le téléchargement avec sa somme de contrôle SHA-256 et installe des hooks et des skills de base pour les agents qu’il détecte. Au premier lancement, il demande s’il faut ajouter des skills supplémentaires ; la réponse par défaut est non. Vérifiez que tout a fonctionné :
plannotator --version
Si l’idée d’envoyer un script directement dans votre shell vous inquiète, la documentation propose une installation du binaire seul (--minimal) et un moyen d’épingler une version et d’en vérifier la provenance.
Étape 2 : connecter votre agent
Claude Code demande une étape de plus. Dans Claude Code, lancez :
/plugin marketplace add backnotprop/plannotator
/plugin install plannotator@plannotator
Redémarrez ensuite Claude Code. Selon le README, Codex et Gemini CLI n’ont besoin de rien d’autre (Gemini exige la version 0.36.0 ou ultérieure), OpenCode a besoin de "plugin": ["@plannotator/opencode@latest"] dans opencode.json, et Pi utilise pi install npm:@plannotator/pi-extension. Si les hooks et les skills sont nouveaux pour vous, notre guide des skills d’agent de Claude Code explique tous les rouages.
Étape 3 : faire rédiger un plan à votre agent
Pas de commande à taper ici. Le README explique que le mode plan est branché via les hooks de chaque agent : la prochaine fois que votre agent termine un plan, l’écran de relecture s’ouvre tout seul.
En coulisses, le déroulé décrit par le README est le suivant :
- L’agent termine son plan et demande à quitter le mode plan (le README appelle cette étape
ExitPlanMode). - Un hook se déclenche et un serveur local ouvre le plan dans votre navigateur.
- Vous annotez, puis vous approuvez ou refusez.
- Si vous refusez, des retours structurés sont renvoyés à l’agent, qui révise son plan. Un diff du plan montre ce qui a changé.
Le site de Plannotator indique que vous pouvez commenter des sections, marquer du texte à supprimer ou rédiger des remplacements, puis approuver ou refuser avec ces retours joints.
Résultat attendu : un onglet de navigateur affichant votre plan, prêt à être annoté.
Étape 4 : annoter ce que vous avez déjà
Plannotator ne se limite pas aux plans. Ces commandes viennent du README :
/plannotator-last
/plannotator-annotate README.md
/plannotator-annotate src/
/plannotator-review
La première annote le dernier message de votre agent. La deuxième et la troisième servent à annoter un fichier ou un dossier. La dernière ouvre un visualiseur de diff façon pull request pour vos modifications non commitées, et vous pouvez lui passer à la place l’URL d’une PR GitHub ou d’une merge request GitLab. Sous Codex, remplacez les barres obliques par les skills $plannotator-*.
Ce qu’il fait de vos données
Le README affirme que Plannotator « does not collect usage telemetry or analytics » (ne collecte ni télémétrie d’usage ni statistiques), et que plans, diffs et annotations restent en local par défaut. Il liste aussi des exceptions bonnes à connaître :
- Chaque écran de relecture interroge GitHub au chargement pour connaître la dernière version. Le README précise qu’il n’existe pour l’instant aucun moyen de désactiver cette vérification.
- « Ask AI » envoie la question et le contexte pertinent au fournisseur que vous avez configuré.
- Partager un plan génère un lien. Selon le README, les petits partages sont intégrés au lien lui-même, sans chiffrement : toute personne qui détient le lien peut les lire. Les partages volumineux sont chiffrés avant l’envoi, et les pastes hébergés expirent au bout de 7 jours.
Erreurs fréquentes et solutions
plannotator: command not found. Ouvrez un nouveau terminal. La documentation indique que votrePATHa peut-être changé.- La page de relecture ne se charge pas via SSH ou dans un conteneur. En SSH, le README indique que Plannotator passe sur le port fixe 19432, et la ligne à ajouter à
~/.ssh/configestLocalForward 19432 localhost:19432. Dans un conteneur, ou pour un autre port, définissezPLANNOTATOR_REMOTE=1etPLANNOTATOR_PORT=9999, puis redirigez ce port. Débutant en SSH ? Consultez notre guide des clés SSH. - Le mode distant est grand ouvert. Le README prévient qu’en mode distant le serveur écoute sur
0.0.0.0sans authentification : quiconque peut atteindre le port peut l’utiliser. Gardez ce port fermé aux réseaux auxquels vous ne faites pas confiance. - Aucune fenêtre ne s’affiche.
PLANNOTATOR_BROWSER=nonen’ouvre aucun navigateur, et l’URL de la session est toujours affichée. - Claude ne vous attend plus. Avec Claude Code 2.1.287 ou ultérieur, le README indique que Claude termine son tour et que votre décision lui parvient plus tard sous forme de message. Définissez
PLANNOTATOR_CLAUDE_MOD=0pour retrouver le fonctionnement classique. - Le plugin ne se met pas à jour. Lancez
claude plugin marketplace update plannotator, puisclaude plugin update plannotator@plannotator, puis redémarrez. - Vous voulez le désinstaller. Faites un essai à blanc avec
plannotator uninstall --dry-run, puis lancezplannotator uninstall. Par défaut, vos plans et votre historique sont conservés.
À retenir
Un plan que vous lisez vraiment coûte moins cher qu’un diff qu’il faut ensuite détricoter. Si vous laissez aussi votre agent piloter un navigateur, découvrez notre configuration de Chrome DevTools MCP.
Sources
Liens vérifiés pour la dernière fois le 15 novembre 2026.





Écrire une réponse