Стабильныйprivatenote-cli@0.1.0

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 через echo.

Флаги и переменные окружения

НазваниеОписание
--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Базовый API URL по умолчанию
PRIVATENOTE_WEB_ORIGINИсточник ссылки для обмена (по умолчанию API источник)
PRIVATENOTE_ALLOWED_HOSTSСписок разрешенных хостов через запятую

Связанные интеграции

PrivateNote CLI

Секреты без следов в скриптах, конвейерах (pipes) и CI — шифруются локально до того, как что-либо попадет в сеть.

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