CLI

nrz — официальный CLI для разработки и деплоя на платформе ONREZA. Написан на Rust, включает локальный эмулятор платформенных API (KV, D1, Context).

LLM-First Design

CLI спроектирован для автономного использования LLM-агентами:

--json глобальный флаг (NRZ_JSON=1) — машинный вывод в stdout
--token глобальный флаг (NRZ_TOKEN) — аутентификация без device flow
--workspace глобальный флаг (NRZ_WORKSPACE) — выбор workspace
--env глобальный флаг (NRZ_ENV) — выбор окружения
JSON output: один объект в stdout, ошибки {"error": "..."}, exit code 1
Human output: цветной текст в stderr (по умолчанию)

Установка

Quick Install

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/ONREZA/nrz-cli/main/install.sh | bash

Windows (PowerShell):

iwr -useb https://raw.githubusercontent.com/ONREZA/nrz-cli/main/install.ps1 | iex

Через пакетный менеджер

npm i -g @onreza/nrz
# или
pnpm i -g @onreza/nrz
# или
bun i -g @onreza/nrz

Скачать вручную

Скачайте бинарник для вашей платформы из GitHub Releases:

nrz-linux-x64 — Linux x86_64
nrz-macos-x64 — macOS Intel
nrz-macos-arm64 — macOS Apple Silicon
nrz-windows-x64.exe — Windows x86_64

Глобальные флаги

Все команды поддерживают следующие глобальные флаги:

Флаг	Переменная окружения	Описание
`--json`	`NRZ_JSON=1`	Машиночитаемый JSON вывод
`--token <token>`	`NRZ_TOKEN`	API токен для аутентификации
`--workspace <slug>`	`NRZ_WORKSPACE`	Workspace slug
`--env <env>`	`NRZ_ENV`	Окружение (production/preview/development или ID)

Команды

nrz init

Инициализирует проект: создаёт onreza.toml, определяет фреймворк, опционально создаёт проект на платформе.

nrz init [OPTIONS]

Флаг	Описание
`--name <name>`	Имя проекта (по умолчанию: имя директории)
`--skip-detection`	Пропустить автоопределение фреймворка
`--create`	Создать проект на платформе
`--project-id <id>`	Привязать существующий проект по ID

# Интерактивная инициализация
nrz init

# Создать проект на платформе
nrz init --create --name my-project

# Привязать существующий проект
nrz init --project-id proj_abc123

nrz link

Привязывает текущую директорию к проекту на платформе.

nrz link [dir] [OPTIONS]

Флаг	Описание
`dir`	Путь к директории проекта (по умолчанию: `.`)
`--project-id <id>`	ID проекта (пропустить интерактивный выбор)

# Интерактивный выбор проекта
nrz link

# Привязка по ID
nrz link --project-id proj_abc123

nrz dev

Запускает локальный dev-сервер с эмуляцией платформенных API.

nrz dev [dir] [OPTIONS]

Флаг	Описание
`dir`	Путь к директории проекта (по умолчанию: `.`)
`--alias <name>`	Запустить алиас из `[dev.aliases]` в onreza.toml
`--command <cmd>`	Команда запуска (переопределяет конфиг)
`--port`, `-p <port>`	Порт dev-сервера (по умолчанию: 4321)
`--inspect`	Включить Node.js inspector (порт 9229)
`--inspect-brk`	Включить inspector с остановкой на старте

# Автодетект фреймворка
nrz dev

# Использовать алиас
nrz dev --alias staging

# Другой порт + inspector
nrz dev --port 3000 --inspect

nrz build

Валидирует build output и манифест проекта.

nrz build [dir] [OPTIONS]

Флаг	Описание
`dir`	Путь к директории проекта (по умолчанию: `.`)
`--skip-validation`	Пропустить валидацию манифеста

nrz build
nrz build ./my-app --skip-validation

nrz deploy

Деплоит проект на платформу ONREZA.

nrz deploy [dir] [OPTIONS]

Флаг	Описание
`dir`	Путь к директории проекта (по умолчанию: `.`)
`--prod`	Production деплой
`--project-id <id>`	ID проекта (пропустить автоопределение)
`--skip-migrations`	Пропустить миграции БД
`--skip-build`	Пропустить шаг сборки
`--build-command <cmd>`	Кастомная команда сборки
`--skip-env-check`	Пропустить проверку env переменных

# Деплой preview
nrz deploy

# Production деплой
nrz deploy --prod

# С кастомной сборкой
nrz deploy --build-command "npm run build:staging"

nrz projects

Управление проектами.

nrz projects <subcommand>

Субкоманда	Описание
`list [--limit <n>]`	Список проектов
`create --name <name>`	Создать проект
`info <id>`	Информация о проекте
`update <id>`	Обновить настройки проекта
`delete <id>`	Удалить проект

Create флаги:

Флаг	Описание
`--name <name>`	Обязательно — имя проекта
`--display-name <name>`	Отображаемое имя
`--git-url <url>`	URL Git репозитория
`--branch <branch>`	Git ветка (по умолчанию: main)
`--framework <fw>`	Фреймворк (astro, nuxt, sveltekit, nitro)
`--install-command <cmd>`	Команда установки зависимостей
`--build-command <cmd>`	Команда сборки
`--output-directory <dir>`	Директория сборки
`--link`	Привязать к текущей директории

Delete флаги:

Флаг	Описание
`id`	Обязательно — ID проекта
`--force`	Пропустить подтверждение

Update флаги:

Флаг	Описание
`--display-name <name>`	Отображаемое имя
`--git-url <url>`	URL Git репозитория
`--branch <branch>`	Git ветка
`--framework <fw>`	Фреймворк
`--install-command <cmd>`	Команда установки
`--build-command <cmd>`	Команда сборки
`--output-directory <dir>`	Директория сборки
`--root-directory <dir>`	Корневая директория
`--node-version <ver>`	Версия Node.js

# Список проектов
nrz projects list

# Создать и привязать
nrz projects create --name my-app --framework astro --link

# Информация
nrz projects info proj_abc123

# Обновить
nrz projects update proj_abc123 --build-command "npm run build"

# Удалить
nrz projects delete proj_abc123 --force

nrz deployments

Список деплоев проекта.

nrz deployments [OPTIONS]

Флаг	Описание
`--limit <n>`	Максимальное количество (по умолчанию: 10)
`--project-id <id>`	ID проекта

nrz deployments
nrz deployments --limit 20

nrz logs

Просмотр runtime логов проекта.

nrz logs [OPTIONS]

Флаг	Описание
`--deployment-id <id>`	Фильтр по ID деплоя
`--project-id <id>`	ID проекта
`--limit <n>`	Количество записей (по умолчанию: 50)
`--search <query>`	Поисковый запрос

nrz logs
nrz logs --search "error" --limit 100

nrz rollback

Откат к предыдущему деплою.

nrz rollback [OPTIONS]

Флаг	Описание
`--deployment-id <id>`	ID деплоя для отката (по умолчанию: текущий live)
`--project-id <id>`	ID проекта

nrz rollback
nrz rollback --deployment-id dep_xyz789

nrz db

Управление локальной D1-совместимой SQLite базой данных.

nrz db <subcommand>

Субкоманда	Описание
`shell`	Интерактивная SQLite консоль
`execute <sql>`	Выполнить SQL запрос
`info`	Информация о БД (таблицы, размер)
`reset`	Сброс БД
`push`	Выполнить SQL на удалённой D1
`migrate`	Управление миграциями

Execute флаги:

Флаг	Описание
`sql`	SQL запрос (используйте `-` для чтения из stdin)
`--file <path>`	Прочитать SQL из файла

Reset флаги:

Флаг	Описание
`--force`	Пропустить подтверждение
`--remote`	Сбросить удалённую D1 БД
`--project-id <id>`	ID проекта

Push флаги:

Флаг	Описание
`sql`	SQL запрос (используйте `-` для чтения из stdin)
`--file <path>`	Прочитать SQL из файла
`--project-id <id>`	ID проекта

Migrate субкоманды:

Субкоманда	Описание
`create <name>`	Создать новый файл миграции
`apply`	Применить pending миграции
`status`	Статус миграций

Migrate apply флаги:

Флаг	Описание
`--remote`	Применить на удалённой D1
`--dry-run`	Показать SQL без выполнения
`--project-id <id>`	ID проекта

Migrate status флаги:

Флаг	Описание
`--remote`	Проверить удалённую D1
`--project-id <id>`	ID проекта

# Интерактивная консоль
nrz db shell

# Выполнить запрос
nrz db execute "SELECT * FROM users"
nrz db execute --file ./query.sql

# Информация о БД
nrz db info

# Сброс локальной БД
nrz db reset --force

# Сброс удалённой БД
nrz db reset --remote --force --project-id proj_abc123

# Миграции
nrz db migrate create add_users_table
nrz db migrate apply
nrz db migrate apply --remote
nrz db migrate status

# Push на удалённую БД
nrz db push "ALTER TABLE users ADD COLUMN email TEXT"

nrz kv

Управление локальным KV Store.

nrz kv <subcommand>

Субкоманда	Описание
`get <key>`	Получить значение
`set <key> <value>`	Установить значение
`remove <key>`	Удалить ключ
`list [--prefix <p>] [--limit <n>]`	Список ключей
`clear [--force]`	Очистить все данные

# Установить значение
nrz kv set user:123 '{"name": "John"}'

# С TTL (1 час)
nrz kv set session:abc token123 --ttl 3600

# Получить
nrz kv get user:123

# Список с префиксом
nrz kv list --prefix user: --limit 50

# Удалить
nrz kv remove user:123

# Очистить
nrz kv clear --force

nrz env

Управление переменными окружения проекта.

nrz env <subcommand>

Субкоманда	Описание
`list`	Список переменных
`set <key> <value>`	Установить переменную
`remove <key>`	Удалить переменную
`pull [file]`	Скачать в файл (по умолчанию: .env.local)
`push [file]`	Загрузить из файла (по умолчанию: .env.local)
`validate`	Проверить по декларациям в onreza.toml

Set флаги:

Флаг	Описание
`--secret`	Пометить как секретную

Push флаги:

Флаг	Описание
`--overwrite`	Перезаписать существующие
`--dry-run`	Показать что будет загружено
`--secret`	Пометить все как секретные
`--declared-only`	Только объявленные в onreza.toml

# Список
nrz env list

# Установить
nrz env set API_URL https://api.example.com
nrz env set API_KEY secret123 --secret

# Удалить
nrz env remove API_URL

# Pull/Push
nrz env pull
nrz env pull .env.staging
nrz env push
nrz env push --overwrite --dry-run

# Валидация
nrz env validate

nrz domains

Управление кастомными доменами.

nrz domains <subcommand>

Флаг	Описание
`--project-id <id>`	ID проекта (пропустить автоопределение)

Субкоманда	Описание
`list`	Список доменов
`add <domain>`	Добавить домен
`remove <domain_id>`	Удалить домен
`verify <domain_id>`	Проверить DNS

Add флаги:

Флаг	Описание
`--environment-id <id>`	ID окружения (по умолчанию: production)

nrz domains list
nrz domains add example.com
nrz domains verify dom_abc123
nrz domains remove dom_abc123

nrz workspace

Управление workspaces.

nrz workspace <subcommand>

Субкоманда	Описание
`list`	Список workspaces
`switch <slug>`	Переключить default workspace

nrz workspace list
nrz workspace switch my-team

Аутентификация через OAuth 2.0 Device Flow.

nrz login

Команда автоматически:

Создаёт device flow запрос
Открывает браузер с URL для подтверждения
Ожидает подтверждения пользователя
Сохраняет токен в ~/.config/nrz/credentials.json

nrz logout

Выход из платформы.

nrz logout [OPTIONS]

Флаг	Описание
`--all`	Выйти из всех workspaces

nrz logout
nrz logout --all

nrz whoami

Информация о текущем пользователе.

nrz whoami

nrz upgrade

Обновление CLI до последней версии.

nrz upgrade [OPTIONS]

Флаг	Описание
`--force`	Обновить даже если уже последняя версия
`--version <tag>`	Конкретная версия (например, `v0.1.5`)

nrz upgrade
nrz upgrade --version v0.1.5

Конфигурация onreza.toml

onreza.toml — единый конфиг проекта, коммитится в git.

#:schema https://raw.githubusercontent.com/onreza/nrz-cli/main/onreza.schema.json

[project]
id = "proj_abc123"
name = "my-project"
workspace = "my-team"

[dev]
command = "npm run dev"
port = 4321
host = "127.0.0.1"
data_dir = ".onreza/data"
db_name = "dev.db"

[dev.aliases]
network = "npm run dev -- --host 0.0.0.0"
staging = "npm run dev -- --host 0.0.0.0 --port 3001"

[build]
command = "npm run build"
output_dirs = ["dist", ".output", "build"]

[deploy]
skip_migrations = false

[migrations]
dir = "migrations"

[db]
default_env = "development"

[env]
strict = false

[env.declarations]
DATABASE_URL = "sensitive"
PUBLIC_API_URL = "plain"
OPTIONAL_VAR = { visibility = "plain", required = false }

Секция `[env]`

Декларирует переменные окружения проекта:

strict = true — nrz env push загружает только переменные из [env.declarations]
Строка "sensitive" / "plain" — shorthand, переменная обязательна
Table { visibility = "...", required = false } — для необязательных переменных

Используется в:

nrz env push — определяет is_secret для каждой переменной
nrz env validate — проверяет required переменные
nrz deploy — pre-flight проверка перед деплоем

CI/CD

Для использования в CI/CD передайте токен через переменную окружения:

export NRZ_TOKEN="nrz_xxx"
nrz deploy --prod

Пример для GitHub Actions:

- name: Deploy to ONREZA
  env:
    NRZ_TOKEN: ${{ secrets.ONREZA_TOKEN }}
  run: |
    nrz deploy --prod

Device Flow API

OAuth 2.0 Device Authorization Grant (RFC 8628) — механизм аутентификации CLI.

Инициация

POST /v1/device

Ответ:

{
  "device_code": "abc123def456...",
  "user_code": "ABCD-1234",
  "verification_uri": "https://app.onreza.app/device",
  "verification_uri_complete": "https://app.onreza.app/device?code=ABCD-1234",
  "expires_in": 300,
  "interval": 5
}

Получение токена

POST /v1/device/token

Успешный ответ (200):

{
  "access_token": "nrz_xxxxxxxxxxxxxxxx",
  "token_type": "Bearer",
  "workspace_slug": "my-workspace",
  "workspace_name": "My Workspace"
}

Ошибки:

Статус	Ошибка	Описание
400	`authorization_pending`	Пользователь ещё не подтвердил
400	`slow_down`	Слишком частый polling
400	`expired_token`	Device code истёк
400	`invalid_grant`	Device code не найден

Коды ошибок API

Код	Описание
200	Успешный запрос
400	Некорректный запрос
401	Не авторизован
403	Доступ запрещён
404	Ресурс не найден
409	Конфликт (например, параллельный деплой)
429	Rate limit

Rate Limits

Endpoint	Limit
`/v1/device`	10 запросов/минуту с IP
`/v1/device/token`	60 запросов/минуту
Остальные API	1000 запросов/минуту

При превышении лимита возвращается статус 429 с заголовком Retry-After.