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.

À 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-only
https://privatenote.ai/note/…#…
# secret
--expire

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

Diagramme complet sur le hub développeur
  • 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

NomDescription
--expire 15m|1h|24h|7dDurée de vie de la note (par défaut : 24h)
--burn / --no-burnDétruire après la première vue (par défaut : burn)
--title <text>Titre optionnel ajouté au contenu
--jsonAfficher { secureUrl, expiresAt, burnAfterReading }
--output-url-onlySortie URL uniquement ; sûr pour un stdout pipé dans les scripts
--force-stdoutAutoriser 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)
--insecureAutoriser les origines http:// API — développement local uniquement, jamais en production
PRIVATENOTE_API_BASE_URLBase URL API par défaut
PRIVATENOTE_WEB_ORIGINOrigine du lien de partage (par défaut l'origine API)
PRIVATENOTE_ALLOWED_HOSTSListe blanche de noms d'hôte séparés par des virgules

Intégrations associées

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.

Photo : Léna Le Roy · Unsplash.