Plannotator : comment relire et annoter le plan de votre agent de code avant qu’il n’écrive la moindre ligne

Plannotator ouvre le plan de votre agent de code dans le navigateur pour que vous puissiez l’annoter et envoyer vos remarques avant l’écriture du code. Voici l’installation, les commandes et les petits caractères sur la confidentialité.

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

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 :

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

Sous Windows PowerShell :

Code
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é :

Code
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 :

Code
/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 :

  1. L’agent termine son plan et demande à quitter le mode plan (le README appelle cette étape ExitPlanMode).
  2. Un hook se déclenche et un serveur local ouvre le plan dans votre navigateur.
  3. Vous annotez, puis vous approuvez ou refusez.
  4. 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 :

Code
/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 votre PATH a 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/config est LocalForward 19432 localhost:19432. Dans un conteneur, ou pour un autre port, définissez PLANNOTATOR_REMOTE=1 et PLANNOTATOR_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.0 sans 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=none n’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=0 pour retrouver le fonctionnement classique.
  • Le plugin ne se met pas à jour. Lancez claude plugin marketplace update plannotator, puis claude plugin update plannotator@plannotator, puis redémarrez.
  • Vous voulez le désinstaller. Faites un essai à blanc avec plannotator uninstall --dry-run, puis lancez plannotator 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.

Écrit par 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.

À propos de Mindloop Experience

Réponses

Écrire une réponse

Plus d’articles de Mindloop Experience

Tout voir de Mindloop Experience

Vous pouvez applaudir jusqu’à 50 fois.