Перейти к содержимому
Помощь

Подключение агентов

Как подключить Claude Code, Codex, Cursor и свои программы, чтобы питомец показывал их работу.

Питомец показывает, что делает агент: работает, ждёт вас, закончил или ошибся. Подключения бесплатны для всех, в том числе с бесплатным питомцем.

Как подключить

  1. Откройте настройки приложения, вкладку «Подключения».
  2. Выберите агента. Приложение покажет файл настроек агента и точный фрагмент, который в него добавит.
  3. Нажмите «Установить». Перед изменением приложение сохраняет копию файла рядом с ним (<файл>.pets-backup-<время>) и добавляет только свои записи. Чужие настройки остаются как были.
  4. Для проверки нажмите «Тест»: питомец покажет демонстрацию. Такие события отмечены как «Демонстрация».

Статус «Работает» появляется только после настоящего события от агента. Удаление подключения снимает только записи приложения — ваши правки и чужие записи остаются.

Питомец ничего не одобряет и не отвечает агенту за вас. Он только показывает состояние и не задерживает работу агента.

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, токенов, путей и имён проектов.