PrivateNote CLI
Spurenlose Geheimnisse in Skripten, Pipes und CI — lokal verschlüsselt, bevor etwas das Netzwerk erreicht.
Auf dieser Seite
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-onlyhttps://privatenote.ai/note/…#…
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
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
| Name | Beschreibung |
|---|---|
| --expire 15m|1h|24h|7d | Lebensdauer der Notiz (Standard: 24h) |
| --burn / --no-burn | Nach dem ersten Ansehen vernichten (Standard: burn) |
| --title <text> | Optionaler Titel, der dem Inhalt vorangestellt wird |
| --json | Druckt { secureUrl, expiresAt, burnAfterReading } |
| --output-url-only | URL-only Ausgabe; sicher für umgeleitetes stdout in Skripten |
| --force-stdout | Ausgabe 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) |
| --insecure | http:// API-Ursprünge zulassen — nur für lokale Entwicklung, niemals in der Produktion |
| PRIVATENOTE_API_BASE_URL | Standardmäßige API-Basis URL |
| PRIVATENOTE_WEB_ORIGIN | Share-Link-Ursprung (standardmäßig API-Ursprung) |
| PRIVATENOTE_ALLOWED_HOSTS | Kommagetrennte Hostname-Allowlist |
Verwandte Integrationen
Editor-Erweiterung
Erstellen Sie Notizen aus VS Code, Cursor oder Codex IDE heraus, ohne den Kontext zu wechseln. Nutzen Sie die Seitenleiste, einen Befehl für markierten Text oder die Aktion in der Titelleiste.
DokumentationMCP-Server
Geben Sie einem MCP-Client ein lokales Tool, das PrivateNote-Links erstellt, wenn ein Agent ein Geheimnis sicher übergeben muss.
DokumentationCodex-Plugin
Installieren Sie das mitgelieferte Plugin für MCP und Skills oder fügen Sie privatenote-mcp zu ~/.codex/config.toml hinzu. Für Geheimnisse, die der Agent nie sehen soll, nutzen Sie in Codex IDE dieselbe VS-Code-Erweiterung.
DokumentationChrome-Erweiterung
Verschlüsseln Sie markierten Text in jedem Tab per Kontextmenü, Symbolleiste oder Tastenkürzel — ohne die Website zu öffnen.
DokumentationPrivateNote CLI
Spurenlose Geheimnisse in Skripten, Pipes und CI — lokal verschlüsselt, bevor etwas das Netzwerk erreicht.
