PrivateNote CLI

Zero-footprint geheimen in scripts, pipes en CI — lokaal versleuteld voordat er iets het netwerk bereikt.

Voor wie dit is

Gebruik CLI wanneer het geheim al in een bestand, wachtwoordbeheerder of pipeline-output staat en je een deelbare link nodig hebt zonder het in een chat of e-mail te plakken.

De tool leest van stdin of een bestandspad, versleutelt met AES-256-GCM op je eigen machine, uploadt alleen de cijfertekst en print een URL met de decryptiesleutel in het fragment.

Notities die op deze manier zijn gemaakt, worden in de analytics bijgehouden als creationSource: cli.

Installeren

Vereist Node.js 18+. Werkt op macOS, Linux en 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

Live proberen

Dezelfde flow als de CLI in de browser: lokaal versleutelen, ciphertext uploaden, URL met sleutel in het fragment printen.

Live demo — maakt een echte notitie op privatenote.ai. Gebruik een wegwerpgeheim, geen productie-credentials.

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

Beveiligingsarchitectuur

Plattekst verlaat je machine nooit ongecodeerd. De deelbare URL bevat de decryptiesleutel in zijn #fragment, wat browsers en HTTP clients niet naar servers sturen.

Wanneer stdout geen TTY is (gepipe of opgevangen), weigert CLI een link te printen tenzij je --output-url-only of --force-stdout gebruikt — dit voorkomt onbedoelde lekken in CI-logs.

Lokaal versleutelen

AES-256-GCM op uw apparaat — browser, editor, terminal of MCP-proces.

Ciphertext uploaden

Alleen versleutelde bytes en notitie-metadata (verval, burn-after-reading) bereiken de server.

Sleutel in #fragment

De decoderingssleutel blijft in de URL-hash. Browsers sturen fragmenten niet mee in HTTP-verzoeken.

privatenote.ai/note/…#key

Volledig diagram op developer hub
  • HTTPS vereist voor externe API origins; gebruik --insecure alleen voor lokale http:// dev (bijv. wrangler dev op :8787).

  • PRIVATENOTE_ALLOWED_HOSTS legt API hostnames vast bij gebruik van een aangepaste API base URL.

  • Validatie van de response shape en controles op gereserveerde note ID's vóór upload.

  • Geef de voorkeur aan het omleiden van de output naar een chmod 600 bestand in plaats van het echoën van URL's.

Flags en omgevingsvariabelen

NaamBeschrijving
--expire 15m|1h|24h|7dLevensduur van de notitie (standaard: 24h)
--burn / --no-burnVernietigen na eerste weergave (standaard: burn)
--title <text>Optionele titel die aan de inhoud wordt toegevoegd
--jsonPrint { secureUrl, expiresAt, burnAfterReading }
--output-url-onlyURL-only output; veilig voor gepipte stdout in scripts
--force-stdoutOutput toestaan wanneer stdout geen terminal is (gebruik met --json in CI)
--api-base-url <url>Overschrijf API origin (HTTPS; gebruik met --insecure voor lokale http://)
--insecureToestaan van http:// API origins — alleen lokale dev, nooit in productie
PRIVATENOTE_API_BASE_URLStandaard API base URL
PRIVATENOTE_WEB_ORIGINShare-link origin (standaard API origin)
PRIVATENOTE_ALLOWED_HOSTSDoor komma's gescheiden hostname allowlist

Gerelateerde integraties

PrivateNote CLI

Zero-footprint geheimen in scripts, pipes en CI — lokaal versleuteld voordat er iets het netwerk bereikt.

Foto: Léna Le Roy · Unsplash.