Rsdoctor Agent CLI
Консольная утилита rsdoctor-agent отдает агенту данные анализа сборки Rspack в JSON: чанки, модули, дубли пакетов, tree-shaking.
- 1 152 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Читает локальный файл данных сборки и ничего не меняет; скилл может ставить пакет глобально.
Установка
- Работает в
Ручная установка
pnpm add -D @rsdoctor/agent-cliКоманда установки из README пакета, бинарник `rsdoctor-agent`.
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Читает локальный файл данных сборки и ничего не меняет; скилл может ставить пакет глобально.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Rsdoctor — анализатор сборки для экосистемы Rspack. Пакет `@rsdoctor/agent-cli` с бинарником `rsdoctor-agent` читает файл данных `rsdoctor-data.json` и печатает результаты как структурированный JSON, который агенту легко искать, фильтровать и листать постранично. Прямые команды покрывают области отчета: `chunks list`, `modules by-id`, `packages list`, `tree-shaking summary`, `bundle optimize`, `assets diff` для сравнения двух сборок. Команда `query` вызывает инструмент каталога по имени, например `packages_duplicates`. Утилита работает в паре со скиллом `rsdoctor-analysis` из репозитория rstackjs/agent-skills: скилл проводит проект через анализ сборки, а CLI запрашивает полученные данные. Если проект собирает несколько бандлов, например web и Node.js, нужный компилятор выбирает флаг `--compiler`. В версии Rsdoctor 2.x прежний MCP-сервер `@rsdoctor/mcp-server` удален, эту роль выполняет agent-cli.
Для кого. Фронтенд-разработчикам на Rspack, которые ищут причины тяжелого бандла и медленной сборки вместе с агентом.
Подходит, если
- Бандл вырос, и агент ищет самые тяжелые модули и пакеты в сборке.
- В проекте подозревают дубли одного пакета в разных версиях.
- Два отчета до и после изменения сравниваются командой `assets diff`.
- Сборка web и Node.js идет двумя компиляторами, и анализ нужен только для одного.
Не подходит, если
- Нужен интерактивный отчет с визуализацией: для него есть сам Rsdoctor в браузере.
- Сборка идет на webpack или другом инструменте вне Rstack.
- Требуется MCP-сервер: в Rsdoctor 2.x его нет, нужна версия 1.
Пример запроса к агенту
Проанализируй сборку этого проекта через Rsdoctor и скажи, по каким направлениям можно уменьшить размер бандла.Ограничения
Утилита читает только готовый файл данных, поэтому сначала проект надо собрать с плагином Rsdoctor: в `output` задают `mode: 'brief'` и тип `json` или переменную `RSDOCTOR_OUTPUT='json'` (плагины версии 1.5.11 и новее). При нескольких компиляторах в отчете флаг `--compiler` обязателен. Старые отчеты без индекса компиляторов читаются без этого флага. MCP-сервер `@rsdoctor/mcp-server` относится к версии 1, в 2.x его заменяет agent-cli.
Как отключить. Удалите пакет (`pnpm remove @rsdoctor/agent-cli`) и скилл rsdoctor-analysis из каталога скиллов агента. Файлы `rsdoctor-data.json` в проекте удаляются вручную.
Частые вопросы
Как установить rsdoctor-agent?
Выполните `pnpm add -D @rsdoctor/agent-cli`, бинарник называется `rsdoctor-agent`. Устанавливать пакет заранее не обязательно: скилл при необходимости ставит его глобально сам.
Откуда берется rsdoctor-data.json?
Его пишет плагин Rsdoctor при сборке: в настройках `output` задайте `mode: 'brief'` и `type: ['json']`. Подойдет и переменная окружения `RSDOCTOR_OUTPUT='json'` для плагинов версии 1.5.11 и новее.
Как выбрать нужный компилятор?
Список выдает `rsdoctor-agent compilers list --data-file ./rsdoctor-data.json`, затем точное имя передают флагом `--compiler`, например `--compiler node`. Флаг пишут отдельно от JSON в `--input`.
Куда делся MCP-сервер Rsdoctor?
В версии 2.x пакет `@rsdoctor/mcp-server` удален. Для работы с агентами используйте `@rsdoctor/agent-cli` и скилл `rsdoctor-analysis`. Прежняя инструкция по MCP осталась в документации первой версии.
Как посмотреть схемы команд?
Команды `rsdoctor-agent --describe` и `rsdoctor-agent --schema chunks.list` печатают описания и схемы аргументов, а `rsdoctor-agent list` выдает все подкоманды машиночитаемым JSON.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПлагин со скиллами для Rstack: настройка, переход на v2, отладка и разбор сборок Rspack, Rsbuild, Rslib, Rspress и Rstest.
CLI проверяет код React без нейросети по состоянию, производительности, безопасности и доступности, ставит оценку 0–100 и дает агенту скилл для исправлений
Агент получает спецификацию MDMA, промпты и проверку, чтобы отвечать формами, таблицами и согласованиями прямо в Markdown
Webpack Bundle Analyzer CLI читает статистику сборки и показывает вклад модулей в размер JavaScript-бандлов до и после сжатия.
CLI, который дает агенту смотреть работающее приложение на React: дерево компонентов, props, state, hooks и профилирование рендеров
Дизайн-студия для людей и агентов: CLI dsa, MCP по адресу /mcp и скилл правят сайты, слайды, отчеты и 3D в одном документе.
Коротко о README
Репозиторий Rsdoctor ведет команда Rstack. Пакет agent-cli лежит в `packages/agent-cli`, а документация по ИИ описывает также файлы `llms.txt` и `llms-full.txt` с полным текстом документации.