Tiny Engineer CLI
CLI связывает события Claude Code и Cursor с настольным роботом: движения, выражения на экране и звонок после задачи
- 1 074 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Настройка меняет хуки редактора, которые затем запускают локальный CLI
- Команды отправляются физическому устройству и могут двигать сервоприводы или включать динамик
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/tiny-engineerОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Настройка меняет хуки редактора, которые затем запускают локальный CLI
- Команды отправляются физическому устройству и могут двигать сервоприводы или включать динамик
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Tiny Engineer CLI передает события кодового агента небольшому роботу на ESP32. Когда агент читает файлы или пишет код, робот меняет позу и изображение на экране. Завершение задачи можно отметить звонком. Команда настройки добавляет хуки выбранного редактора в проект. Они вызывают общий CLI, который отправляет название анимации по HTTP в локальной сети или по USB. Поддерживаются готовые сценарии для Claude Code, Cursor и Antigravity; другие агенты могут обращаться к HTTP API напрямую. Робот также воспроизводит короткие звуковые файлы. Для этого в репозитории есть отдельный скилл: он подготавливает запись речи и передает ее устройству. Устройство нужно собрать или купить и прошить отдельно.
Для кого. Для разработчиков и любителей электроники, которые хотят видеть состояние кодового агента на физическом устройстве рядом с компьютером.
Подходит, если
- Нужно заметить завершение долгой задачи по движению или звонку настольного робота
- Готовый робот уже собран, и его надо подключить к событиям редактора без собственных HTTP-скриптов
- Рабочая среда допускает только USB, и события агента нужно передавать через последовательный порт
- Нужно озвучить короткое сообщение через динамик робота
Не подходит, если
- Нужно получить программное уведомление без сборки или покупки отдельного устройства
- Нужен универсальный интерфейс для промышленного робота или системы ROS
- Вы ожидаете, что робот сам проверит качество написанного кода или исполнит задачу агента
Пример запроса к агенту
Подключи уже собранный Tiny Engineer к Claude Code через USB. Сначала покажи, какие файлы проекта изменит настройка, затем проверь соединение и сигнал завершения.Ограничения
Нужны собранный робот с прошивкой и питание 5 В, не менее 2 А; CLI не заменяет устройство. Для HTTP компьютер и робот должны видеть друг друга по сети, прошивка использует Wi-Fi 2,4 ГГц. Проверка токена на устройстве необязательна: при ее включении передайте `TINY_ENGINEER_TOKEN` через окружение или пользовательский конфиг. Файл `.env` проекта может переопределить параметры соединения пользователя; до отправки команд проверьте предупреждения `doctor`.
Как отключить. Выполните `npx -y tiny-engineer uninstall cursor --yes` для хуков Cursor; для другого редактора выберите его имя. Эта операция удаляет записи Tiny Engineer, но сохраняет пользовательский файл соединения. Чтобы прекратить движения устройства, отключите его питание.
Частые вопросы
Какие файлы меняет настройка хуков?
Для Cursor используется `.cursor/hooks.json`. Claude Code хранит хуки в `.claude/settings.json`, Antigravity в `.agents/hooks.json`. Параметры соединения сохраняются отдельно в пользовательском каталоге Tiny Engineer. Настройка не записывает ключи в проектный `.env`.
Как проверить соединение без настройки своей интеграции?
Выполните `npx -y tiny-engineer doctor`. Для сетевого устройства доступен запрос к `/health`: он проверяет ответ прошивки без движения механизмов. Адрес можно взять с экрана робота.
Можно ли использовать Codex?
Да, если связать события Codex с HTTP API или последовательным протоколом самостоятельно. Готового мастера хуков для Codex нет; он настраивает Cursor, Claude Code и Antigravity.
Какой звук умеет воспроизводить робот?
Ему нужен WAV с 16-битным монофоническим PCM, частота 22 050 Гц. Скилл `tiny-engineer-play` использует системный синтез речи и преобразование через FFmpeg. Пока звучит запись, обычные анимации ждут завершения запроса.
Что делать со старыми пакетами для отдельных редакторов?
Используйте общий пакет `tiny-engineer`. Прежние отдельные программы для Cursor, Claude Code и Antigravity помечены устаревшими. После перенастройки проверьте хуки, чтобы старый и новый обработчики не отправляли одинаковые события.
Какие лицензии действуют?
Программы имеют MIT, аппаратные чертежи CERN-OHL-S-2.0. Название и логотип имеют отдельные ограничения.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПодключает Claude Code, Cursor, Codex или OpenCode к Telegram, Slack и Discord: коллеги пишут боту, отвечает кодовый агент
Шлюз для настольного робота на M5Stack CoreS3: голос, слово пробуждения и MCP-сервер, через который агент заставляет его говорить
CLI для умного дома SwitchBot: устройства и сцены из терминала, MCP-сервер для Claude Code, Codex и Gemini CLI.
Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub
CLI, который прогоняет Claude Code, Codex, OpenCode и другие агенты циклом по списку задач или PRD, пока все не будет сделано
quackd подключает роботов к Claude Code и Claude Desktop по MCP: девять инструментов и исполнитель с белым списком
Коротко о README
В аппаратной части проекта есть модели корпуса и схема платы управления. Инструкции по сборке объясняют подключение компонентов и установку прошивки.