Unity CLI Loop — скилл
Команда uloop и 21 скилл: агент собирает, тестирует и запускает проект Unity, читает логи и проверяет игру в Play Mode.
- 598 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- `execute-dynamic-code` запускает произвольный C# в открытом редакторе без подтверждения каждой команды.
- Агент меняет сцены, ассеты и код проекта, нажимает клавиши и кнопки в Play Mode.
- Чтобы CLI работал, нужно исключить `uloop *` из песочницы Claude Code.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/hatayama/unity-cli-loop/main/scripts/install.sh | shПервый вариант из README для macOS, Linux и Git Bash. Затем `uloop package install` и `uloop skills install --claude`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- `execute-dynamic-code` запускает произвольный C# в открытом редакторе без подтверждения каждой команды.
- Агент меняет сцены, ассеты и код проекта, нажимает клавиши и кнопки в Play Mode.
- Чтобы CLI работал, нужно исключить `uloop *` из песочницы Claude Code.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Unity CLI Loop соединяет агента с запущенным редактором Unity через команду `uloop`. Агент компилирует проект, гоняет тесты, читает логи консоли, получает иерархию сцены, снимает скриншоты окон и управляет Play Mode. Отдельные инструменты закрывают то, что код сделать не может: `hot-reload` применяет правки тел методов без перекомпиляции, `pause-point` останавливает игру на строке и возвращает локальные переменные, `simulate-keyboard` и `simulate-mouse-input` вводят данные в PlayMode. Остальное берет `execute-dynamic-code`, он запускает C# в редакторе. Скиллы ставит `uloop skills install --claude` или `--agents`.
Для кого. Разработчикам игр на Unity 2022.3 и новее, которые отдают агенту цикл «правка, компиляция, тест, проверка в Play Mode».
Подходит, если
- Агент правит C#, и после каждой правки нужны компиляция и прогон тестов без участия человека.
- Тест падает, а причину ищут по логам консоли и значениям переменных на конкретной строке.
- Интерфейс сверяют по скриншоту Game View и поправляют верстку.
- Новую механику проверяют в Play Mode: агент жмет кнопки и повторяет записанный ввод.
Не подходит, если
- Проект не на Unity 2022.3 или новее.
- Агенту нельзя выполнять произвольный C# в открытом редакторе.
- Редактор Unity на машине не запускается.
Пример запроса к агенту
Исправь ошибки компиляции, запусти тесты EditMode и покажи, какие упали и почему.Ограничения
Нужен Unity 2022.3 или новее. В песочнице Claude Code `uloop` падает с `UNITY_NOT_REACHABLE`, пока `uloop *` не добавлен в `sandbox.excludedCommands` файла `~/.claude/settings.json`. На Linux `focus-window` недоступен; установщик CLI в README указан для Linux x86_64. При обновлении с V2 собственные C#-инструменты не компилируются до миграции. Установщик запускается через `curl | sh`: прочитайте скрипт до запуска.
Как отключить. Удалите скиллы `uloop-*` из `.claude/skills` или `.agents/skills`, уберите пакет `io.github.hatayama.uloopmcp` из `Packages/manifest.json` и строку `uloop *` из `sandbox.excludedCommands`. CLI удаляется кнопкой Uninstall CLI в окне Settings.
Частые вопросы
Как поставить набор для Claude Code?
Установите CLI, затем в корне проекта выполните `uloop package install`, `uloop launch` и `uloop skills install --claude`. Для Codex и других инструментов вместо `--claude` указывают `--agents`.
Почему `uloop` не подключается в Claude Code?
Песочница блокирует соединение, и команда падает с `UNITY_NOT_REACHABLE`. Добавьте `uloop *` в `sandbox.excludedCommands` файла `~/.claude/settings.json`.
Нужно ли открывать порты?
Нет. Связь идет через сокет Unix на macOS и Linux или именованный канал на Windows, порты настраивать не требуется.
Что делает `hot-reload`?
Применяет изменения тел методов в запущенном коде без перекомпиляции, пока игра остается в Play Mode.
Сколько скиллов в наборе?
Двадцать один: от `uloop-compile` и `uloop-run-tests` до `uloop-pause-point` и `uloop-replay-input`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыОфициальный набор скиллов Unity для агентов: работа с редактором, сборки, 2D и 3D, UI, URP, звук, мультиплеер и монетизация
21 скилл ведет сольную студию на Unity: концепт, системы, архитектура, истории, код и ревью, с проверкой перед этапом.
UnitySkills
unity-skills
Управление редактором Unity из агента через REST API и скиллы: сцены, объекты и компоненты. Три режима разрешений, Unity 2022.3 и новее
Каркас для разработки игр с ИИ: 43 агента, 67 команд и 109 скиллов для Unity, Unreal, Godot и HTML5 в нескольких оболочках.
MCP-сервер внутри редактора Unity: агент создает сцены и скрипты, запускает play mode и проверяет игру скриншотами
Два скилла, правила и проверочные хуки, чтобы агент писал для VRChat корректный код UdonSharp и настраивал сцену мира на SDK 3.10.5
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Unity CLI Loop (эта карточка) | нет | 598 | ||
| MCP for Unity | нет | не нужна | 15 943 | подключает редактор по MCP; Unity CLI Loop работает через команду `uloop` и скиллы |
| Unity MCP Server | нет | не нужна | 542 | дает MCP-инструменты для сцены и сборок; здесь тот же цикл ведут CLI и 21 скилл |
| Unity Skills | нет | 1 244 | официальный набор знаний о Unity для агента; Unity CLI Loop добавляет управление запущенным редактором |
Коротко о README
Цепочка состоит из глобальной команды `uloop`, раннера проекта с версией из `.uloop/project-runner-pin.json` и IPC-сервера внутри редактора. Несколько проектов на разных версиях живут на одной машине.