Подключение агентов
Как подключить Claude Code, Codex, Cursor и свои программы, чтобы питомец показывал их работу.
Питомец показывает, что делает агент: работает, ждёт вас, закончил или ошибся. Подключения бесплатны для всех, в том числе с бесплатным питомцем.
Как подключить
- Откройте настройки приложения, вкладку «Подключения».
- Выберите агента. Приложение покажет файл настроек агента и точный фрагмент, который в него добавит.
- Нажмите «Установить». Перед изменением приложение сохраняет копию файла рядом с ним (
<файл>.pets-backup-<время>) и добавляет только свои записи. Чужие настройки остаются как были. - Для проверки нажмите «Тест»: питомец покажет демонстрацию. Такие события отмечены как «Демонстрация».
Статус «Работает» появляется только после настоящего события от агента. Удаление подключения снимает только записи приложения — ваши правки и чужие записи остаются.
Питомец ничего не одобряет и не отвечает агенту за вас. Он только показывает состояние и не задерживает работу агента.
Claude Code
Записи добавляются в файл ~/.claude/settings.json. Питомец показывает начало работы, работу с инструментами, «нужен ввод» (запрос разрешения или вопрос), «готово» и ошибки.
Известные особенности:
- когда вы одобрили запрос разрешения, отдельного сигнала об этом нет: «нужен ввод» держится до следующего события, например до конца долгой команды;
- если прервать ответ клавишей Esc, сигнала о конце может не быть: питомец вернётся в покой примерно через минуту.
Codex
Записи добавляются в файл ~/.codex/hooks.json (или в папку из переменной CODEX_HOME, если она задана).
После установки откройте Codex и выполните команду /hooks, чтобы подтвердить доверие к новым записям. Пока вы этого не сделали, в «Подключениях» виден статус «Ждём подтверждения в Codex». Приложение никогда не подтверждает доверие за вас.
Cursor
Записи добавляются в файл ~/.cursor/hooks.json. Питомец показывает работу, «готово», ошибку и отмену.
У Cursor нет сигнала «нужен ввод», поэтому для Cursor питомец это состояние не показывает. Мы не изображаем его по таймеру или по другим событиям.
Любые программы
Для своих скриптов и программ есть консольный помощник pets-bridge. Путь к нему и готовые примеры для копирования — в «Подключениях», в разделе «Другие программы». Есть два способа:
pets-bridge runзапускает вашу команду, а питомец показывает работу, пока она идёт: «готово» при успехе и ошибку, если команда завершилась с ошибкой;pets-bridge emitотправляет отдельное событие — например, «работает» или «нужен ввод» — из любого места вашего скрипта.
Пример (вместо pets-bridge подставьте путь из настроек):
pets-bridge run --label "Сборка" -- npm run build
Помощник передаёт питомцу только тип события и короткие подписи. Сама команда и её вывод никуда не отправляются.
Пока не поддерживается
Cursor CLI, WSL, SSH и облачные агенты.
Если что-то не работает
- У статуса «Ошибка» есть код — назовите его поддержке.
- В настройках, на вкладке «Аккаунт», есть кнопка «Скопировать диагностику». В диагностике нет email, токенов, путей и имён проектов.