PrivateNote CLI
Scriptlerde, boru hatlarında (pipes) ve CI süreçlerinde sıfır ayak izli sırlar — ağa ulaşmadan önce yerel olarak şifrelenir.
Bu sayfada
Kimler için
Sır zaten bir dosyada, parola yöneticisinde veya boru hattı çıktısında bulunuyorsa ve sohbet veya e-postaya yapıştırmadan paylaşılabilir bir bağlantıya ihtiyacınız varsa CLI kullanın.
Araç, stdin veya bir dosya yolundan okur, makinenizde AES-256-GCM ile şifreler, yalnızca şifreli metni yükler ve fragmanda şifre çözme anahtarını içeren bir URL yazdırır.
Bu şekilde oluşturulan notlar, analizlerde creationSource: cli olarak takip edilir.
Kurulum
Node.js 18+ gerektirir. macOS, Linux ve Windows üzerinde çalışır.
# 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
Canlı deneyin
CLI ile aynı akışı tarayıcınızda çalıştırın: yerel şifreleyin, şifreli metni yükleyin, anahtarı parçada olan bir URL yazdırın.
Canlı demo — privatenote.ai’de gerçek bir not oluşturur. Üretim kimlik bilgisi değil, atılabilir bir sır kullanın.
echo 'sk-live-demo-replace-me' | npx privatenote-cli --expire 1h --output-url-onlyhttps://privatenote.ai/note/…#…
Güvenlik mimarisi
Düz metin (plaintext) makinenizden asla şifrelenmemiş olarak çıkmaz. Paylaşım URL, tarayıcıların ve HTTP istemcilerinin sunuculara göndermediği şifre çözme anahtarını #fragment içinde taşır.
stdout bir TTY olmadığında (pipe edilmiş veya yakalanmış), CLI siz --output-url-only veya --force-stdout parametrelerini geçmedikçe bir bağlantı yazdırmayı reddeder — bu, CI günlüklerine kazara sızıntıları önler.
Yerel şifrele
Cihazınızda AES-256-GCM — tarayıcı, düzenleyici, terminal veya MCP süreci.
Şifreli metni yükle
Sunucuya yalnızca şifreli baytlar ve not üst verisi (süre sonu, okuduktan sonra imha) ulaşır.
Anahtar #parçada
Çözme anahtarı URL karmasında kalır. Tarayıcılar parçaları HTTP isteklerinde göndermez.
privatenote.ai/note/…#key
Uzak API kökenleri için HTTPS gereklidir; yalnızca yerel http:// geliştirme ortamları için (örneğin :8787 üzerindeki wrangler dev) --insecure parametresini geçin.
PRIVATENOTE_ALLOWED_HOSTS, özel bir API taban URL kullanırken API ana bilgisayar adlarını sabitler.
Yükleme öncesinde yanıt yapısı doğrulaması ve ayrılmış not ID kontrolleri.
URL'leri ekrana yazdırmak yerine, çıktıyı chmod 600 bir dosyaya yönlendirmeyi tercih edin.
Bayraklar ve ortam değişkenleri
| Ad | Açıklama |
|---|---|
| --expire 15m|1h|24h|7d | Not ömrü (varsayılan: 24h) |
| --burn / --no-burn | İlk görüntülemeden sonra yok et (varsayılan: burn) |
| --title <text> | İçeriğin başına eklenen isteğe bağlı başlık |
| --json | { secureUrl, expiresAt, burnAfterReading } yazdır |
| --output-url-only | URL-yalnızca çıktı; scriptlerde pipe edilmiş stdout için güvenlidir |
| --force-stdout | stdout bir terminal olmadığında çıktıya izin ver (CI'da --json ile kullanın) |
| --api-base-url <url> | API kökenini geçersiz kıl (HTTPS; yerel http:// için --insecure ile kullanın) |
| --insecure | http:// API kökenlerine izin ver — yalnızca yerel geliştirme, asla üretim ortamında değil |
| PRIVATENOTE_API_BASE_URL | Varsayılan API taban URL |
| PRIVATENOTE_WEB_ORIGIN | Paylaşım bağlantısı kökeni (API kökenini varsayılan olarak kullanır) |
| PRIVATENOTE_ALLOWED_HOSTS | Virgülle ayrılmış ana bilgisayar izin listesi |
İlgili entegrasyonlar
Düzenleyici uzantısı
Bağlam değiştirmeden VS Code, Cursor veya Codex IDE’den not oluşturun. Kenar çubuğunu, seçili metin komutunu veya başlık çubuğu eylemini kullanın.
Belgeleri görüntüleMCP sunucusu
Bir MCP istemcisine, ajanın sır teslim etmesi gerektiğinde PrivateNote bağlantıları oluşturan yerel bir araç verin.
Belgeleri görüntüleCodex eklentisi
MCP ve beceriler için paketlenmiş eklentiyi yükleyin veya privatenote-mcp’yi ~/.codex/config.toml’a ekleyin. Ajanın asla görmemesi gereken sırlar için Codex IDE’de aynı VS Code uzantısını kullanın.
Belgeleri görüntüleChrome uzantısı
Herhangi bir sekmeden seçili metni bağlam menüsü, araç çubuğu açılır penceresi veya klavye kısayoluyla şifreleyin — siteyi önce açmadan.
Belgeleri görüntülePrivateNote CLI
Scriptlerde, boru hatlarında (pipes) ve CI süreçlerinde sıfır ayak izli sırlar — ağa ulaşmadan önce yerel olarak şifrelenir.
