compose-ai-tools — плагин
Агент рендерит превью Jetpack Compose в PNG и видит итог правок: плагин, CLI, расширение VS Code и MCP.
- 127 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Скрипт установки для других агентов скачивается и запускается из сети.
- Gradle-плагин встраивается в сборку проекта.
Установка
- Работает в
Ручная установка
/plugin marketplace add yschimke/compose-agent-pluginsПервая команда из README, затем `/plugin install compose-preview@compose-agent-plugins`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скрипт установки для других агентов скачивается и запускается из сети.
- Gradle-плагин встраивается в сборку проекта.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
compose-ai-tools показывает агенту, как выглядит интерфейс на Jetpack Compose после изменения. Команда `compose-preview render` превращает каждую аннотацию `@Preview` в PNG, `compose-preview browse` открывает их для просмотра. Рядом с картинкой выдаются данные: замечания по доступности, дерево разметки, токены темы, тепловые карты перерисовок. Плагин `compose-preview` ставится в Claude Code и Codex, остальные агенты получают те же навыки установочным скриптом. Есть локальный и размещенный MCP-серверы, GitHub Action с рендером до и после в пулреквестах и расширение VS Code. Сборочные файлы проекта править не нужно: инструмент подключается к проектам с плагинами Android и Compose сам.
Для кого. Android-разработчикам на Compose, которые поручают агенту правки экранов и хотят видеть результат без запуска эмулятора.
Подходит, если
- Агент изменил экран, и нужно убедиться по картинке, что верстка не поехала.
- В пулреквесте с UI-правками нужны снимки до и после.
- Проверка доступности экрана должна идти вместе с рендером.
- Для магазина приложений нужны скриншоты прямо из `@Preview`.
Не подходит, если
- Проект написан на классических XML-экранах без Compose.
- Нужна проверка на реальном устройстве со всеми датчиками.
- Версии Java, Gradle или Kotlin ниже требуемых.
Пример запроса к агенту
Отрендери превью экрана настроек и покажи, не обрезается ли текст на маленьких экранах.Ограничения
Нужны Java 17 и новее, Gradle 8.13 и новее, AGP 8.13.0 и новее, Kotlin 2.0.21 и новее. Инструмент подключается к проектам, где уже применены `com.android.application`, `com.android.library` или `org.jetbrains.compose`. Установочный скрипт для остальных агентов запускается через `curl` с GitHub, поэтому его стоит прочитать до запуска. Рендер идет через Robolectric или Compose Desktop, и часть эффектов реального устройства он не воспроизводит. Часть функций, например сервер превью, требует отдельной настройки.
Как отключить. В Claude Code удалите плагин командой `/plugin` и источник `compose-agent-plugins`. Для CLI удалите бинарный файл `compose-preview`, из Gradle плагин убирается вместе с его записью в сборке.
Частые вопросы
Нужен ли эмулятор?
Нет, превью строится через Robolectric или Compose Desktop. Для запуска APK без эмулятора есть команда `compose-preview launch app.apk`.
Как поставить в Claude Code?
Выполните `/plugin marketplace add yschimke/compose-agent-plugins`, затем `/plugin install compose-preview@compose-agent-plugins`.
Работает ли без агента?
Да, есть расширение VS Code и CLI. Расширение ставится в VS Code, Cursor, Windsurf и VSCodium без правок проекта.
Что такое MCP-режим?
Локальный или размещенный MCP-сервер дает агенту рендер как инструмент и экономит токены в цикле правки интерфейса.
Какие версии нужны?
Java 17 и новее, Gradle 8.13 и новее, AGP 8.13.0 и новее, Kotlin 2.0.21 и новее.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПлагин показывает агенту и вам Compose Preview в браузере и перерисовывает их через секунду после сохранения, без Android Studio.
Скилл для Jetpack Compose и Compose Multiplatform: агент пишет UI по справочникам и сверяется с исходниками androidx
Два скилла для Jetpack Compose: аудит репозитория с оценкой 0–100 по данным компилятора и помощник при написании кода.
21 скилл для Android и KMP в Claude Code, Codex и Copilot CLI: Compose, корутины, Flow, сеть, хранение, тесты и Gradle
MCP-сервер и CLI: агент рендерит SwiftUI-превью в PNG на разных устройствах и сам проверяет вид экрана после правок
Набор из 26 скиллов о производительности Jetpack Compose: от аудита с замерами до профилей Baseline и R8
Коротко о README
Пять путей установки, режим без агента и расширенные возможности: данные доступности, PR-ревью и MCP. Раздел с реальными пулреквестами агентов показывает, как инструмент применяют на практике.