BootUI — скилл

Скилл и MCP-сервер, которые дают агенту смотреть запросы, SQL и исключения запущенного приложения на Spring Boot или Quarkus

  • 324 ★ репозитория
  • Последний коммит
  • Apache-2.0
Скилл

Расширенный доступ

Почему такой уровень

  • Скилл читает трассировки, SQL и конфигурацию запущенного приложения, значения секретов по умолчанию маскируются
  • Сканирование уязвимостей отправляет имена и версии пакетов во внешний сервис, поэтому скилл просит согласие перед запуском
Все причины и проверки

jdubois/boot-ui

Установка

Ручная установка

npx skills add https://github.com/jdubois/boot-ui/tree/main/skills/bootui

Интерактивный установщик сам находит поддерживаемых агентов.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Скилл читает трассировки, SQL и конфигурацию запущенного приложения, значения секретов по умолчанию маскируются
  • Сканирование уязвимостей отправляет имена и версии пакетов во внешний сервис, поэтому скилл просит согласие перед запуском

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл BootUI учит агента подключать к Java-приложению локальную панель разработчика BootUI и читать данные запущенного приложения: запросы, SQL и исключения. Еще доступны бины, конфигурация, метрики и логи. Панель работает на Spring Boot и Quarkus, а скилл лежит в папке skills/bootui. Скилл ведет агента по порядку. Сначала агент определяет сборщик и стек, потом добавляет одну зависимость BootUI и запускает приложение в режиме разработки. Дальше он оценивает состояние приложения, предлагает план по приоритетам и выполняет только исправления, которые вы одобрили. К данным агент обращается тремя путями: через MCP-инструменты, через командную строку bootui или обычным HTTP-запросом к локальному адресу. Сканирование, очистку буферов и другие действия, которые меняют состояние, скилл велит называть вслух и запускать после вашего согласия. Скилл помогает найти проблему N+1 в запросах, транзакции, разбитые на части, и вызовы `@Transactional` мимо прокси. Он же показывает, какие маршруты затрагивает изменение кода. После правки агент сравнивает прогоны и проверяет, что изменилось в работе приложения.

Для кого. Для Java-разработчиков на Spring Boot или Quarkus, которые отлаживают медленные запросы, SQL и исключения вместе с Claude Code, Cursor или GitHub Copilot.

Подходит, если

  • Конечная точка отвечает медленно, и нужно найти повторяющиеся SELECT и N+1 по реальному профилю запроса
  • В приложении падает исключение, и агенту нужны трассировка стека и цепочка причин из работающего процесса
  • Перед правкой репозитория или бина нужно узнать, какие маршруты через него проходят
  • После изменения кода надо сверить прогоны тестов и увидеть, исполнился ли измененный метод
  • Нужен приоритетный план по здоровью приложения: безопасность, память, база данных, REST

Не подходит, если

  • Приложение написано не на Spring Boot 4 и не на Quarkus 3: скилл рассчитан только на эти версии
  • Нужен мониторинг боевого сервера: BootUI включается только в локальной разработке, а в производственной сборке Quarkus остается выключенным
  • Нужно открыть консоль для внешних адресов: скилл прямо запрещает ослаблять защиту ради удобства

Пример запроса к агенту

Эндпоинт /orders отвечает 3 секунды. Подключи BootUI, найди повторяющиеся SQL и предложи план исправления.

Ограничения

Нужны Java 17 или новее и поддерживаемая версия фреймворка, Spring Boot 4.x или Quarkus 3.x. Консоль по умолчанию работает только на локальном адресе и скрывает значения секретов.

Командная строка `bootui` требует JDK 17 и ставится отдельно, скилл просит согласие перед установкой. Часть панелей зависит от подключенных библиотек и может быть недоступна. Скилл написан на английском языке. Если нужной панели нет в приложении, скилл сообщает об этом и не пытается ослабить настройки безопасности ради запроса.

Как отключить. Удалите зависимость BootUI из сборки проекта и перезапустите приложение. Скилл уберите командой удаления скиллов вашего агента или удалением папки `bootui` из каталога скиллов.

Частые вопросы

Как поставить скилл BootUI в Claude Code?

Через плагин: `/plugin marketplace add jdubois/boot-ui`, затем `/plugin install bootui@bootui`. Плагин ставит скилл и настраивает MCP-сервер вместе. Универсальный путь для любого агента с поддержкой Agent Skills: `npx skills add https://github.com/jdubois/boot-ui/tree/main/skills/bootui`.

Как поставить BootUI в GitHub Copilot и Cursor?

Для GitHub Copilot есть команда `gh skill install jdubois/boot-ui skills/bootui`. Для Cursor плагин BootUI находится в каталоге Cursor Directory.

Нужно ли включать MCP-сервер, чтобы агент видел приложение?

Нет. Скилл сначала проверяет, есть ли MCP-инструменты, потом пробует командную строку `bootui`, затем обычный HTTP-запрос. Включать MCP через `bootui.mcp.enabled=ON` скилл предлагает, когда вы просите подключить агента как клиента.

Что делает команда bootui с кодом выхода 3?

Код 3 возвращает проверка с флагом `--fail-on <severity>`, когда найдена проблема не ниже указанной серьезности. Код 2 значит, что панель отключена или работает только на чтение. Это удобно для проверки в CI.

Можно ли подключить BootUI сразу для Spring и для Quarkus?

Нет. Для Spring Boot нужен стартер com.julien-dubois.bootui:bootui-spring-boot-starter, для Quarkus расширение com.julien-dubois.bootui:bootui-quarkus, и смешивать их нельзя. На Spring Boot подходят и сервлетный стек, и WebFlux.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Проверяемый реестр скиллов с CLI для установки в два десятка агентов и MCP-сервером для поиска скиллов на лету

СкиллРасширенный доступ7,1 тыс.Звезды репозитория

Builder Skills

Skills for agents

Набор небольших скиллов от Builder.io для рабочих привычек агента: визуальные планы и разборы диффов, сверка с документацией, кросс-агентное ревью и аккуратные

СкиллРасширенный доступ4,6 тыс.Звезды репозитория

Скилл меняет манеру работы агента: вместо давления и угроз он опирается на доверие, доводит задачи до конца и честно сообщает о неуверенности

СкиллМинимальный доступ1,4 тыс.Звезды репозитория

Скилл ускоряет сборку Xcode: замеряет чистые и инкрементальные сборки, находит узкие места и подбирает настройки проекта

СкиллРасширенный доступ1,3 тыс.Звезды репозитория
Выбор редакции

Набор скиллов от команды Kotlin для агентов: перевод Java в Kotlin, миграции сборки и правильная работа с бэкенд-фреймворками

ПлагинРасширенный доступ1,1 тыс.Звезды репозитория
Официальный

Скиллы команды Dart: тесты и моки, анализ и dart fix, CLI-приложения, FFI, документация и разбор конфликтов пакетов для ИИ-агента

СкиллМинимальный доступ534Звезды репозитория

Сравнение с похожими

Записи с тем же главным запросом: чем они отличаются.

ЗаписьОфициальныйЗвезды репозиторияГлавное отличие
BootUI (эта запись)нет324
spring-boot-skillsнет333учит агента писать Spring Boot по вашим шаблонам, но не читает работающее приложение
claude-code-javaнет761набор скиллов для Java: ревью, JPA, конкурентность и миграции версий, без данных из процесса

Коротко о README

Репозиторий содержит консоль BootUI, стартер для Spring Boot, расширение для Quarkus, командную строку и MCP-сервер. Все части построены на одном реестре диагностик, а документация по настройке лежит на сайте проекта.

Бейдж для README

Исходный SKILL.md

---
name: bootui
description: Install, configure, and use BootUI in Spring Boot and Quarkus applications; assess a running application, propose a prioritized action plan, and execute only approved fixes using runtime evidence. Use when asked to add or troubleshoot BootUI, assess application health, or investigate a slow or failing endpoint, exceptions, SQL, Hibernate, beans, mappings, configuration, health, metrics, logs, or traces; to find runtime-only bugs such as N+1 queries, split transactions, or bypassed @Transactional proxies, or check which routes a code change affects and verify what it changed at runtime after the tests; also for architecture, security, memory, database, REST, pentest, GraalVM, CRaC, or vulnerability scans, or connecting an AI agent to BootUI.
license: Apache-2.0
---

# BootUI

Use BootUI as a local, runtime-grounded source of information for Spring Boot and Quarkus applications. Keep it
local-only, preserve its fail-closed defaults, and make the smallest application change that addresses the user's request.

## Establish the application context

Before changing anything:

1. Identify the build tool and use its wrapper when present.
2. Identify the framework and web stack:
   - Spring Boot servlet
   - Spring Boot WebFlux
   - Quarkus
3. Confirm Java 17 or later and a supported framework version (Spring Boot 4.x or Quarkus 3.x).
4. Find the runnable module, active development profile, configured HTTP port, and existing BootUI dependency.
5. Run the project's existing focused tests before and after changes when practical.

Keep an existing application's own web stack. BootUI adds no web starter; a non-web Spring application needs an
explicitly approved servlet starter and embedded server to serve the console. `bootui.force-web` requests servlet
mode, not dependencies. Do not add the Spring starter to Quarkus or the Quarkus extension to Spring.

## Install BootUI

Add the dependency only when the user asked for BootUI or approves the change. If a diagnostic request arrives and
BootUI is not on the classpath, say so first rather than installing it silently.

Determine the latest stable BootUI version from Maven Central or the
[BootUI releases](https://github.com/jdubois/boot-ui/releases); do not guess a version or use a snapshot unless requested.
Use the project's existing dependency-management and formatting conventions.

Choose exactly one dependency:

| Application | Maven coordinates |
| --- | --- |
| Spring Boot (Spring MVC or WebFlux) | `com.julien-dubois.bootui:bootui-spring-boot-starter` |
| Quarkus | `com.julien-dubois.bootui:bootui-quarkus` |

The Spring starter brings no web stack: keep the application's own `spring-boot-starter-web` or

Сообщить о проблеме

Foxx AIBootUI
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.