peon-ping
- title
- peon-ping
- type
- toolbox
- summary
- Реплики батрака из Warcraft как звуковые уведомления через хуки для Claude Code и других агентов
- tags
- shell, audio-notifications, claude-code, mcp, ai-agents
- homepage
- https://www.peonping.com
- language
- Shell
- license
- MIT
- created
- 2026-05-02
- updated
- 2026-05-02
- lang
- ru
- translation_of
- peon-ping
- source_updated
- 2026-05-02
- translated
- 2026-09-01
- translator
- lllm/antigravity/gemini-3.7-flash-medium
Звуковые уведомления для ИИ-агентов написания кода - когда Claude Code заканчивает задачу, запрашивает разрешение или сталкивается с ошибкой, звучит реплика батрака (Peon) из Warcraft III ("Работать, работать.", "Нужно что-то сделать?", "Работа сделана!"). Решает проблему в духе "переключился из терминала и на десять минут пропустил запрос на подтверждение" предельно простым механизмом: узнаваемым звуком. На сайте заявляется, что peon-ping вдохновил VS Code добавить нативные звуковые хуки для своих 50+ миллионов пользователей (в качестве источника приводится ссылка на пост Pierce Boggan в X).
Изначально - один bash-скрипт и несколько .wav-файлов. С тех пор проект разросся в небольшую экосистему: 160+ звуковых наборов на 14 языках, MCP-сервер, позволяющий агенту самому выбирать звук, режим напоминания о тренировках (Peon Trainer) и отдельный репозиторий с виртуальным питомцем на Three.js (peon-pet), где анимированный орк реагирует на события в Claude Code.
Установка
brew install PeonPing/tap/peon-ping
# or
curl -fsSL peonping.com/install | bash
Работает на macOS, Linux и WSL2. На главной странице сайта есть интерактивный конструктор команды установки: отмечаете нужные звуковые наборы, и команда с curl обновляется на лету.
Как устроена интеграция
Хуки, а не обёртки. Штатная система хуков агента вызывает peon-ping <category> в нужные моменты: greeting при старте сессии, acknowledge при вызове инструмента, complete при остановке, error при ошибке, annoyed при повторяющихся запросах подтверждения. В README перечислены адаптеры для Claude Code, Codex, Cursor, OpenCode, Kiro, Windsurf, Antigravity, Rovo Dev CLI "и любой IDE с поддержкой хуков".
Режим MCP-сервера устроен интереснее: вместо того чтобы harness запускал хук, сам агент вызывает play_sound через MCP и выбирает реплику с учётом того, что он только что сделал. Благодаря этому звук становится частью рассуждений агента, а не пассивным уведомлением.
Другие возможности
- Громкость: от 0.0 до 1.0 в конфиге (чтобы не мешать в офисе)
- Без повторов: запоминает последний трек в категории, поэтому одна и та же реплика не проигрывается дважды подряд
- Переключатели категорий: раздельное включение и отключение greeting / acknowledge / complete / error / annoyed
- Заголовки вкладок: вкладка терминала показывает название проекта и статус с точкой по завершении
- Уведомления на рабочем столе: push-оповещения, когда терминал не в фокусе
- Система наборов: 160+ наборов на 14 языках; инструменты для авторов наборов на openpeon.com/create
Peon Trainer
Возможность из версии 2.0, превращающая ту же поверхность хуков в фитнес-тренера: 300 отжиманий и 300 приседаний в день под ворчание батрака. При старте сессии звучит "Pushups first, code second!", слэш-навык для Claude Code (/peon-ping-log 25 pushups) записывает повторения прямо в сессии, а периодические напоминания раз в ~20 минут становятся настойчивее, если вы ленитесь. По достижении дневной нормы батрак радуется и перестаёт донимать до завтра. Может работать автономно через peon trainer on.
peon-pet
Отдельный репозиторий: github.com/PeonPing/peon-pet. macOS, Electron + Three.js. Анимированный орк сидит в углу экрана и реагирует на каждое событие Claude Code: спит во время простоя, просыпается при активности, печатает вместе с агентом, празднует по завершении. Точки сессий показывают каждое активное окно Claude Code. Открытый исходный код. Чисто настольный компаньон для настроения; никакой дополнительной функциональности сверх возможностей peon-ping не добавляет.
Зачем это нужно
Большинство инструментов на базе хуков для ИИ-кодинга пытаются сделать агента более автономным (charlie-daemons, botctl и т. д. - см. charlie-daemons / botctl). peon-ping идёт противоположным путём: проект опирается на модель с контролем со стороны человека, где разработчик следит за агентом и просто хочет получать понятные сигналы обратной связи, когда требуется внимание. Это перекликается с разделением [[agents-vs-daemons]]: peon-ping целиком на стороне агентов, запускаемых человеком, и стремится сделать этот паттерн менее утомительным, а не заменить его.
Голоса персонажей также воспринимаются гораздо легче обычных звонков и зуммеров. Звуки достаточно различимы, чтобы обратить на них внимание, достаточно коротки, чтобы не мешать после привыкания, а несколько вариантов реплик на каждую категорию не дают мозгу отключить восприятие.
Репозиторий
github.com/PeonPing/peon-ping - 4.6k звёзд, MIT, в основном Shell, репозиторий создан 2026-02-09, последний push 2026-05-01. Проекту три месяца, активен.