PrivateNote CLI

スクリプト、パイプ、CIにおけるフットプリントゼロのシークレット管理 — ネットワークに送信される前にローカルで暗号化されます。

対象ユーザー

シークレットが既にファイル、パスワードマネージャー、またはパイプラインの出力に存在しており、チャットやメールに貼り付けることなく共有可能なリンクが必要な場合は、CLI を使用してください。

このツールは stdin またはファイルパスから読み込み、お客様のマシン上で AES-256-GCM を使用して暗号化し、暗号文のみをアップロードします。その後、フラグメントに復号キーを含む URL を出力します。

この方法で作成されたノートは、アナリティクスで creationSource: cli として追跡されます。

インストール

Node.js 18+ が必要です。macOS、Linux、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

実際に試す

ブラウザーでCLIと同じ手順を実行します。ローカルで暗号化し、暗号文をアップロードし、フラグメントに鍵を含むURLを出力します。

実際のデモです。privatenote.ai に本物のノートを作成します。本番の認証情報ではなく、使い捨ての秘密を使用してください。

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

セキュリティアーキテクチャ

平文が暗号化されずにマシンから送信されることはありません。共有用の URL は #fragment に復号キーを含んでおり、ブラウザや HTTP クライアントはこれをサーバーに送信しません。

stdout が TTY ではない場合(パイプまたはキャプチャ時)、--output-url-only または --force-stdout を指定しない限り、CLI はリンクの出力を拒否します。これにより、CI ログへの誤った漏洩を防ぎます。

ローカルで暗号化

端末上で AES-256-GCM を実行 — ブラウザー、エディター、ターミナル、MCPプロセス。

暗号文をアップロード

暗号化されたバイトとノートのメタデータ(有効期限、開封後削除)のみがサーバーに送信されます。

鍵は #fragment 内

復号鍵はURLのハッシュ部分に保持されます。ブラウザーはHTTPリクエストでフラグメントを送信しません。

privatenote.ai/note/…#key

開発者ハブの全体図
  • リモートの API オリジンには HTTPS が必要です。ローカルの http:// 開発環境(例::8787 上の wrangler dev)でのみ --insecure を指定してください。

  • カスタム API ベース URL を使用する場合、PRIVATENOTE_ALLOWED_HOSTS は API ホスト名を固定します。

  • アップロード前のレスポンス形状の検証および予約済みノート ID のチェック。

  • URL をエコーする代わりに、出力を chmod 600 ファイルにリダイレクトすることを推奨します。

フラグおよび環境変数

名前説明
--expire 15m|1h|24h|7dノートの有効期限 (デフォルト: 24h)
--burn / --no-burn初回閲覧後に削除 (デフォルト: burn)
--title <text>コンテンツの前に付与するオプションのタイトル
--json{ secureUrl, expiresAt, burnAfterReading } を出力
--output-url-onlyURL のみ出力。スクリプト内でのパイプによる stdout に安全に使用可能
--force-stdoutstdout がターミナルでない場合に、出力を許可する (CI では --json と併用)
--api-base-url <url>API オリジンを上書き (HTTPS; ローカルの http:// では --insecure を使用)
--insecurehttp:// API オリジンを許可 — ローカル開発のみ。本番環境では絶対に使用しないでください
PRIVATENOTE_API_BASE_URLデフォルトの API ベース URL
PRIVATENOTE_WEB_ORIGIN共有リンクのオリジン (デフォルトは API オリジン)
PRIVATENOTE_ALLOWED_HOSTSカンマ区切りのホスト名許可リスト

関連する連携

PrivateNote CLI

スクリプト、パイプ、CIにおけるフットプリントゼロのシークレット管理 — ネットワークに送信される前にローカルで暗号化されます。

写真: Léna Le Roy · Unsplash.