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 через 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 | Список разрешенных хостов через запятую |
Связанные интеграции
Расширение для редактора
Создавайте заметки из VS Code, Cursor или Codex IDE, не переключая контекст. Используйте боковую панель, команду для выделенного текста или действие в заголовке окна.
Открыть документациюСервер MCP
Предварительный просмотр и подтверждение перед шифрованием локального файла после вашего одобрения.
Открыть документациюПлагин Codex
Установите входящий плагин для MCP plus skills или добавьте privatenote-mcp в ~/.codex/config.toml. Используйте то же расширение VS Code в Codex IDE для секретов, которые агент никогда не увидит.
Открыть документациюРасширение Chrome
Шифруйте выделенный текст на любой вкладке через контекстное меню, всплывающее окно панели инструментов или сочетание клавиш — без предварительного открытия сайта.
Открыть документациюPrivateNote CLI
Секреты без следов в скриптах, конвейерах (pipes) и CI — шифруются локально до того, как что-либо попадет в сеть.
