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-onlyhttps://privatenote.ai/note/…#…
セキュリティアーキテクチャ
平文が暗号化されずにマシンから送信されることはありません。共有用の 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-only | URL のみ出力。スクリプト内でのパイプによる stdout に安全に使用可能 |
| --force-stdout | stdout がターミナルでない場合に、出力を許可する (CI では --json と併用) |
| --api-base-url <url> | API オリジンを上書き (HTTPS; ローカルの http:// では --insecure を使用) |
| --insecure | http:// API オリジンを許可 — ローカル開発のみ。本番環境では絶対に使用しないでください |
| PRIVATENOTE_API_BASE_URL | デフォルトの API ベース URL |
| PRIVATENOTE_WEB_ORIGIN | 共有リンクのオリジン (デフォルトは API オリジン) |
| PRIVATENOTE_ALLOWED_HOSTS | カンマ区切りのホスト名許可リスト |
関連する連携
エディタ拡張機能
コンテキストを切り替えることなく、VS Code、Cursor、またはCodex IDEからノートを作成します。サイドバー、選択テキストコマンド、またはタイトルバーのアクションを使用してください。
ドキュメントを見るMCPサーバー
プレビューと確認を経て、承認したローカルファイルを暗号化します。
ドキュメントを見るCodexプラグイン
MCP 用のバンドルプラグインとスキルをインストールするか、privatenote-mcp を ~/.codex/config.toml に追加してください。エージェントに決して見せない機密情報には、Codex IDE で同じ VS Code 拡張機能を使用してください。
ドキュメントを見るChrome拡張機能
サイトを事前に開くことなく、コンテキストメニュー、ツールバーのポップアップ、またはキーボードショートカットを介して、任意のタブから選択したテキストを暗号化します。
ドキュメントを見るPrivateNote CLI
スクリプト、パイプ、CIにおけるフットプリントゼロのシークレット管理 — ネットワークに送信される前にローカルで暗号化されます。
