Prise en main de Notez CLI

terminalDenis Povarov30 août 2026

Notez CLI est un binaire natif de 3 Mo qui capture des notes depuis votre shell. Pas de runtime Node, pas de démon, pas de fichier de configuration à écrire à la main : vous l’installez, vous autorisez le terminal une fois, et ensuite notez "your thought" dépose l’idée dans votre espace de travail. Il fonctionne sous macOS, Linux et Windows.

Ce guide couvre l’installation, la première configuration et les quelques options à connaître.

Installation

Sous macOS ou Linux :

curl -fsSL https://notez.dev/install.sh | sh

Le script télécharge le dernier binaire pour votre plateforme, vérifie sa somme de contrôle SHA256 et place notez dans /usr/local/bin (ou dans ~/.local/bin si ce dossier n’est pas accessible en écriture).

Sous Windows, dans PowerShell :

iwr -useb https://notez.dev/install.ps1 | iex

La CLI s’installe dans %LOCALAPPDATA%\Programs\notez et s’ajoute au PATH de votre utilisateur.

Si vous préférez ne pas passer un script à votre shell par un pipe (une prudence raisonnable), les binaires sont servis directement depuis https://notez.dev/downloads/cli/ pour macOS (arm64 et x64), Linux (x64 et arm64) et Windows, chacun accompagné d’un fichier .sha256 pour une vérification manuelle. Décompressez l’archive et placez notez n’importe où dans votre $PATH.

Une remarque pour macOS : si vous téléchargez l’archive avec un navigateur plutôt qu’avec curl, Gatekeeper la met en quarantaine. Retirez l’attribut une fois pour toutes avec xattr -d com.apple.quarantine /path/to/notez.

Autoriser votre terminal

notez login

La commande ouvre votre navigateur sur notez.dev/cli-auth, où vous choisissez un espace de travail dont vous êtes propriétaire et approuvez le terminal ; seul le propriétaire d’un espace de travail peut y configurer la CLI. Une clé d’API longue durée, valable pour ce seul espace de travail et limitée à la création de notes et à l’envoi de fichiers, est générée et stockée localement :

macOS : ~/Library/Application Support/notez/config.toml
Linux : ~/.config/notez/config.toml
Windows : %APPDATA%\notez\config.toml

Vous pouvez révoquer la clé à tout moment dans Paramètres → Intégrations → Notez CLI, par exemple si vous perdez un portable ou si une machine partagée ne doit plus avoir accès. notez logout oublie la clé localement.

Capturer des notes

Le cas le plus courant tient en une commande :

notez "retry storm happens when the circuit breaker resets too early"

Le texte devient une note dans votre espace de travail, et la recherche la trouve aussitôt. Quelques variantes couvrent le reste de l’usage quotidien :

# Pipe output into a note
grep -c ERROR app.log | notez

# Give the note an explicit title (otherwise the text is used)
notez --title "Incident 2026-08-30" "db failover took 40s, alarms fired late"

# Capture a URL — auto-detected and stored as a bookmark
notez "https://docs.anthropic.com/quickstart"

# Upload a file — a path that exists is detected and uploaded
notez ./architecture-diagram.png

La forme avec pipe mérite qu’on s’y arrête. Tout ce que votre shell produit — la sortie d’un test en échec, une stack trace, la combinaison d’options qui a fini par marcher — se capture au moment où il s’affiche, sans sélectionner de texte ni changer de fenêtre.

Scripter avec --json

notez --json "..." affiche la note créée en JSON, si bien que la CLI se combine avec d’autres outils. Deux usages pratiques :

# Capture and keep the note id for later reference
NOTE_ID=$(notez --json "deploy checklist for v2.3" | jq -r .id)

# A git hook that logs every release
notez "released $(git describe --tags) to production"

Comme c’est un seul binaire rapide, la CLI trouve sa place là où des outils plus lourds n’en ont pas : dans des jobs de CI, sur des serveurs distants en SSH, dans un panneau tmux ouvert à côté de votre éditeur.

Où vont les notes

Tout ce que capture la CLI arrive dans le même coffre que vos autres points d’entrée Notez : le tableau de bord web, la capture par la barre d’URL notez.dev/your thought et les outils d’IA connectés via MCP. Dans l’appli web, vous parcourez et cherchez vos captures, ajoutez des étiquettes, les liez à d’autres notes, ou transformez une capture brute en document structuré avec l’éditeur complet.

La recherche de Notez fonctionne par le sens, pas seulement par mots-clés : une capture laconique comme notez "cursor pagination beats offset for big tables" se retrouve plus tard en cherchant « pagination performance », même si vous ne l’avez ni étiquetée ni classée.

Une habitude qui tient

Ce qui rend la CLI rentable, c’est d’être moins exigeant sur ce qui mérite une note. Avec une appli de notes qui demande vingt secondes pour s’ouvrir, seules les idées importantes passent la barre, et la plupart des petites — le contournement, l’option, l’idée à moitié formée — s’évaporent. Avec une capture en deux secondes, tout passe.

Quelques habitudes à reprendre :

Écrivez le correctif, pas seulement le bug. Au moment où quelque chose finit par marcher, passez la raison à notez "...". Plus tard, face à la même erreur, c’est elle que vous chercherez.
Consignez les décisions au moment où vous les prenez. Une ligne sur la raison qui vous a fait choisir l’approche A plutôt que B vaut mieux que de la reconstituer plus tard, pendant la relecture d’un document de conception.
Passez par un pipe, ne collez pas. Si c’est déjà dans votre terminal, | notez est plus rapide et plus fidèle qu’un copier-coller dans une interface graphique.

Dépannage

Si notez login indique qu’il n’a pas pu joindre la CLI sur votre machine, l’échange d’autorisation a sans doute expiré : relancez notez login. Si une clé cesse de fonctionner, vérifiez Paramètres → Intégrations → Notez CLI : révoquer un terminal à cet endroit le désactive immédiatement, et relancer notez login sur cette machine émet une nouvelle clé.

Voilà tout l’outil. notez --help liste tout, notez update installe la dernière version à la place de l’actuelle, et le reste tient en une ligne : une commande, votre idée, c’est enregistré.