OpenPets CLI
Настольный питомец, который реагирует на работу Claude Code, OpenCode и Cursor через хуки и MCP, не выводя в реплики код, пути и секреты
- 1 347 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Дописывает в настройки Claude Code хуки, которые выполняются при каждом событии агента, и меняет конфигурацию OpenCode и Cursor
- Приложение запускает сторонние плагины, у которых могут быть права на микрофон, буфер обмена и сеть после вашего согласия
- Удаленный режим управления в первой версии не шифрует трафик
Установка
- Работает в
Ручная установка
npx @open-pets/cli configureЗапускайте в папке проекта при работающем приложении. Настраивает Claude Code, OpenCode или Cursor в зависимости от выбранной цели.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Дописывает в настройки Claude Code хуки, которые выполняются при каждом событии агента, и меняет конфигурацию OpenCode и Cursor
- Приложение запускает сторонние плагины, у которых могут быть права на микрофон, буфер обмена и сеть после вашего согласия
- Удаленный режим управления в первой версии не шифрует трафик
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
OpenPets — настольное приложение с анимированным питомцем и плагинами. Агентная часть необязательна: приложение работает и без нее. Ее подключают командой `npx @open-pets/cli configure`: для Claude Code она прописывает хуки жизненного цикла и MCP-сервер `openpets`, для OpenCode и Cursor пишет конфигурацию проекта (для OpenCode можно глобально с флагом `--global`). Для остальных клиентов MCP сервер запускает `npx @open-pets/cli mcp` по stdio. Хуки превращают события агента в реакции питомца. Отправка запроса дает «думает», запрос разрешения дает «ждет», остановка с успехом дает «успех», ошибка дает «ошибка». Вызов `Edit`, `Write` или `MultiEdit` показывает редактирование, команды запуска тестов показывают проверку. Через MCP агент сам задает реакцию, показывает реплику и обновляет статус задачи. События уходят в запущенное приложение по локальному IPC. Реплики питомца проходят через отдельную защиту: автоматические сообщения берутся из заготовленных списков, а проверка отклоняет строки длиннее 140 знаков, с кодом, ссылками, путями и похожими на секреты токенами. Если запущено несколько сеансов, каждый получает своего питомца из заданного вами списка. Диагностику дает `npx @open-pets/cli doctor`.
Для кого. Для разработчиков на macOS, Windows и Linux, которые запускают агентов в фоне, хотят по питомцу на экране понимать, что агент ждет разрешения или закончил работу, и не против лишнего приложения на рабочем столе.
Подходит, если
- Агент работает в соседнем окне, и вы хотите видеть по питомцу, что он ждет вашего разрешения
- Параллельно идет несколько сеансов, и каждому нужен свой питомец вместо одного общего
- Хочется напоминаний и таймеров рядом с работой: официальные плагины включают Focus Buddy, Reminders и Water Reminder
- Нужно написать свой плагин: `npx @open-pets/cli plugin new` создает заготовку по шаблонам, а `plugin validate` проверяет манифест
- Реакции питомца должны запускаться из скриптов: `npx @open-pets/cli react success` и `say` отправляют их в приложение
Не подходит, если
- Вам нужен инструмент, который меняет результат работы агента: OpenPets только показывает состояние и не влияет на код
- Политика компании запрещает ставить на рабочую машину приложения со сторонними плагинами: плагины работают в песочнице, но запрашивают такие права, как `voice:listen` и `clipboard`
- Вы работаете на сервере без экрана: питомец рисуется на рабочем столе и не работает без запущенного приложения
- Агент в Zed или другом клиенте без хуков: там доступно только управление реакциями через MCP, без автоматических реакций на события
Пример запроса к агенту
Подключи OpenPets к Claude Code в этом проекте и проверь командой doctor, что питомец получает событияОграничения
Команды `npx @open-pets/cli` разговаривают с запущенным настольным приложением. Без запущенного приложения питомец не реагирует. Команда `npx @open-pets/cli status` показывает, достижимо ли оно. Установщики лежат на странице релизов: сборки macOS могут быть не подписаны, поэтому система предупредит при запуске. Установщики для Windows подписаны.
Удаленный режим управления первой версии идет по обычному TCP без шифрования. Автор не советует выставлять его в интернет, пробрасывать порты или использовать в общей сети Wi-Fi. Хуки Claude Code пишутся в настройки агента и помечены `--openpets-managed`, чтобы их можно было обновить или убрать, не трогая ваши записи. Для клиента OpenClaw используется отдельный глобальный плагин. Лицензия MIT.
Как отключить. Закройте приложение OpenPets: хуки и MCP тогда ничего не доставляют, агент сбоев связи не замечает. Чтобы убрать подключение, откройте настройки интеграций в приложении или удалите записи с пометкой `--openpets-managed` из настроек Claude Code и блок `openpets` из MCP-конфигурации клиента.
Частые вопросы
Как подключить питомца к Claude Code?
Скачайте и запустите приложение OpenPets, затем в проекте выполните `npx @open-pets/cli configure`. Команда пропишет хуки событий и MCP-сервер, а `npx @open-pets/cli doctor` проверит хуки и связь с приложением без записи.
Какие события агента меняют реакцию питомца?
Отправка запроса, запрос разрешения, уведомление, обычная остановка и остановка с ошибкой. Вызовы `Edit`, `Write` и `MultiEdit` показывают редактирование, а команды запуска тестов показывают проверку. Хуки работают без ожидания ответа и не замедляют агента.
Увидит ли питомец мой код или секреты?
Автор заявляет, что нет. Реплики берутся из готовых списков по категориям, а проверка отклоняет строки с кодом, ссылками, путями и токенами и длиннее 140 знаков. Для OpenClaw плагин не читает аргументы событий.
Как запустить MCP-сервер OpenPets для другого клиента?
Укажите в клиенте команду `npx @open-pets/cli mcp` как сервер stdio. Он управляет реакцией, репликой, статусом задачи и выбором питомца под агента, а приложение должно быть уже запущено.
Как сделать плагин для питомца?
Выполните `npx @open-pets/cli plugin new "My Plugin" --template tamagotchi`, всего шесть шаблонов: `blank`, `reminder`, `ambient`, `ai-chat`, `tamagotchi` и `calendar`. Проверка `npx @open-pets/cli plugin validate ./my-plugin` повторяет проверки установки, а набор `@open-pets/plugin-sdk/testing` позволяет тестировать без приложения.
Что делает пул питомцев при нескольких агентах?
Включенный по умолчанию пул выдает каждому параллельному сеансу следующего свободного питомца из настроенного списка. Если свободных нет, сеанс берет питомца по умолчанию, а флаг `--pet <id>` обходит пул.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыКаталог анимированных питомцев для кодинг-агентов: CLI ставит питомца одной командой, а настольное приложение показывает его реакцию на действия агента
OpenSkills запускает официальные скиллы Anthropic в изолированном контейнере на Mac и отдает их по MCP любому агенту: Gemini CLI, Qwen CLI, OpenCode
Звуковые и экранные уведомления для агентов: голосовые реплики из игр, когда агент закончил задачу или ждет разрешения
Настольное приложение OpenCove раскладывает сеансы Claude Code и Codex, терминалы и заметки по бесконечному холсту
Agent Client для Obsidian
Agent Client
Плагин Obsidian, который запускает Claude Code, Codex и другие агенты по Agent Client Protocol прямо внутри хранилища заметок
Локальный MCP-сервер, с помощью которого агент задает вам вопрос в консоли, ждет ответа и присылает уведомление о конце работы
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| OpenPets (эта запись) | да | 1 347 | |
| Petdex | нет | 4 302 | каталог анимированных питомцев для кодинг-агентов: CLI ставит питомца одной командой, а настольное приложение показывает его реакцию |
| PocketMen with You | нет | 295 | скилл для Codex делает анимированного компаньона по двум и более |
Коротко о README
Описание начинается со скачивания приложения для macOS, Windows и Linux и перечня возможностей: питомцы, официальные плагины, SDK третьей версии и необязательный слой агентов. Дальше идут установка с примечанием о неподписанных сборках macOS, галерея питомцев, девять официальных плагинов и безопасность песочницы с таблицей разрешений. Раздел разработчика показывает шаблоны, проверку и тестовый стенд. Отдельные документы описывают MCP, интеграции с агентами, формат питомцев, локальный IPC и сборку релизов.