peon-ping CLI
Звуковые и экранные уведомления для агентов: голосовые реплики из игр, когда агент закончил задачу или ждет разрешения
- 5 113 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Скачивает наборы звуков и регистрирует хуки в конфигурации агента
- Устанавливается скриптом из сети и запускает команды оболочки
Установка
- Работает в
Ручная установка
brew install PeonPing/tap/peon-ping
peon-ping-setupmacOS и Linux. Команда setup регистрирует хуки и скачивает наборы звуков.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скачивает наборы звуков и регистрирует хуки в конфигурации агента
- Устанавливается скриптом из сети и запускает команды оболочки
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
peon-ping проигрывает голосовые реплики и показывает баннеры, когда агент завершает работу или запрашивает разрешение, чтобы не приходилось следить за терминалом. Инструмент цепляется к событиям агента через хуки: для Claude Code он встроенный, для остальных сред есть адаптеры, а события приводятся к общему формату. Наборы звуков берутся из игр вроде Warcraft, StarCraft, Portal и Zelda, их можно ставить, переключать, привязывать к каталогу проекта и делать свои. Управление идет через CLI peon: пауза, громкость, статус, ротация, установка пакетов, а также автозатихание при режиме не беспокоить. Отдельно есть MCP-сервер, через который агент сам выбирает звук вызовом инструмента, а не проигрывает фиксированный на каждое событие.
Для кого. Для разработчиков, которые запускают агента в терминале или IDE и не хотят вручную проверять, закончил ли он.
Подходит, если
- Хочется слышать сигнал, когда агент закончил или ждет разрешения
- Нужны уведомления сразу в нескольких агентах и IDE через единый механизм
- Хочется, чтобы агент сам выбирал звук события через MCP
- Нужны уведомления при удаленной работе по SSH или в devcontainer
Не подходит, если
- Звуковые и экранные уведомления в рабочем окружении не нужны
- Среда не поддерживает хуки и не подходит ни один адаптер
Пример запроса к агенту
Поставь peon-ping, чтобы Claude Code проигрывал звук, когда закончит или спросит разрешениеОграничения
Инструмент рассчитан на macOS, Linux, WSL2 и Windows, для каждой системы свои особенности воспроизведения звука. В WSL2 звук идет через Windows, а на Windows 11 24H2 и новее для пакетов в формате MP3 нужен ffmpeg. Часть команд CLI на Windows пока в статусе доработки. При установке инструмент скачивает наборы звуков и регистрирует хуки в конфигурации агента. MCP-серверу нужен Node.js 18 и выше.
Как отключить. Для временного отключения используйте peon toggle или peon pause. Для полного удаления запустите uninstall.sh или uninstall.ps1 из каталога хуков peon-ping.
Частые вопросы
С какими агентами работает?
Для Claude Code хук встроенный, для многих других сред и IDE есть адаптеры, которые приводят события к общему формату. Также работает с любым MCP-клиентом через встроенный MCP-сервер.
Можно временно выключить звук?
Да, командой peon toggle или peon pause, а также слэш-командой в Claude Code. Можно включить автозатихание при режиме не беспокоить.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыechook подает звук, тост или сообщение, когда Claude Code, Cursor или Codex закончили работу или ждут вашего разрешения
Голосовая надстройка поверх Claude Code, Codex и OpenCode: агент говорит и слушает, пока фоновые задачи выполняются параллельно
Звуковые сигналы для хуков кодинг-агентов: старт, ошибка, завершение и даже разные команды Bash звучат по-своему
Фоновая музыка для кодинг-агента: играет, пока агент работает, и затихает, когда он ждет вашего ответа.
Голосовое управление сессиями Claude Code и Codex на ваших машинах: агент на каждой машине связывает ее с облаком pitupitu.
Agent Notifications, плагин оповещений, показывает проект и ветку в сообщениях Claude Code и Codex для параллельных задач.
Коротко о README
README представляет peon-ping как инструмент звуковых и экранных уведомлений для агентов, которые сами не сообщают, что закончили или ждут разрешения. Он подключается через хуки: для Claude Code встроенно, для десятков других сред и IDE через адаптеры, приводящие события к общему стандарту. Есть наборы звуков из игр, управление через CLI peon, режим тренера, поддержка удаленной работы по SSH и в devcontainer, а также мобильные уведомления. Отдельно описан MCP-сервер, через который агент сам выбирает звук вызовом инструмента. Установка возможна через Homebrew, скрипт для macOS, Linux и WSL2, установщик для Windows, клонирование репозитория или Nix.