PrivateNote CLI

Spurenlose Geheimnisse in Skripten, Pipes und CI — lokal verschlüsselt, bevor etwas das Netzwerk erreicht.

Für wen dies gedacht ist

Nutzen Sie den CLI, wenn das Geheimnis bereits in einer Datei, einem Passwortmanager oder einem Pipeline-Output existiert und Sie einen teilbaren Link benötigen, ohne ihn in Chat oder E-Mail einzufügen.

Das Tool liest von stdin oder einem Dateipfad, verschlüsselt mit AES-256-GCM auf Ihrem Rechner, lädt nur den Geheimtext hoch und gibt einen URL mit dem Entschlüsselungsschlüssel im Fragment aus.

Auf diese Weise erstellte Notizen werden in der Analyse als creationSource: cli erfasst.

Installation

Erfordert Node.js 18+. Funktioniert auf macOS, Linux und 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 ausprobieren

Derselbe Ablauf wie die CLI im Browser: lokal verschlüsseln, Chiffretext hochladen, URL mit Schlüssel im Fragment ausgeben.

Live-Demo — erstellt eine echte Notiz auf privatenote.ai. Nur Wegwerf-Geheimnisse verwenden.

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

Sicherheitsarchitektur

Klartext verlässt Ihre Maschine niemals unverschlüsselt. Der Share URL enthält den Entschlüsselungsschlüssel in seinem #fragment, welches Browser und HTTP-Clients nicht an Server senden.

Wenn stdout kein TTY ist (umgeleitet oder erfasst), verweigert der CLI die Ausgabe eines Links, es sei denn, Sie übergeben --output-url-only oder --force-stdout — dies verhindert versehentliches Auslaufen in CI-Logs.

Lokal verschlüsseln

AES-256-GCM auf Ihrem Gerät — Browser, Editor, Terminal oder MCP-Prozess.

Chiffretext hochladen

Nur verschlüsselte Bytes und Notiz-Metadaten (Ablauf, Burn-after-reading) erreichen den Server.

Schlüssel in #fragment

Der Entschlüsselungsschlüssel bleibt im URL-Hash. Browser senden Fragmente nicht in HTTP-Anfragen.

privatenote.ai/note/…#key

Vollständiges Diagramm im Developer-Hub
  • HTTPS erforderlich für remote API-Origins; verwenden Sie --insecure nur für lokale http:// Dev-Umgebungen (z. B. wrangler dev auf :8787).

  • PRIVATENOTE_ALLOWED_HOSTS pinnt API-Hostnames bei Verwendung einer benutzerdefinierten API Base URL.

  • Validierung der Response-Struktur und Prüfung auf reservierte Notiz-IDs vor dem Upload.

  • Leiten Sie die Ausgabe vorzugsweise in eine Datei mit chmod 600 um, anstatt URLs per Echo auszugeben.

Flags und Umgebungsvariablen

NameBeschreibung
--expire 15m|1h|24h|7dLebensdauer der Notiz (Standard: 24h)
--burn / --no-burnNach dem ersten Ansehen vernichten (Standard: burn)
--title <text>Optionaler Titel, der dem Inhalt vorangestellt wird
--jsonDruckt { secureUrl, expiresAt, burnAfterReading }
--output-url-onlyURL-only Ausgabe; sicher für umgeleitetes stdout in Skripten
--force-stdoutAusgabe zulassen, wenn stdout kein Terminal ist (in CI mit --json verwenden)
--api-base-url <url> API-Ursprung überschreiben (HTTPS; lokal mit --insecure für http:// verwenden)
--insecurehttp:// API-Ursprünge zulassen — nur für lokale Entwicklung, niemals in der Produktion
PRIVATENOTE_API_BASE_URLStandardmäßige API-Basis URL
PRIVATENOTE_WEB_ORIGINShare-Link-Ursprung (standardmäßig API-Ursprung)
PRIVATENOTE_ALLOWED_HOSTSKommagetrennte Hostname-Allowlist

Verwandte Integrationen

PrivateNote CLI

Spurenlose Geheimnisse in Skripten, Pipes und CI — lokal verschlüsselt, bevor etwas das Netzwerk erreicht.

Foto: Léna Le Roy · Unsplash.