PrivateNote CLI

Segreti a zero impronta in script, pipe e CI — crittografati localmente prima che qualsiasi cosa raggiunga la rete.

A chi è rivolto

Usa il CLI quando il segreto risiede già in un file, in un password manager o nell'output di una pipeline e hai bisogno di un link condivisibile senza incollarlo in chat o email.

Lo strumento legge da stdin o da un percorso file, crittografa con AES-256-GCM sulla tua macchina, carica solo il testo cifrato e stampa un URL con la chiave di decrittazione nel frammento.

Le note create in questo modo sono tracciate come creationSource: cli nelle analisi.

Installa

Richiede Node.js 18+. Funziona su macOS, Linux e 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

Prova dal vivo

Lo stesso flusso della CLI nel browser: cifra localmente, carica il ciphertext, stampa un URL con la chiave nel fragment.

Demo live — crea una nota reale su privatenote.ai. Usa un segreto usa e getta, non credenziali di produzione.

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

Architettura di sicurezza

Il testo in chiaro non lascia mai la tua macchina senza crittografia. Il link di condivisione URL contiene la chiave di decrittazione nel suo #fragment, che i browser e i client HTTP non inviano ai server.

Quando stdout non è un TTY (piped o catturato), il CLI rifiuta di stampare un link a meno che non si passi --output-url-only o --force-stdout — questo evita fughe accidentali nei log della CI.

Cifra localmente

AES-256-GCM sul tuo dispositivo — browser, editor, terminale o processo MCP.

Carica ciphertext

Solo byte cifrati e metadati della nota (scadenza, burn-after-reading) raggiungono il server.

Chiave in #fragment

La chiave di decrittografia resta nell'hash dell'URL. I browser non inviano i fragment nelle richieste HTTP.

privatenote.ai/note/…#key

Diagramma completo sull'hub sviluppatori
  • HTTPS richiesto per origini API remote; passa --insecure solo per lo sviluppo locale http:// (es. wrangler dev su :8787).

  • PRIVATENOTE_ALLOWED_HOSTS blocca gli hostname API quando si utilizza una base URL API personalizzata.

  • Validazione della forma della risposta e controlli degli ID nota riservati prima del caricamento.

  • Si preferisce reindirizzare l'output in un file con chmod 600 invece di stampare gli URL.

Flag e variabili d'ambiente

NomeDescrizione
--expire 15m|1h|24h|7dDurata della nota (default: 24h)
--burn / --no-burnDistruggi dopo la prima visualizzazione (default: burn)
--title <text>Titolo opzionale aggiunto all'inizio del contenuto
--jsonStampa { secureUrl, expiresAt, burnAfterReading }
--output-url-onlyOutput solo URL; sicuro per stdout in pipe negli script
--force-stdoutConsenti l'output quando stdout non è un terminale (usa con --json nella CI)
--api-base-url <url>Sovrascrivi l'origine API (HTTPS; usa --insecure per http:// locale)
--insecureConsenti origini http:// API — solo per sviluppo locale, mai in produzione
PRIVATENOTE_API_BASE_URLBase API predefinita URL
PRIVATENOTE_WEB_ORIGINOrigine del link di condivisione (predefinita: origine API)
PRIVATENOTE_ALLOWED_HOSTSWhitelist hostname separati da virgola

Integrazioni correlate

PrivateNote CLI

Segreti a zero impronta in script, pipe e CI — crittografati localmente prima che qualsiasi cosa raggiunga la rete.

Foto: Léna Le Roy · Unsplash.