PrivateNote CLI
Segreti a zero impronta in script, pipe e CI — crittografati localmente prima che qualsiasi cosa raggiunga la rete.
In questa pagina
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-onlyhttps://privatenote.ai/note/…#…
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
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
| Nome | Descrizione |
|---|---|
| --expire 15m|1h|24h|7d | Durata della nota (default: 24h) |
| --burn / --no-burn | Distruggi dopo la prima visualizzazione (default: burn) |
| --title <text> | Titolo opzionale aggiunto all'inizio del contenuto |
| --json | Stampa { secureUrl, expiresAt, burnAfterReading } |
| --output-url-only | Output solo URL; sicuro per stdout in pipe negli script |
| --force-stdout | Consenti 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) |
| --insecure | Consenti origini http:// API — solo per sviluppo locale, mai in produzione |
| PRIVATENOTE_API_BASE_URL | Base API predefinita URL |
| PRIVATENOTE_WEB_ORIGIN | Origine del link di condivisione (predefinita: origine API) |
| PRIVATENOTE_ALLOWED_HOSTS | Whitelist hostname separati da virgola |
Integrazioni correlate
Estensione dell'editor
Crea note da VS Code, Cursor o Codex IDE senza cambiare contesto. Usa la barra laterale, un comando sul testo selezionato o l’azione nella barra del titolo.
DocumentazioneServer MCP
Aggiungi a un client MCP uno strumento locale che crea link PrivateNote quando un agente deve trasmettere un segreto.
DocumentazionePlugin Codex
Installa il plugin incluso per MCP e skill, oppure aggiungi privatenote-mcp a ~/.codex/config.toml. In Codex IDE usa la stessa estensione VS Code per i segreti che l’agente non deve mai vedere.
DocumentazioneEstensione Chrome
Cifra il testo selezionato in qualsiasi scheda tramite menu contestuale, barra degli strumenti o scorciatoia — senza aprire il sito.
DocumentazionePrivateNote CLI
Segreti a zero impronta in script, pipe e CI — crittografati localmente prima che qualsiasi cosa raggiunga la rete.
