CLI Doctor

CLI вашего агента умер на запуске.
Вот точная причина.

CLI агента, который не смог запуститься, это самый деморализующий сбой в AI-разработке: нет вывода, нет стектрейса, иногда просто возвращается приглашение командной строки. CLI Doctor ловит этот момент, читает, что произошло на самом деле, и отвечает на единственный важный вопрос: что сломалось и что теперь делать.

Он знает точную команду, которую запустил AgentsRoom, какой флаг пришёл из какой настройки и что CLI вывел перед тем, как сдаться. Такого контекста у результата поиска в интернете нет никогда.

Скачать AgentsRoomБесплатноПосмотреть, как это работает

CLI Doctor

Запуск не удался

$ claude --model opus-5 --mcp-debug

error: unknown option '--mcp-debug'

Неудавшийся запуск, настоящая ошибка и диагноз, который называет виновную настройку.

CLI агентов развиваются быстро. Флаг убирают в минорном релизе, бинарник исчезает из PATH после обновления Node, логин протухает, песочница отказывается стартовать, подхватывается конфиг, написанный для другого инструмента. Результат на вашей стороне всегда один: вы отправляете промпт, и ничего не происходит.

Сложность никогда не в самом исправлении. Она в том, чтобы понять, какая из двадцати вещей в команде запуска сломалась и откуда она взялась: из приложения, из ваших настроек провайдера, из переопределения, которое вы поставили на одного агента три недели назад, или из самого CLI, изменившегося у вас под ногами.

CLI Doctor закрывает этот разрыв. Он хранит запись о точной запущенной команде, помечает каждый флаг настройкой, которая его добавила, забирает то, что вывел CLI, и превращает всё это в короткий диагноз с конкретными шагами. Детерминированные проверки всегда выполняются первыми и имеют приоритет: ИИ говорит только тогда, когда приложение не может ответить само.

Что вы получаете вместо пустого терминала

Понятное объяснение того, что упало, а не стектрейс, который надо расшифровывать. Одно-два предложения, которые называют настоящую причину.

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

Происхождение флагов: каждый элемент команды запуска привязан к своему источнику, поэтому ответ может сказать «этот флаг пришёл из автономного режима в Настройках» вместо догадок.

То же самое для dev-команд. Когда команда сборки, тестов или сервера падает в терминале, диагноз в одном клике, и оттуда же можно передать всю историю DevOps-агенту.

Как рождается диагноз

Слои выстроены намеренно: сначала идут дешёвые и точные проверки, а ИИ остаётся последним средством.

AgentsRoom записывает настоящий запуск

В тот единственный момент, когда создаётся терминал, записывается полная команда: бинарник, флаги, модель, параметры. Именно эта запись делает возможным точный диагноз позже, и она покрывает все пути, из которых может стартовать агент, включая запуск с телефона или из тикета бэклога.

Детерминированные проверки говорят первыми

Отсутствующий бинарник, флаг, который CLI больше не принимает, незалогиненная сессия, устаревшая версия: это известные, точные вердикты. На них отвечают сразу баннером и кнопкой исправления. Без обращения к ИИ, без ожидания.

Подозрительный запуск подтверждают, а не предполагают

Если сбой не относится к известным случаям, AgentsRoom ищет шаблон ошибки в первые секунды, а затем проверяет, что на самом деле работает в терминале. CLI, который просто медленно стартует или занят установкой своих MCP-серверов при первом запуске, сбоем не считается и отбрасывается.

Диагностируется очищенный контекст

Только тогда в дело вступает ИИ: с фрагментом ошибки, обезличенной командой и картой происхождения флагов. System prompts, значения, похожие на секреты, и длинные аргументы в кавычках вычищаются на вашей машине до того, как что-либо будет отправлено.

Вы получаете сводку и шаги, а решение за вами

Диагноз появляется в терминале. Ничего никогда не выполняется за вас: кнопка действия открывает нужные настройки, предлагает перезапуск или показывает команду установки, а нажимаете её по-прежнему вы.

Откуда берётся ответ

CLI Doctor читает те же места, которые вы настраиваете. Вот три, которые дают большинство сбоев запуска.

Параметры CLI провайдера и отдельного агента

Флаги запуска приходят из настроек провайдера по умолчанию, автономного режима, закреплённой модели или переопределения для конкретного агента. Именно сюда диагноз обычно вас и отправляет.

Подробнее

Терминалы dev-команд

Команды сборки, тестов и сервера получают тот же диагноз, по клику, а не автоматически, потому что иначе падающий watch-цикл спрашивал бы бесконечно.

Подробнее

Отслеживание статуса агентов

Понимание того, думает агент, закончил, ждёт или умер, и есть то, что вообще сообщает AgentsRoom о проблеме.

Подробнее

Построено с очевидными ограничениями

Очищено до отправки

System prompts, значения окружения, похожие на секреты, и длинные аргументы в кавычках вырезаются на вашей машине, до того как запрос на диагностику будет отправлен.

Ничего не выполняется за вас

Диагноз может предложить открыть панель настроек, перезапустить агента или показать команду установки. Сам он никогда не запускает команду.

Точные ответы остаются точными

На отсутствующий бинарник или отклонённый флаг отвечает детерминированная проверка, а не модель. ИИ говорит только там, где действительно нельзя сказать ничего точного.

FAQ

Спросите нас о чём-то ещё

Какие CLI агентов покрывает CLI Doctor?

Все. Запись о запуске делается в единственной точке, где AgentsRoom создаёт терминал, поэтому покрыты все 19 CLI-агентов, которые поддерживает AgentsRoom (Claude, Codex, GitHub Copilot CLI, Cursor и ещё 15), а вместе с ними и агенты, запущенные из мобильного приложения или из тикета бэклога.

Отправляет ли он вывод моего терминала на сервер?

Он отправляет очищенный фрагмент ошибки запуска, обезличенную команду запуска и карту происхождения флагов, и только тогда, когда диагноз действительно формируется. System prompts, значения окружения, похожие на секреты, и длинные аргументы в кавычках сначала удаляются на вашей машине. Ваш исходный код туда не попадает никогда, а автоматическую диагностику можно полностью отключить в Настройках, в разделе Privacy and data.

Будет ли он сам запускать команды или менять мои настройки?

Нет. Шаг может содержать быстрый переход, который открывает нужную панель настроек, предлагает перезапустить агента или показывает команду установки для копирования. Выполнение чего бы то ни было всегда остаётся вашим действием.

Что такое происхождение флагов на практике?

AgentsRoom собирает команду запуска из нескольких слоёв: настройки провайдера по умолчанию, автономный режим, выбранная вами модель, уровень рассуждений, переопределение CLI для конкретного агента и другое. Происхождение флагов помечает каждый элемент итоговой команды тем слоем, который его туда положил, поэтому диагноз может указать на конкретный переключатель, а не описывать флаг абстрактно.

Он срабатывает на каждую ошибку?

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

Доступно ли это на бесплатном тарифе?

Да, с месячным лимитом. Plus поднимает его, а Pro на практике безлимитен. Детерминированные вердикты, которые покрывают самые частые сбои вроде отсутствующего бинарника или отклонённого флага, вообще не тарифицируются: они никогда не обращаются к модели. Если вы всё же упрётесь в лимит, добавленный в приложении собственный API-ключ OpenAI оставит диагностику работать на вашем ключе.

Что происходит с агентом, который работает на удалённой машине по SSH?

Передним процессом на вашей стороне является сам клиент SSH, поэтому удалённый CLI, который умер, отсюда выглядит здоровым, и эпизод пропускается. Это осознанный компромисс: пропущенный диагноз лучше уверенно неверного. Детерминированные проверки при этом продолжают работать на удалённой стороне соединения.

Чем это отличается от того, чтобы вставить ошибку в чат-бот?

Чат-бот видит только то сообщение, которое вы вставили. У CLI Doctor есть ещё и точная запущенная команда, происхождение каждого флага в ней, используемые провайдер и модель, а также состояние процесса, и вам не нужно ничего из этого собирать. Именно этот контекст превращает общий ответ в название настройки, которую надо поменять.

Вам также может понравиться

Мульти-провайдер

AgentsRoom поддерживает 19 AI-провайдеров для кодинга: Claude, Codex, GitHub Copilot CLI, OpenCode, Antigravity CLI, Aider, Grok Build, Mistral Vibe, Kimi Code, Amp, oh-my-pi, Freebuff, Devin, Cursor, Command Code, Muse Code, Pi, MiniMax Code и ZCode. Назначайте своего провайдера каждому агенту, переключайте провайдера посреди разговора и сохраняйте весь контекст с автоматическим хендоффом. Лучший мульти-провайдерный инструмент для AI-разработки.

Отслеживание статуса

Отслеживайте статус каждого агента Claude Code с первого взгляда. Цветовые индикаторы для состояний: работает, завершено, неактивен, ожидает ввода. Таймеры, сводки активности и счетчики по проектам.

Dev-терминалы

Запускайте сборку, тесты и dev-сервер в том же окне, что и агентов, с сигналом по завершении долгой команды и диагнозом, когда она падает.

Восстановление агентов и терминалов

Откройте приложение снова и найдите агентов и dev-терминалы там, где вы их оставили, с возможностью продолжить предыдущий разговор в CLI.

AI Commit Messages

Генератор сообщений коммитов на основе ИИ, встроенный в AgentsRoom. Нажмите на искорку в поле коммита, он считывает реальный git diff и пишет одно чистое сообщение коммита в формате Conventional Commits. Напишите черновик, получите его переписанным. Правила формата вашей команды применяются при каждом создании.

Предложения агентов

Не уверены, какого AI агента использовать? Опишите свою задачу простым языком, и AgentsRoom предложит подходящего агента: из вашей комнаты, 14 встроенных ролей или 260+ экспертов из каталога, с одной строкой причины. Один клик назначает задачу.