PrivateNote CLI

Rahasia tanpa jejak (zero-footprint) dalam skrip, pipe, dan CI — dienkripsi secara lokal sebelum apa pun mencapai jaringan.

Untuk siapa ini

Gunakan CLI ketika rahasia sudah ada dalam file, pengelola kata sandi, atau output pipeline dan Anda memerlukan tautan yang dapat dibagikan tanpa menempelkannya ke chat atau email.

Alat ini membaca dari stdin atau jalur file, mengenkripsi dengan AES-256-GCM di mesin Anda, hanya mengunggah ciphertext, dan mencetak URL dengan kunci dekripsi di bagian fragment.

Catatan yang dibuat dengan cara ini dilacak sebagai creationSource: cli dalam analitik.

Instal

Memerlukan Node.js 18+. Berjalan di macOS, Linux, dan 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

Coba langsung

Jalankan alur yang sama seperti CLI di browser Anda: enkripsi secara lokal, unggah teks terenkripsi, cetak URL dengan kunci di fragmen.

Demo langsung — membuat catatan nyata di privatenote.ai. Gunakan rahasia sekali pakai, bukan kredensial produksi.

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

Arsitektur keamanan

Teks biasa tidak pernah meninggalkan mesin Anda tanpa enkripsi. URL berbagi membawa kunci dekripsi dalam #fragment-nya, yang tidak dikirimkan oleh browser dan klien HTTP ke server.

Ketika stdout bukan merupakan TTY (dialirkan atau ditangkap), CLI menolak untuk mencetak tautan kecuali Anda menyertakan --output-url-only atau --force-stdout — ini mencegah kebocoran tidak sengaja ke log CI.

Enkripsi secara lokal

AES-256-GCM di perangkat Anda — browser, editor, terminal, atau proses MCP.

Unggah teks terenkripsi

Hanya byte terenkripsi dan metadata catatan (kedaluwarsa, hapus setelah dibaca) yang mencapai server.

Kunci di #fragment

Kunci dekripsi tetap berada di hash URL. Browser tidak mengirim fragmen dalam permintaan HTTP.

privatenote.ai/note/…#key

Diagram lengkap di hub pengembang
  • HTTPS diperlukan untuk asal API jarak jauh; gunakan --insecure hanya untuk pengembangan http:// lokal (misalnya, wrangler dev pada :8787).

  • PRIVATENOTE_ALLOWED_HOSTS menyematkan hostname API saat menggunakan base API URL kustom.

  • Validasi bentuk respons dan pemeriksaan ID catatan yang dicadangkan sebelum unggah.

  • Lebih baik mengalihkan output ke file chmod 600 daripada menampilkan URL.

Flag dan variabel lingkungan

NamaDeskripsi
--expire 15m|1h|24h|7dMasa berlaku catatan (default: 24h)
--burn / --no-burnHancurkan setelah dilihat pertama kali (default: burn)
--title <text>Judul opsional yang ditambahkan di awal konten
--jsonCetak { secureUrl, expiresAt, burnAfterReading }
--output-url-onlyOutput URL saja; aman untuk piped stdout dalam skrip
--force-stdoutIzinkan output saat stdout bukan terminal (gunakan dengan --json di CI)
--api-base-url <url>Timpa asal API (HTTPS; gunakan dengan --insecure untuk http:// lokal)
--insecureIzinkan asal http:// API — hanya untuk pengembangan lokal, jangan pernah di produksi
PRIVATENOTE_API_BASE_URLBase API default URL
PRIVATENOTE_WEB_ORIGINAsal tautan berbagi (default ke asal API)
PRIVATENOTE_ALLOWED_HOSTSDaftar putih hostname yang dipisahkan dengan koma

Integrasi terkait

PrivateNote CLI

Rahasia tanpa jejak (zero-footprint) dalam skrip, pipe, dan CI — dienkripsi secara lokal sebelum apa pun mencapai jaringan.

Foto: Léna Le Roy · Unsplash.