Prise de notes dans le terminal : fichier, éditeur ou CLI

terminal

Si vous passez vos journées dans un terminal, basculer vers une appli de notes graphique pour noter une idée est un changement de contexte que vous payez deux fois : une fois pour y aller, une autre pour retrouver votre concentration au retour. Prendre des notes directement en ligne de commande supprime ces deux coûts. Cet article passe en revue les principales approches, du simple fichier sans dépendance aux outils CLI dédiés, et dans quel cas chacune convient.

Pourquoi le terminal se prête bien aux notes

Trois propriétés font du shell un endroit particulièrement adapté à la capture :

  • Vous y êtes déjà. En plein débogage, en plein déploiement, en pleine revue de code : le prompt est là et attend.

  • La sortie est du texte. Messages d’erreur, tests en échec, sortie de commandes : tout passe dans une note par un pipe, sans capture d’écran ni ressaisie.

  • Ça marche partout. En SSH, dans tmux, sur une machine de CI : partout où tourne un shell, votre méthode de capture tourne aussi.

Le point faible habituel de la prise de notes dans le terminal se trouve à l’autre bout : retrouver. Les fichiers texte s’accumulent, et c’est retrouver la bonne ligne trois mois plus tard qui coince. Gardez ce compromis en tête en choisissant une approche.

Approche 1 : un simple fichier où l’on ajoute des lignes

Le système le plus simple qui fonctionne :

Bash
echo "$(date +%F) - use SIGTERM not SIGKILL in the entrypoint" >> ~/notes.md

Mettez-le dans une fonction shell, et noter devient un réflexe :

Bash
note() { echo "$(date +%F) $*" >> ~/notes.md; }

Pour retrouver une note : grep -i keyword ~/notes.md. Cela ne coûte rien, se synchronise avec ce qui synchronise déjà votre dossier personnel, et ne casse jamais.

Les limites apparaissent avec le volume : un fichier plat n’a aucune structure, grep ne trouve que les mots exacts, et rien ne vous suit sur une deuxième machine si vous ne mettez pas en place la synchronisation vous-même.

Approche 2 : des notes dans votre éditeur, lancé depuis le shell

vim ~/notes/$(date +%F).md, ou un petit script qui ouvre la note du jour, vous donne un vrai éditeur et un fichier par jour. Les outils de cette famille (scripts de notes quotidiennes, nb, CLI de journal) ajoutent juste assez de structure — des fichiers datés, parfois des étiquettes — tout en restant locaux et scriptables.

Cela fonctionne bien quand les notes dépassent une ligne. Le prix : ouvrir un éditeur n’est plus une capture de deux secondes, c’est une petite tâche en soi, et en SSH votre configuration d’éditeur n’est pas forcément là.

Approche 3 : une CLI de capture dédiée, adossée à un coffre synchronisé

La troisième approche sépare la capture du stockage : une petite CLI dont le seul rôle est de prendre du texte dans votre shell et de le déposer dans un système de notes qui gère ailleurs la recherche, la synchronisation et l’organisation.

Notez CLI suit ce modèle. C’est un binaire de 3 Mo pour macOS, Linux et Windows ; après un notez login unique, une capture ressemble à ceci :

Bash
notez "the flaky test is timezone-dependent — freeze the clock"
echo "worth keeping" | notez
notez --title "Postmortem notes" "timeline starts 14:02 UTC"

Les notes arrivent dans un espace de travail que vous ouvrez aussi depuis une appli web, si bien que retrouver une note ne dépend pas de grep : la recherche fonctionne par le sens (chercher « flaky tests » trouve la note sur le fuseau horaire), et chaque capture peut ensuite recevoir des étiquettes, être liée à d’autres notes ou être développée dans un éditeur complet. Les URL sont détectées automatiquement et enregistrées comme signets, et la sortie --json rend la CLI utilisable dans des scripts et des hooks git.

Le compromis est l’inverse de celui du fichier simple : vous gagnez la recherche, la synchronisation et la structure, et en échange vos notes vivent dans un service plutôt que dans un fichier local. Si cela compte pour vous, vérifiez qu’il existe une porte de sortie. Notez, par exemple, exporte un espace de travail entier en .zip de fichiers Markdown avec leurs pièces jointes, un minimum raisonnable à exiger de n’importe quel outil.

Des habitudes qui marchent avec n’importe quel système

Quelle que soit l’approche choisie, quelques habitudes rendent les notes prises dans le terminal vraiment utiles plus tard :

Passez par un pipe, ne retapez pas

Le meilleur argument pour capturer dans le terminal, c’est que la matière est déjà sous vos yeux, sous forme de texte :

Bash
./run-tests.sh 2>&1 | tail -20 | notez --title "auth test failure"

Une note qui contient la vraie sortie d’erreur vaut dix notes qui la paraphrasent.

Écrivez la solution, pas seulement le problème

La note la plus précieuse dans le coffre d’un développeur, c’est « voilà ce qui l’a réglé ». Quand quelque chose finit par marcher, écrivez la cause en une ligne. Plus tard, vous chercherez le message d’erreur et vous tomberez sur la réponse.

Laissez l’outil dater, titrez avec parcimonie

Laissez l’outil enregistrer quand une note a été créée. Le titre est facultatif pour une capture rapide : une note écrite en deux secondes reste un gain même sans titre, et la recherche par le sens n’a pas besoin de titre pour la trouver.

Une seule boîte de réception

Envoyez toutes les captures rapides au même endroit et triez plus tard (ou jamais). Dès que vous vous obligez à choisir une destination au moment de capturer, vous réintroduisez la friction que vous vouliez supprimer.

Choisir entre les approches

  • Fichier simple : vous ne voulez aucune dépendance, et vos notes sont une mémoire de travail à courte durée de vie.

  • Éditeur + fichiers datés : vos notes sont plus longues et vous travaillez sur une seule machine.

  • CLI de capture + coffre synchronisé : vous capturez souvent, depuis plusieurs machines, et retrouver compte autant que capturer.

Ces approches se combinent aussi. Beaucoup de gens gardent un fichier brouillon pour l’éphémère et un coffre synchronisé pour tout ce qui mérite d’être retrouvé. La seule règle qui compte : rendre la capture assez simple pour que vous la fassiez vraiment. Un système de notes utilisé chaque jour vaut mieux qu’un système élaboré qu’on n’utilise pas.

À lire aussi