CLI — команды zubrcode

Команды zubrcode без интерфейса: одна команда — один результат. У каждой команды есть --help с полным списком флагов.

Команда	Что делает
run	отправить запрос и получить ответ, не открывая интерфейс
mini	минимальный интерактивный интерфейс
session	управление сессиями
models	список доступных моделей
stats	статистика использования
service	фоновая служба
reload	перечитать конфигурацию
serve	сервер API и веб-интерфейса
pair	одноразовые ссылки для подключения браузера или приложения
acp	ACP-сервер для редакторов (В редакторах)
mcp	MCP-серверы (MCP)
plugin	плагины
auth	интеграции и учётные данные (Вход)
api	запрос к работающему серверу
debug	отладка и диагностика (Если что-то не так)
upgrade, update	обновление ZubrCode (Обновление)
remote	свой раннер (Свой раннер)
skills	навыки ZuBrIQ (Навыки)
memory	память между сессиями (Память)
uninstall	удалить ZubrCode

Флаги zubrcode (корневая команда)

Флаг	Что делает
каталог (аргумент)	каталог, с которого начать
--standalone	приватный сервер вместо фоновой службы
--server <url>	подключиться к указанному серверу
--auto	автоматически разрешать всё, что не запрещено явно
--continue, -c	продолжить последнюю сессию
--session, -s	продолжить сессию с этим id (или создать её)
--prompt	запрос для запуска

--standalone и --server есть и у команд, работающих с сервером: run, models, reload, stats и других.

Глобальные флаги (у всех команд)

Флаг	Что делает
--help, -h	справка
--version, -v	версия
--wizard	режим мастера для команды
--completions <bash|zsh|fish|sh>	печатает скрипт автодополнения оболочки
--log-level <уровень>	минимальный уровень логов
--print-logs	печатать логи в stderr

run

Отправляет запрос и печатает ответ, не открывая интерактивный интерфейс — удобно в скриптах и CI.

zubrcode run "Объясни этот репозиторий"
zubrcode run --model zubriq/zubr-coder "Рефакторни parseToken"
zubrcode run --continue "Теперь обработай случай с истёкшим ключом"
zubrcode run --agent build "Почини падающий тест"

Флаг	Что делает
--model, -m	модель в формате провайдер/модель#вариант
--agent	агент для запуска
--format	default или json (NDJSON для скриптов)
--file, -f	приложить файл к запросу (можно несколько раз)
--title	заголовок сессии
--thinking	показывать блоки размышлений
--fork	ответвить сессию перед продолжением
--auto	разрешать всё, что не запрещено явно

В CI передайте ключ ZuBrIQ секретом, например ZUBRIQ_API_KEY, и используйте --standalone, чтобы приватный сервер его получил. Правила разрешений в таком режиме действуют без вопросов: пропишите нужные заранее в opencode.json или запускайте с --auto (Разрешения).

mini

Минимальный интерактивный интерфейс вместо полноэкранного TUI.

zubrcode mini
zubrcode mini --continue
zubrcode mini --model zubriq/zubr-coder --prompt "Сделай резюме репозитория"

Дополнительные флаги: --fork, --replay (--no-replay) и --replay-limit <n> — восстановление истории сессии при подключении (по умолчанию последние 200 сообщений), --session, --agent, --prompt.

session

Управляет сессиями текущего проекта.

zubrcode session list
zubrcode session list --max-count 20 --format json
zubrcode session delete ses_9c1b08
zubrcode session export ses_4f2a1c
zubrcode session export ses_4f2a1c --sanitize   # без чувствительных данных
zubrcode session import session.json
zubrcode session import session.json --directory ~/code/project

list показывает верхнеуровневые сессии проекта, новые первыми. delete удаляет сессию вместе с дочерними. export выгружает данные сессии в JSON (--sanitize очищает переписку и файлы от чувствительного), import загружает их из файла или по URL.

models

Печатает все доступные модели — те, что пришли с платформы и настроены в конфигурации. Выбрать модель для сессии — /models в TUI (Модели).

zubrcode models

stats

Статистика использования.

zubrcode stats                 # сводка
zubrcode stats --days 7        # последние 7 дней
zubrcode stats --models        # использование по моделям
zubrcode stats --cost          # расход и токены
zubrcode stats --json          # JSON вместо отчёта

Остальные флаги: --year, --all (за всё время), --project (. — текущий проект), --tools (надёжность инструментов), --full, --limit <n>.

service

Фоновая служба: одна на пользователя, ей принадлежат сессии, конфигурация и инструменты.

zubrcode service start
zubrcode service restart
zubrcode service status
zubrcode service stop
zubrcode service get hostname
zubrcode service set hostname 0.0.0.0
zubrcode service set port 4182
zubrcode service set cors https://app.example.com
zubrcode service set env OPENCODE_LOG_LEVEL DEBUG
zubrcode service unset hostname

set/unset останавливают службу — следующий запуск подхватит новое значение. Порт службы у каждого пользователя свой; если он занят, задайте свой — zubrcode service set port <port>.

reload

Перечитывает конфигурацию без перезапуска сервера. Работающие сессии подхватят её на следующем шаге.

zubrcode reload

serve

Запускает сервер API и веб-интерфейс.

zubrcode serve
zubrcode serve --hostname 0.0.0.0 --port 4096
zubrcode serve --cors https://app.example.com

Флаги: --hostname, --port, --cors (дополнительный разрешённый origin, повторяется), --service, --stdio. Работающему серверу можно отправлять запросы командой zubrcode api:

zubrcode api GET /api/session
zubrcode api session.list --param limit=10
zubrcode api session.create --data '{"title": "New session"}'

pair

Печатает одноразовые ссылки (и QR-код первой), которые подписывают браузер или приложение на сервер. Ссылки живут 5 минут и работают один раз.

zubrcode pair
zubrcode pair --url https://dev.example.com
zubrcode pair --remote          # подключение извне через адрес туннеля
zubrcode pair --remote --yes    # принять без вопроса (для скриптов)

--remote включает удалённый доступ и делает сервер видимым из интернета — при первом включении команда просит подтверждение. В TUI то же делает /pair. Сопряжение работает только с общей фоновой службой.

acp

Запускает ACP-сервер (Agent Client Protocol) на stdin/stdout для интеграций с редакторами — JetBrains и Zed. Работает, пока клиент не закроет соединение.

zubrcode acp
zubrcode acp --login    # вместо запуска — вход в ZuBrIQ

mcp

Управляет MCP-серверами: list — список и состояние, add — добавить, auth — OAuth-вход на удалённом сервере, logout — забыть OAuth-учётку.

zubrcode mcp list
zubrcode mcp add context7 --url https://mcp.context7.com/mcp
zubrcode mcp add everything --global -- npx -y @modelcontextprotocol/server-everything
zubrcode mcp auth sentry

Подробнее — MCP-серверы.

plugin

Управляет плагинами: list (список; --builtin — вместе со встроенными), add (установить и записать в глобальную конфигурацию), check и update (проверить и обновить пакетные плагины), remove (убрать из конфигурации).

zubrcode plugin list
zubrcode plugin add @example/opencode-tui
zubrcode plugin update

auth

Интеграции и сохранённые учётные данные. Вход в ZuBrIQ — zubrcode auth login zubriq (Вход).

zubrcode auth list
zubrcode auth login zubriq
zubrcode auth logout zubriq
zubrcode auth switch zubriq work

export печатает сохранённые учётные данные, включая секреты, в JSON, import загружает выгруженное. Осторожнее с выводом export — в нём есть ключи.

debug

Диагностика: zubrcode debug agents — список агентов, zubrcode debug config — источники конфигурации, zubrcode debug paths — глобальные пути.

zubrcode debug paths
zubrcode debug paths db    # один путь: db, home, data, config, cache, state, tmp, bin, log, repos

uninstall

Останавливает фоновые службы, удаляет глобальный кеш и сам ZubrCode. Данные сессий, конфигурация и состояние не удаляются.

zubrcode uninstall --dry-run   # показать, что будет удалено
zubrcode uninstall
zubrcode uninstall --force     # без вопросов

Фоновая служба и приватный сервер

По умолчанию ZubrCode находит или поднимает одну общую фоновую службу вашего пользователя: все локальные клиенты (TUI, Desktop, run, ACP) подключаются к ней. --standalone запускает приватный сервер, --server <url> подключается к конкретному.

Чтобы команды CLI всегда пользовались приватным сервером, отключите службу:

zubrcode service set disabled true

Чтобы вернуть автоматическое использование службы — zubrcode service unset disabled. Сопряжение (pair) требует общей службы и пока она отключена, недоступно.