PrivateNote CLI
Секрети з нульовим слідом у скриптах, конвеєрах (pipes) та 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 (перенаправлено через pipe або захоплено), CLI відмовляється друкувати посилання, якщо ви не передасте --output-url-only або --force-stdout — це запобігає випадковим витокам у логи CI.
Шифрування локально
AES-256-GCM на вашому пристрої — у браузері, редакторі, терміналі або процесі MCP.
Завантаження зашифрованого тексту
На сервер потрапляють лише зашифровані байти й метадані нотатки (строк дії, видалення після прочитання).
Ключ у #fragment
Ключ розшифрування залишається в хеші URL. Браузери не надсилають фрагменти в HTTP-запитах.
privatenote.ai/note/…#key
HTTPS обов'язковий для віддалених джерел API; використовуйте --insecure лише для локальної розробки http:// (наприклад, wrangler dev на :8787).
PRIVATENOTE_ALLOWED_HOSTS фіксує хостнейми API при використанні кастомної бази API URL.
Валідація структури відповіді та перевірка зарезервованих ID нотаток перед завантаженням.
Краще перенаправляти вивід у файл із chmod 600 замість виведення URL у консоль.
Прапорці та змінні оточення
| Назва | Опис |
|---|---|
| --expire 15m|1h|24h|7d | Термін дії нотатки (за замовчуванням: 24h) |
| --burn / --no-burn | Видалити після першого перегляду (за замовчуванням: burn) |
| --title <text> | Необов'язковий заголовок, що додається перед контентом |
| --json | Друкувати { secureUrl, expiresAt, burnAfterReading } |
| --output-url-only | Вивід лише URL; безпечно для перенаправлення stdout у скриптах |
| --force-stdout | Дозволити вивід, коли stdout не є терміналом (використовуйте з --json у CI) |
| --api-base-url <url> | Перевизначити джерело API (HTTPS; використовуйте з --insecure для локального http://) |
| --insecure | Дозволити джерела http:// API — лише для локальної розробки, ніколи у продакшені |
| PRIVATENOTE_API_BASE_URL | Базова URL API за замовчуванням |
| PRIVATENOTE_WEB_ORIGIN | Джерело посилання для поширення (за замовчуванням — джерело API) |
| PRIVATENOTE_ALLOWED_HOSTS | Список дозволених хостнеймів через кому |
Пов’язані інтеграції
Розширення для редактора
Створюйте нотатки з VS Code, Cursor або Codex IDE, не змінюючи контекст. Використовуйте бічну панель, команду для виділеного тексту або дію в заголовку вікна.
Переглянути документаціюСервер MCP
Попередній перегляд і підтвердження перед шифруванням локального файлу після вашого схвалення.
Переглянути документаціюПлагін Codex
Встановіть вбудований плагін для MCP плюс навичок або додайте privatenote-mcp до ~/.codex/config.toml. Використовуйте те саме VS Code розширення в Codex IDE для секретів, яких агент ніколи не побачить.
Переглянути документаціюРозширення Chrome
Шифруйте виділений текст з будь-якої вкладки через контекстне меню, спливаюче вікно панелі інструментів або гарячі клавіші — без попереднього відкриття сайту.
Переглянути документаціюPrivateNote CLI
Секрети з нульовим слідом у скриптах, конвеєрах (pipes) та CI — вони шифруються локально ще до того, як потраплять у мережу.
