Справочник команд CLI

Эта страница описывает терминальные команды, которые вы запускаете из оболочки.

Информацию о слеш-командах внутри чата см. в Справочнике слеш-команд.

Глобальная точка входа

vibeos [global-options] <command> [subcommand/options]

Глобальные опции

Опция	Описание
--version, -V	Показать версию и выйти.
--profile <name>, -p <name>	Выбрать профиль VibeOS для этого вызова. Переопределяет закреплённый профиль по умолчанию, заданный командой vibeos profile use.
--resume <session>, -r <session>	Возобновить предыдущую сессию по ID или названию.
--continue [name], -c [name]	Возобновить самую последнюю сессию или самую последнюю сессию, соответствующую названию.
--worktree, -w	Запустить в изолированном git worktree для параллельных рабочих процессов агента.
--yolo	Пропустить запросы подтверждения опасных команд.
--pass-session-id	Включить ID сессии в системный промпт агента.
--ignore-user-config	Игнорировать ~/.vibeos/config.yaml и вернуться к встроенным настройкам по умолчанию. Учётные данные из .env всё равно загружаются.
--ignore-rules	Пропустить авто-внедрение AGENTS.md, SOUL.md, .cursorrules, памяти и предзагруженных навыков.
--tui	Запустить TUI вместо классического CLI. Эквивалентно VIBEOS_TUI=1. Всегда имеет приоритет над display.interface.
--cli	Принудительно использовать классический REPL от prompt_toolkit. Используйте это, чтобы переопределить display.interface: tui для одного вызова.
--dev	С --tui: запускать исходники TypeScript напрямую через tsx вместо предварительно собранного бандла (для контрибьюторов TUI).

Команды верхнего уровня

Команда	Назначение
vibeos chat	Интерактивный или одноразовый чат с агентом.
vibeos model	Интерактивный выбор провайдера и модели по умолчанию.
vibeos moa	Настройка именованных пресетов Mixture of Agents, выбираемых из палитры моделей.
vibeos fallback	Управление резервными провайдерами, которые используются при ошибке основной модели.
vibeos gateway	Запуск или управление сервисом шлюза обмена сообщениями.
vibeos proxy	Локальный прокси-сервер, совместимый с OpenAI, который присоединяет учётные данные OAuth-провайдера. См. Прокси подписки.
vibeos lsp	Управление интеграцией Language Server Protocol (семантическая диагностика для write_file/patch).
vibeos setup	Интерактивный мастер настройки всей конфигурации или её части.
vibeos whatsapp	Настройка и сопряжение моста WhatsApp.
vibeos slack	Вспомогательные утилиты Slack (в настоящее время: генерация манифеста приложения с каждой командой в виде нативного слеша).
vibeos auth	Управление учётными данными — добавление, список, удаление, сброс, статус, выход. Обрабатывает OAuth-потоки для Codex/Nous/Anthropic.
vibeos login / logout	Устарело — используйте vibeos auth.
vibeos send	Отправка одноразового сообщения на настроенную платформу обмена сообщениями (Telegram, Discord, Slack, Signal, SMS, …). Полезно из скриптов оболочки, заданий cron, хуков CI и демонов мониторинга — без цикла агента, без LLM.
vibeos secrets	Управление внешними источниками секретов (в настоящее время Bitwarden Secrets Manager) для получения API-ключей при запуске процесса вместо ~/.vibeos/.env.
vibeos migrate	Диагностика и (опционально) перезапись config.yaml для замены ссылок на устаревшие модели или устаревшие настройки (например, migrate xai).
vibeos status	Показать статус агента, аутентификации и платформы.
vibeos cron	Просмотр и запуск планировщика cron.
vibeos research	Создание рабочих пространств для исследований и применение пресета Research Pro (без вызова LLM).
vibeos kanban	Многопрофильная доска совместной работы (задачи, ссылки, диспетчер).
vibeos webhook	Управление динамическими подписками вебхуков для событийно-ориентированной активации.
vibeos hooks	Просмотр, одобрение или удаление хуков shell-скриптов, объявленных в config.yaml.
vibeos doctor	Диагностика проблем конфигурации и зависимостей.
vibeos security audit	Аудит цепочки поставок по требованию (OSV.dev) для venv, зависимостей плагинов и закреплённых MCP-серверов.
vibeos dump	Сводка настройки для копирования и вставки при поддержке/отладке.
vibeos prompt-size	Показать побайтовую разбивку системного промпта + схем инструментов (индекс навыков, память, профиль). Работает офлайн.
vibeos debug	Инструменты отладки — загрузка логов и информации о системе для поддержки.
vibeos backup	Резервное копирование домашнего каталога VibeOS в zip-файл.
vibeos checkpoints	Просмотр / очистка ~/.vibeos/checkpoints/ (теневое хранилище, используемое /rollback). Запуск без аргументов для общего обзора статуса.
vibeos import	Восстановление резервной копии VibeOS из zip-файла.
vibeos logs	Просмотр, отслеживание и фильтрация файлов логов агента/шлюза/ошибок.
vibeos config	Просмотр, редактирование, миграция и запрос файлов конфигурации.
vibeos pairing	Одобрение или отзыв кодов сопряжения для обмена сообщениями.
vibeos skills	Просмотр, установка, публикация, аудит и настройка навыков.
vibeos bundles	Группировка нескольких навыков под одной слеш-командой /<name>. См. Пакеты навыков.
vibeos curator	Фоновое обслуживание навыков — статус, запуск, пауза, закрепление. См. Куратор.
vibeos memory	Настройка внешнего провайдера памяти. Подкоманды для конкретных плагинов (например, vibeos honcho) регистрируются автоматически, когда их провайдер активен.
vibeos acp	Запуск VibeOS в качестве ACP-сервера для интеграции с редактором.
vibeos mcp	Управление конфигурациями MCP-серверов и запуск VibeOS в качестве MCP-сервера.
vibeos plugins	Управление плагинами VibeOS (установка, включение, отключение, удаление).
vibeos portal	Статус Nous Portal, ссылка на подписку и маршрутизация Tool Gateway. См. Tool Gateway.
vibeos tools	Настройка включённых инструментов для каждой платформы.
vibeos computer-use	Установка или проверка бэкенда cua-driver (Computer Use для macOS).
vibeos sessions	Просмотр, экспорт, очистка, переименование и удаление сессий.
vibeos insights	Показать аналитику токенов/стоимости/активности.
vibeos claw	Вспомогательные утилиты миграции из OpenClaw.
vibeos dashboard	Запуск веб-панели управления для настройки конфигурации, API-ключей и сессий.
vibeos profile	Управление профилями — несколькими изолированными экземплярами VibeOS.
vibeos completion	Вывод скриптов автодополнения для оболочки (bash/zsh/fish).
vibeos version	Показать информацию о версии.
vibeos update	Загрузка последнего кода и переустановка зависимостей. --check показывает предварительный просмотр без установки; --backup делает снимок VIBEOS_HOME до загрузки.
vibeos uninstall	Удаление VibeOS из системы.

vibeos chat

vibeos chat [options]

Общие опции:

Опция	Описание
-q, --query "..."	Одноразовый, неинтерактивный промпт.
-m, --model <model>	Переопределить модель для этого запуска.
-t, --toolsets <csv>	Включить набор инструментов, разделённый запятыми.
--provider <provider>	Принудительно указать провайдера: auto, openrouter, nous, chatgpt-oauth, copilot-acp, copilot, anthropic, gemini, huggingface, novita (алиасы novita-ai, novitaai), openai-api, zai, kimi-coding, kimi-coding-cn, minimax, minimax-cn, minimax-oauth, kilocode, xiaomi, arcee, gmi, alibaba, alibaba-coding-plan (алиас alibaba_coding), deepseek, nvidia, ollama-cloud, xai (алиас grok), xai-oauth (алиас grok-oauth), qwen-oauth, bedrock, opencode-zen, opencode-go, azure-foundry, lmstudio, stepfun, tencent-tokenhub (алиас tencent, tokenhub).
-s, --skills <name>	Предзагрузить один или несколько навыков для сессии (можно повторять или разделять запятыми).
-v, --verbose	Подробный вывод.
-Q, --quiet	Программный режим: подавить баннер/спиннер/предпросмотр инструментов.
--image <path>	Прикрепить локальное изображение к одному запросу.
--resume <session> / --continue [name]	Возобновить сессию напрямую из chat.
--worktree	Создать изолированный git worktree для этого запуска.
--checkpoints	Включить контрольные точки файловой системы перед деструктивными изменениями файлов.
--yolo	Пропустить запросы подтверждения.
--pass-session-id	Передать ID сессии в системный промпт.
--ignore-user-config	Игнорировать ~/.vibeos/config.yaml и использовать встроенные настройки по умолчанию. Учётные данные из .env всё равно загружаются. Полезно для изолированных запусков CI, воспроизводимых отчётов об ошибках и сторонних интеграций.
--ignore-rules	Пропустить авто-внедрение AGENTS.md, SOUL.md, .cursorrules, постоянной памяти и предзагруженных навыков. Комбинируйте с --ignore-user-config для полностью изолированного запуска.
--safe-mode	Режим устранения неполадок: отключить ВСЕ настройки — пользовательскую конфигурацию, внедрение правил/памяти, плагины и MCP-серверы (подразумевает --ignore-user-config и --ignore-rules). Используйте, чтобы изолировать, исходит ли проблема от вашей настройки или от самого VibeOS.
--source <tag>	Тег источника сессии для фильтрации (по умолчанию: cli). Используйте tool для сторонних интеграций, которые не должны появляться в списках сессий пользователя.
--max-turns <N>	Максимальное количество итераций вызова инструментов за один оборот разговора (по умолчанию: 90 или agent.max_turns в конфиге).

Примеры:

vibeos
vibeos chat -q "Обобщи последние PR"
vibeos chat --provider openrouter --model anthropic/claude-sonnet-4.6
vibeos chat --toolsets web,terminal,skills
vibeos chat --quiet -q "Верни только JSON"
vibeos chat --worktree -q "Проверь этот репозиторий и открой PR"
vibeos chat --ignore-user-config --ignore-rules -q "Воспроизведи без моей личной настройки"
vibeos chat --safe-mode -q "Это моя ошибка или VibeOS?"

vibeos -z <prompt> — скриптовый одноразовый вызов

Для программных вызывающих сторон (скрипты оболочки, CI, cron, родительские процессы, передающие промпт через stdin), vibeos -z — это самая чистая точка входа для одноразового вызова: один промпт на входе, текст окончательного ответа на выходе, ничего лишнего в stdout или stderr. Ни баннера, ни спиннера, ни предпросмотра инструментов, ни строки Session: — только окончательный ответ агента в виде обычного текста.

vibeos -z "Какая столица Франции?"
# → Париж.

# Родительские скрипты могут чисто захватить ответ:
answer=$(vibeos -z "обобщи это" < /path/to/file.txt)

Переопределения для одного запуска (без изменения ~/.vibeos/config.yaml):

Флаг	Эквивалентная переменная окружения	Назначение
-m / --model <model>	VIBEOS_INFERENCE_MODEL	Переопределить модель для этого запуска
--provider <provider>	(нет)	Переопределить провайдера для этого запуска

vibeos -z "…" --provider openrouter --model openai/gpt-5.5
# или:
VIBEOS_INFERENCE_MODEL=anthropic/claude-sonnet-4.6 vibeos -z "…"

Тот же агент, те же инструменты, те же навыки — только убирает каждый интерактивный/косметический слой. Если вам нужен вывод инструментов в транскрипте, используйте vibeos chat -q; -z предназначен исключительно для «мне нужен только окончательный ответ».

vibeos model

Интерактивный выбор провайдера + модели. Это команда для добавления новых провайдеров, настройки API-ключей и запуска OAuth-потоков. Запускайте её из терминала — не из активной сессии чата VibeOS.

vibeos model

Используйте это, когда хотите:

• добавить нового провайдера (OpenRouter, Anthropic, Copilot, DeepSeek, кастомный и т.д.)
• войти в провайдеров, поддерживающих OAuth (Anthropic, Copilot, Codex, Nous Portal)
• ввести или обновить API-ключи
• выбрать из списка моделей конкретного провайдера
• настроить кастомную/самостоятельно размещённую конечную точку
• сохранить новую настройку по умолчанию в конфиг

vibeos model vs /model — знайте разницу

vibeos model (запускается из терминала, вне сессии VibeOS) — это полный мастер настройки провайдера. Он может добавлять новых провайдеров, запускать OAuth-потоки, запрашивать API-ключи и настраивать конечные точки.

/model (вводится внутри активной сессии чата VibeOS) может только переключаться между провайдерами и моделями, которые вы уже настроили. Он не может добавлять новых провайдеров, запускать OAuth или запрашивать API-ключи.

Если вам нужно добавить нового провайдера: Сначала выйдите из сессии VibeOS (Ctrl+C или /quit), затем запустите vibeos model из терминала.

Слеш-команда /model (внутри сессии)

Переключение между уже настроенными моделями без выхода из сессии:

/model                              # Показать текущую модель и доступные опции
/model claude-sonnet-4              # Переключить модель (авто-определение провайдера)
/model zai:glm-5                    # Переключить провайдера и модель
/model custom:qwen-2.5              # Использовать модель на вашей кастомной конечной точке
/model custom                       # Авто-определение модели из кастомной конечной точки
/model custom:local:qwen-2.5        # Использовать именованного кастомного провайдера
/model openrouter:anthropic/claude-sonnet-4  # Переключиться обратно на облако

По умолчанию изменения /model применяются только к текущей сессии. Добавьте --global, чтобы сохранить изменение в config.yaml:

/model claude-sonnet-4 --global     # Переключить и сохранить как новое значение по умолчанию

Что, если я вижу только модели OpenRouter?

Если вы настроили только OpenRouter, /model покажет только модели OpenRouter. Чтобы добавить другого провайдера (Anthropic, DeepSeek, Copilot и т.д.), выйдите из сессии и запустите vibeos model из терминала.

Изменения провайдера и базового URL автоматически сохраняются в config.yaml. При переключении с кастомной конечной точки устаревший базовый URL очищается, чтобы предотвратить его утечку в других провайдеров.

vibeos gateway

vibeos gateway <subcommand>

Подкоманды:

Подкоманда	Описание
run	Запустить шлюз на переднем плане. Рекомендуется для WSL, Docker и Termux.
start	Запустить установленный фоновый сервис systemd/launchd.
stop	Остановить сервис (или процесс на переднем плане).
restart	Перезапустить сервис.
status	Показать статус сервиса.
list	Список всех профилей и статус шлюза каждого профиля (с PID, где доступно). Удобно, когда вы запускаете несколько профилей одновременно и хотите получить единый обзор.
install	Установить как фоновый сервис systemd (Linux) или launchd (macOS).
uninstall	Удалить установленный сервис.
setup	Интерактивная настройка платформ обмена сообщениями.
enroll	Экспериментально: зарегистрировать этот шлюз в релейном коннекторе и сохранить учётные данные реле для платформ, поддерживаемых коннектором.

Опции:

Опция	Описание
--all	Для start / restart / stop: воздействовать на шлюз каждого профиля, а не только активного VIBEOS_HOME. Полезно, если вы запускаете несколько профилей одновременно и хотите перезапустить их все после vibeos update.
--no-supervise	Для run: внутри Docker-образа s6-overlay отказаться от авто-супервизии и использовать семантику переднего плана до s6 — шлюз работает как основной процесс контейнера без авто-перезапуска. Не работает вне образа s6. Эквивалентно установке VIBEOS_GATEWAY_NO_SUPERVISE=1.

vibeos gateway enroll принимает --token, --connector-url и --gateway-id. Он обменивает токен регистрации с коннектором и записывает результирующие значения GATEWAY_RELAY_ID, GATEWAY_RELAY_SECRET, GATEWAY_RELAY_DELIVERY_KEY и опциональный GATEWAY_RELAY_URL в .env активного профиля.

Пользователи WSL

Используйте vibeos gateway run вместо vibeos gateway start — поддержка systemd в WSL ненадёжна. Оберните его в tmux для сохранения: tmux new -s vibeos 'vibeos gateway run'. См. WSL FAQ для подробностей.

vibeos lsp

vibeos lsp <subcommand>

Управление интеграцией Language Server Protocol. LSP запускает реальные языковые серверы (pyright, gopls, rust-analyzer, …) в фоне и передаёт их диагностику в проверку после записи, используемую write_file и patch. Работает только при обнаружении git-рабочего пространства — LSP запускается только тогда, когда текущий рабочий каталог или редактируемый файл находится внутри git worktree.

Подкоманды:

Подкоманда	Описание
status	Показать состояние сервиса, настроенные серверы, статус установки.
list	Вывести реестр поддерживаемых серверов. Используйте --installed-only, чтобы пропустить отсутствующие.
install <id>	Принудительно установить бинарный файл одного сервера.
install-all	Установить каждый сервер с известным рецептом автоустановки.
restart	Остановить работающие клиенты, чтобы следующее редактирование перезапустило их.
which <id>	Вывести разрешённый путь к бинарному файлу для одного сервера.

См. LSP — Семантическая диагностика для полного руководства, поддерживаемых языков и параметров конфигурации.

vibeos setup

vibeos setup [model|tts|terminal|gateway|tools|agent] [--non-interactive] [--reset] [--quick] [--reconfigure] [--portal]

Самый простой путь: vibeos setup --portal — OAuth-вход в Nous Portal и подключение к Tool Gateway за один раз.

Первый запуск: запускает мастер первого запуска.

Вернувшийся пользователь (уже настроен): сразу переходит к полному мастеру перенастройки — каждое приглашение показывает ваше текущее значение в качестве значения по умолчанию, нажмите Enter, чтобы оставить, или введите новое значение. Без меню.

Перейдите в один раздел вместо полного мастера:

Раздел	Описание
model	Настройка провайдера и модели.
terminal	Настройка терминального бэкенда и песочницы.
gateway	Настройка платформ обмена сообщениями.
tools	Включение/отключение инструментов для каждой платформы.
agent	Настройки поведения агента.

Опции:

Опция	Описание
--quick	Для запусков вернувшегося пользователя: запрашивать только элементы, которые отсутствуют или не установлены. Пропустить элементы, которые у вас уже настроены.
--non-interactive	Использовать значения по умолчанию / из окружения без запросов.
--reset	Сбросить конфигурацию на значения по умолчанию перед настройкой.
--reconfigure	Обратно совместимый алиас — простой vibeos setup на существующей установке теперь делает это по умолчанию.
--portal	Одноразовая настройка Nous Portal: войти через OAuth, установить Nous в качестве провайдера вывода и подключиться к Tool Gateway. Пропускает остальную часть мастера.

vibeos portal

vibeos portal [status|open|tools]

Просмотр аутентификации Nous Portal, маршрутизации Tool Gateway и доступ к странице подписки. Вызов без подкоманды запускает status.

Подкоманда	Описание
status (по умолчанию)	Состояние аутентификации Portal + сводка маршрутизации Tool Gateway для каждого инструмента. Также показывается, когда подкоманда не указана.
open	Открыть portal.nousresearch.com/manage-subscription в браузере по умолчанию.
tools	Список каждого партнёра Tool Gateway (Firecrawl, FAL, OpenAI TTS, Browser Use, Modal) и какие из них маршрутизируются через Nous.

Для настройки самого шлюза см. Tool Gateway. Для одноразового пути настройки см. vibeos setup --portal выше.

vibeos whatsapp

vibeos whatsapp

Запускает процесс сопряжения/настройки WhatsApp, включая выбор режима и сопряжение по QR-коду.

vibeos slack

vibeos slack manifest              # вывести манифест в stdout
vibeos slack manifest --write      # записать в ~/.vibeos/slack-manifest.json
vibeos slack manifest --slashes-only  # только массив features.slash_commands

Генерирует манифест приложения Slack, который регистрирует каждую команду шлюза из COMMAND_REGISTRY (/btw, /stop, /model, …) как первоклассную слеш-команду Slack — обеспечивая паритет с Discord и Telegram. Вставьте вывод в конфигурацию вашего приложения Slack на https://api.slack.com/apps → ваше приложение → Features → App Manifest → Edit, затем Save. Slack предложит переустановить, если изменились области видимости или слеш-команды.

Флаг	По умолчанию	Назначение
--write [PATH]	stdout	Записать в файл вместо stdout. Простой --write записывает в $VIBEOS_HOME/slack-manifest.json.
--name NAME	VibeOS	Отображаемое имя бота в Slack.
--description DESC	текст по умолчанию	Описание бота, показываемое в каталоге приложений Slack.
--slashes-only	выкл	Выдать только features.slash_commands для слияния с вручную поддерживаемым манифестом.

Запустите vibeos slack manifest --write снова после vibeos update, чтобы подхватить любые новые команды.

vibeos send

vibeos send --to <target> "текст сообщения"
vibeos send --to <target> --file <path>
echo "сообщение" | vibeos send --to <target>
vibeos send --list [platform]

Отправляет одноразовое сообщение на настроенную платформу обмена сообщениями без запуска агента или цикла шлюза. Повторно использует уже настроенные учётные данные шлюза (~/.vibeos/.env + ~/.vibeos/config.yaml), поэтому операционные скрипты, задания cron, хуки CI и демоны мониторинга могут публиковать обновления статуса без повторной реализации REST-клиента каждой платформы.

Для платформ с токеном бота (Telegram, Discord, Slack, Signal, SMS, WhatsApp-CloudAPI) работающий шлюз не требуется — vibeos send общается напрямую с REST-конечной точкой платформы. Платформы-плагины, которым нужен постоянный адаптер, всё ещё требуют работающего шлюза.

Опция	Описание
-t, --to <TARGET>	Цель доставки. Форматы: platform (использует домашний канал), platform:chat_id, platform:chat_id:thread_id или platform:#channel-name. Примеры: telegram, telegram:-1001234567890, discord:#ops, slack:C0123ABCD, signal:+15551234567.
-f, --file <PATH>	Прочитать тело сообщения из PATH (только текстовые файлы — логи, отчёты, markdown). Передайте -, чтобы принудительно читать из stdin. Чтобы отправить изображение или другой бинарный файл, используйте MEDIA:<path> (см. ниже).
-s, --subject <LINE>	Добавить строку темы/заголовка перед телом сообщения.
-l, --list [platform]	Список настроенных целей на всех платформах (или только на указанной платформе).
-q, --quiet	Подавить stdout при успехе — полезно в скриптах (полагаться только на код возврата).
--json	Выдать сырой JSON-результат вместо человекочитаемого вывода.

Если ни аргумент message (позиционный), ни --file не предоставлены, vibeos send читает из stdin, когда он не является TTY. Коды возврата: 0 при успехе, 1 при сбое доставки/бэкенда, 2 при ошибках использования.

Отправка изображений и других медиафайлов

--file предназначен только для текстовых тел. Чтобы доставить изображение, документ, видео или аудиофайл как нативное вложение платформы, укажите его в тексте сообщения с помощью директивы MEDIA:<local_path>:

vibeos send --to telegram "MEDIA:/tmp/screenshot.png"
vibeos send --to telegram "График сборки за сегодня MEDIA:/tmp/chart.png"   # с подписью
vibeos send --to discord:#ops "MEDIA:/tmp/report.pdf"

По умолчанию файлы изображений отправляются как фото (платформы вроде Telegram пережимают их). Добавьте [[as_document]] в сообщение, чтобы доставить их как несжатые вложения файлов:

vibeos send --to telegram "[[as_document]] MEDIA:/tmp/screenshot.png"

Примеры:

vibeos send --to telegram "развёртывание завершено"
echo "ОЗУ 92%" | vibeos send --to telegram:-1001234567890
vibeos send --to discord:#ops --file /tmp/report.md
vibeos send --to slack:#eng --subject "[CI]" --file build.log
vibeos send --list                  # все платформы
vibeos send --list telegram         # фильтр по платформе

vibeos secrets

vibeos secrets bitwarden <subcommand>
vibeos secrets bw <subcommand>          # короткий алиас

Извлекает API-ключи