PrivateNote CLI

Secrete cu amprentă zero în scripturi, pipe-uri și CI — criptate local înainte ca orice să ajungă în rețea.

Cui se adresează

Utilizați CLI atunci când secretul există deja într-un fișier, manager de parole sau ieșire de pipeline și aveți nevoie de un link partajabil fără a-l lipi într-un chat sau e-mail.

Instrumentul citește din stdin sau dintr-o cale de fișier, criptrează cu AES-256-GCM pe mașina dvs., încarcă doar textul criptat și afișează un URL cu cheia de decriptare inclusă în fragment.

Notele create în acest mod sunt urmărite în analitice ca creationSource: cli.

Instalare

Necesită Node.js 18+. Funcționează pe macOS, Linux și 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

Încearcă live

Rulează același flux ca în CLI, în browser: criptare locală, încărcarea textului criptat și afișarea unui URL cu cheia în fragment.

Demonstrație live — creează o notă reală pe privatenote.ai. Folosește un secret temporar, nu date de acces de producție.

echo 'sk-live-demo-replace-me' | npx privatenote-cli --expire 1h --output-url-only
https://privatenote.ai/note/…#…
# secret
--expire

Arhitectură de securitate

Textul clar nu părăsește niciodată mașina dvs. necriptat. Link-ul de partajare URL conține cheia de decriptare în fragmentul său (#), pe care browserele și clienții HTTP nu o trimit serverelor.

Când stdout nu este un TTY (este trimis prin pipe sau capturat), CLI refuză să afișeze un link decât dacă utilizați --output-url-only sau --force-stdout — acest lucru previne scurgerile accidentale în logurile CI.

Criptează local

AES-256-GCM pe dispozitivul tău — browser, editor, terminal sau proces MCP.

Încarcă textul criptat

Doar octeții criptați și metadatele notei (expirare, ștergere după citire) ajung la server.

Cheia în #fragment

Cheia de decriptare rămâne în fragmentul URL. Browserele nu trimit fragmentele în cererile HTTP.

privatenote.ai/note/…#key

Diagrama completă în hubul pentru dezvoltatori
  • HTTPS este necesar pentru origini API remote; utilizați --insecure doar pentru dezvoltare locală http:// (de exemplu, wrangler dev pe :8787).

  • PRIVATENOTE_ALLOWED_HOSTS fixează hostname-urile API atunci când se utilizează o bază URL API personalizată.

  • Validarea formei răspunsului și verificarea ID-urilor de notă rezervate înainte de încărcare.

  • Se recomandă redirecționarea ieșirii către un fișier cu chmod 600 în loc de afișarea URL-urilor.

Flag-uri și variabile de mediu

NumeDescriere
--expire 15m|1h|24h|7dDurata vieții notei (implicit: 24h)
--burn / --no-burnDistruge după prima vizualizare (implicit: burn)
--title <text>Titlu opțional adăugat înaintea conținutului
--jsonAfișează { secureUrl, expiresAt, burnAfterReading }
--output-url-onlyIeșire exclusiv URL; sigură pentru stdout prin pipe în scripturi
--force-stdoutPermite afișarea rezultatelor când stdout nu este un terminal (utilizați cu --json în CI)
--api-base-url <url>Suprascrie originea API (HTTPS; utilizați cu --insecure pentru http:// local)
--insecurePermite originile http:// API — doar pentru dezvoltare locală, niciodată în producție
PRIVATENOTE_API_BASE_URLBaza API implicită URL
PRIVATENOTE_WEB_ORIGINOriginea link-ului de partajare (implicit API origin)
PRIVATENOTE_ALLOWED_HOSTSListă de permisiuni hostname, separată prin virgulă

Integrări conexe

PrivateNote CLI

Secrete cu amprentă zero în scripturi, pipe-uri și CI — criptate local înainte ca orice să ajungă în rețea.

Foto: Léna Le Roy · Unsplash.