PrivateNote CLI

Sekrety bez śladu w skryptach, potokach i CI — szyfrowane lokalnie, zanim cokolwiek trafi do sieci.

Dla kogo to jest

Użyj CLI, gdy sekret znajduje się już w pliku, menedżerze haseł lub wyjściu potoku, a Ty potrzebujesz linku do udostępnienia bez wklejania go na czacie lub w e-mailu.

Narzędzie czyta dane ze stdin lub ścieżki do pliku, szyfruje je za pomocą AES-256-GCM na Twojej maszynie, przesyła wyłącznie szyfrogram i wyświetla URL z kluczem deszyfrującym w fragmencie adresu.

Notatki utworzone w ten sposób są śledzone w analityce jako creationSource: cli.

Instalacja

Wymaga Node.js 18+. Działa na macOS, Linux i 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

Wypróbuj na żywo

Uruchom ten sam przepływ co CLI w przeglądarce: szyfruj lokalnie, prześlij szyfrogram, wypisz URL z kluczem we fragmencie.

Demo na żywo — tworzy prawdziwą notatkę na privatenote.ai. Użyj jednorazowej tajemnicy, nie danych produkcyjnych.

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

Architektura bezpieczeństwa

Tekst jawny nigdy nie opuszcza Twojej maszyny w formie nieszyfrowanej. Link do udostępniania URL zawiera klucz deszyfrujący w swoim #fragmencie, którego przeglądarki i klienci HTTP nie wysyłają do serwerów.

Gdy stdout nie jest terminalem TTY (dane są przekazywane przez potok lub przechwytywane), CLI odmawia wyświetlenia linku, chyba że użyjesz --output-url-only lub --force-stdout — zapobiega to przypadkowym wyciekom do logów CI.

Szyfruj lokalnie

AES-256-GCM na urządzeniu — przeglądarka, edytor, terminal lub proces MCP.

Prześlij szyfrogram

Na serwer trafiają tylko zaszyfrowane bajty i metadane notatki (wygaśnięcie, zniszczenie po przeczytaniu).

Klucz we fragmencie #

Klucz odszyfrowania zostaje w hashu URL. Przeglądarki nie wysyłają fragmentów w żądaniach HTTP.

privatenote.ai/note/…#key

Pełny diagram w hubie dla programistów
  • HTTPS jest wymagany dla zdalnych pochodzeń API; użyj --insecure tylko podczas lokalnego programowania http:// (np. wrangler dev na :8787).

  • PRIVATENOTE_ALLOWED_HOSTS przypina nazwy hostów API podczas używania niestandardowej bazy API URL.

  • Walidacja kształtu odpowiedzi i sprawdzanie zastrzeżonych identyfikatorów notatek przed przesłaniem.

  • Zamiast wyświetlania adresów URL, lepiej przekierować wyjście do pliku z uprawnieniami chmod 600.

Flagi i zmienne środowiskowe

NazwaOpis
--expire 15m|1h|24h|7dCzas życia notatki (domyślnie: 24h)
--burn / --no-burnZniszcz po pierwszym odczycie (domyślnie: burn)
--title <text>Opcjonalny tytuł dodawany przed treścią
--jsonWyświetl { secureUrl, expiresAt, burnAfterReading }
--output-url-onlyWyjście tylko URL; bezpieczne dla przekazywanego stdout w skryptach
--force-stdoutZezwól na wyjście, gdy stdout nie jest terminalem (użyj z --json w CI)
--api-base-url <url>Nadpisz pochodzenie API (HTTPS; użyj z --insecure dla lokalnego http://)
--insecureZezwól na pochodzenia http:// API — tylko do lokalnego rozwoju, nigdy na produkcji
PRIVATENOTE_API_BASE_URLDomyślna baza API URL
PRIVATENOTE_WEB_ORIGINPochodzenie linku do udostępniania (domyślnie pochodzenie API)
PRIVATENOTE_ALLOWED_HOSTSLista dozwolonych nazw hostów oddzielona przecinkami

Powiązane integracje

PrivateNote CLI

Sekrety bez śladu w skryptach, potokach i CI — szyfrowane lokalnie, zanim cokolwiek trafi do sieci.

Zdjęcie: Léna Le Roy · Unsplash.