Начало работы с Notez CLI

terminalDenis Povarov30 августа 2026 г.

Notez CLI — нативный бинарник на 3 МБ, который записывает заметки из шелла. Никакого рантайма Node, никакого демона, никакого конфига, который надо писать руками: вы устанавливаете CLI, один раз авторизуете терминал, и дальше notez "ваша мысль" отправляет мысль в ваше рабочее пространство. Работает на macOS, Linux и Windows.

Ниже — установка, первая настройка и несколько флагов, которые стоит знать.

Установка

На macOS или Linux:

curl -fsSL https://notez.dev/install.sh | sh

Скрипт скачивает последнюю версию бинарника для вашей платформы, сверяет его контрольную сумму SHA256 и кладёт notez в /usr/local/bin (а если туда нет прав на запись — в ~/.local/bin).

На Windows, в PowerShell:

iwr -useb https://notez.dev/install.ps1 | iex

Эта команда устанавливает CLI в %LOCALAPPDATA%\Programs\notez и добавляет его в пользовательский PATH.

Если вы не хотите передавать скрипт в шелл через пайп — разумная осторожность, — бинарники лежат прямо на https://notez.dev/downloads/cli/: для macOS (arm64 и x64), Linux (x64 и arm64) и Windows, у каждого рядом файл .sha256 для ручной проверки. Распакуйте архив и положите notez в любую папку из $PATH.

Одно замечание про macOS: если скачать архив через браузер, а не через curl, Gatekeeper отправит его в карантин. Снимите атрибут один раз командой xattr -d com.apple.quarantine /path/to/notez.

Авторизация терминала

notez login

Команда открывает в браузере notez.dev/cli-auth. Там вы выбираете рабочее пространство, которым владеете, и подтверждаете терминал: настроить CLI для рабочего пространства может только его владелец. Notez создаёт долгоживущий API-ключ, который действует только в этом рабочем пространстве и умеет только создавать заметки и загружать файлы, и CLI сохраняет его локально:

macOS: ~/Library/Application Support/notez/config.toml
Linux: ~/.config/notez/config.toml
Windows: %APPDATA%\notez\config.toml

Ключ можно в любой момент отозвать в разделе Настройки → Интеграции → Notez CLI — это пригодится, если ноутбук потерялся или у общего компьютера больше не должно быть доступа. notez logout удаляет ключ с компьютера.

Запись заметок

Основной сценарий — одна команда:

notez "retry storm happens when the circuit breaker resets too early"

Текст становится заметкой в вашем рабочем пространстве, и поиск находит её сразу. Для остальных повседневных случаев хватает нескольких вариантов:

# Pipe output into a note
grep -c ERROR app.log | notez

# Give the note an explicit title (otherwise the text is used)
notez --title "Incident 2026-08-30" "db failover took 40s, alarms fired late"

# Capture a URL — auto-detected and stored as a bookmark
notez "https://docs.anthropic.com/quickstart"

# Upload a file — a path that exists is detected and uploaded
notez ./architecture-diagram.png

Пайп стоит выделить отдельно. Всё, что выдаёт ваш шелл, — вывод упавшего теста, стектрейс, сочетание флагов, которое наконец сработало, — записывается в тот момент, когда оно на экране, без выделения текста и переключения окон.

Скрипты с --json

notez --json "..." печатает созданную заметку в JSON, и CLI встраивается в цепочки команд. Пара практических примеров:

# Capture and keep the note id for later reference
NOTE_ID=$(notez --json "deploy checklist for v2.3" | jq -r .id)

# A git hook that logs every release
notez "released $(git describe --tags) to production"

CLI — это один быстрый бинарник, поэтому он работает там, где более тяжёлым инструментам тесно: в CI-задачах, на удалённых серверах по SSH, в панели tmux, которую вы держите открытой рядом с редактором.

Куда попадают заметки

Всё, что записывает CLI, попадает в то же хранилище, что и записи из других мест Notez: веб-приложения, адресной строки (notez.dev/ваша мысль) и ИИ-инструментов, подключённых по MCP. В веб-приложении записи можно просматривать и искать, ставить им теги, связывать с другими заметками или превращать сырую запись в структурированный документ в полноценном редакторе.

Поиск в Notez работает по смыслу, а не только по ключевым словам, поэтому короткую запись вроде notez "курсорная пагинация быстрее offset на больших таблицах" потом находит запрос «производительность пагинации», хотя вы не ставили ей тегов и никуда её не раскладывали.

Привычка, которая приживается

CLI окупается, когда вы снижаете планку того, что заслуживает заметки. Если до приложения для заметок двадцать секунд, планку проходят только важные мысли, а большинство мелких — обходной путь, нужный флаг, недодуманная идея — испаряются. Когда запись занимает две секунды, планку проходит всё.

Несколько привычек, которые стоит перенять:

Записывайте исправление, а не только баг. Как только что-то наконец заработало, отправьте причину через notez "...". Когда та же ошибка повторится, вы будете искать как раз эту запись.
Фиксируйте решения сразу. Одна строка о том, почему вы выбрали подход A, а не B, лучше, чем восстанавливать это потом на ревью дизайн-документа.
Пайп вместо копирования. Если текст уже в терминале, | notez быстрее и точнее, чем копировать его в графическое приложение.

Если что-то не работает

Если notez login сообщает, что не может связаться с CLI на вашем компьютере, скорее всего, истекло время ожидания авторизации — запустите notez login ещё раз. Если ключ перестал работать, проверьте Настройки → Интеграции → Notez CLI: терминал, отозванный там, отключается сразу, а повторный notez login на этом компьютере выдаёт новый ключ.

Вот и весь инструмент. notez --help показывает все команды, notez update ставит последнюю версию поверх текущей, а суть умещается в одну строку: одна команда, ваша мысль, готово.