Стабільнийprivatenote-cli

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-only
https://privatenote.ai/note/…#…
# secret
--expire

Архітектура безпеки

Відкритий текст ніколи не залишає ваш пристрій незашифрованим. Посилання для обміну 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Список дозволених хостнеймів через кому

Пов’язані інтеграції

PrivateNote CLI

Секрети з нульовим слідом у скриптах, конвеєрах (pipes) та CI — вони шифруються локально ще до того, як потраплять у мережу.

Фото: Léna Le Roy · Unsplash.