PrivateNote CLI
Secrets sans empreinte dans les scripts, les pipes et la CI — chiffrés localement avant que quoi que ce soit n'atteigne le réseau.
Sur cette page
À qui cela s'adresse
Utilisez le CLI lorsque le secret réside déjà dans un fichier, un gestionnaire de mots de passe ou une sortie de pipeline et que vous avez besoin d'un lien partageable sans le coller dans un chat ou un e-mail.
L'outil lit depuis stdin ou un chemin de fichier, chiffre avec AES-256-GCM sur votre machine, télécharge uniquement le texte chiffré et affiche un URL avec la clé de déchiffrement dans le fragment.
Les notes créées de cette manière sont suivies comme creationSource: cli dans les analyses.
Installer
Nécessite Node.js 18+. Fonctionne sur macOS, Linux et Windows.
# Run once without installing npx privatenote-cli --expire 1h --output-url-only # Or install globally (adds the `privatenote` command) npm install -g privatenote-cli # Pipe a secret in scripts cat secret.txt | privatenote --expire 1h --output-url-only # Local self-host / wrangler dev (HTTP API — dev only) echo "secret" | privatenote --insecure --api-base-url http://localhost:8787 --output-url-only
Essayer en direct
Le même flux que la CLI dans le navigateur : chiffrer localement, envoyer le ciphertext, imprimer une URL avec la clé dans le fragment.
Démo en direct — crée une vraie note sur privatenote.ai. Utilisez un secret jetable, pas des identifiants de production.
echo 'sk-live-demo-replace-me' | npx privatenote-cli --expire 1h --output-url-onlyhttps://privatenote.ai/note/…#…
Architecture de sécurité
Le texte brut ne quitte jamais votre machine sans être chiffré. Le partage URL contient la clé de déchiffrement dans son #fragment, que les navigateurs et les clients HTTP n'envoient pas aux serveurs.
Lorsque stdout n'est pas un TTY (pipé ou capturé), le CLI refuse d'afficher un lien à moins que vous ne passiez --output-url-only ou --force-stdout — cela empêche les fuites accidentelles dans les logs de la CI.
Chiffrer localement
AES-256-GCM sur votre appareil — navigateur, éditeur, terminal ou processus MCP.
Envoyer le ciphertext
Seuls les octets chiffrés et les métadonnées (expiration, burn-after-reading) atteignent le serveur.
Clé dans #fragment
La clé de déchiffrement reste dans le hash de l'URL. Les navigateurs n'envoient pas les fragments dans les requêtes HTTP.
privatenote.ai/note/…#key
HTTPS requis pour les origines API distantes ; utilisez --insecure uniquement pour le dev local http:// (ex: wrangler dev sur :8787).
PRIVATENOTE_ALLOWED_HOSTS épingle les noms d'hôte API lors de l'utilisation d'une base URL API personnalisée.
Validation de la forme de la réponse et vérification des ID de note réservés avant le téléchargement.
Privilégiez la redirection de la sortie vers un fichier chmod 600 plutôt que l'affichage des URL.
Drapeaux et variables d'environnement
| Nom | Description |
|---|---|
| --expire 15m|1h|24h|7d | Durée de vie de la note (par défaut : 24h) |
| --burn / --no-burn | Détruire après la première vue (par défaut : burn) |
| --title <text> | Titre optionnel ajouté au contenu |
| --json | Afficher { secureUrl, expiresAt, burnAfterReading } |
| --output-url-only | Sortie URL uniquement ; sûr pour un stdout pipé dans les scripts |
| --force-stdout | Autoriser la sortie lorsque stdout n'est pas un terminal (à utiliser avec --json dans la CI) |
| --api-base-url <url> | Remplacer l'origine API (HTTPS ; utilisez --insecure pour le http:// local) |
| --insecure | Autoriser les origines http:// API — développement local uniquement, jamais en production |
| PRIVATENOTE_API_BASE_URL | Base URL API par défaut |
| PRIVATENOTE_WEB_ORIGIN | Origine du lien de partage (par défaut l'origine API) |
| PRIVATENOTE_ALLOWED_HOSTS | Liste blanche de noms d'hôte séparés par des virgules |
Intégrations associées
Extension de l'éditeur
Créez des notes depuis VS Code, Cursor ou Codex IDE sans changer de contexte. Utilisez la barre latérale, une commande sur le texte sélectionné ou l’action dans la barre de titre.
Voir la docServeur MCP
Ajoutez à un client MCP un outil local qui crée des liens PrivateNote lorsqu’un agent doit transmettre un secret.
Voir la docPlugin Codex
Installez le plugin fourni pour MCP et les skills, ou ajoutez privatenote-mcp à ~/.codex/config.toml. Dans Codex IDE, utilisez la même extension VS Code pour les secrets que l’agent ne doit jamais voir.
Voir la docExtension Chrome
Chiffrez le texte sélectionné depuis n’importe quel onglet via menu contextuel, barre d’outils ou raccourci — sans ouvrir le site.
Voir la docPrivateNote CLI
Secrets sans empreinte dans les scripts, les pipes et la CI — chiffrés localement avant que quoi que ce soit n'atteigne le réseau.
