Claudio CLI
Звуковые сигналы для хуков кодинг-агентов: старт, ошибка, завершение и даже разные команды Bash звучат по-своему
- 120 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Установка дописывает хуки в файлы настроек агентов и запускает бинарный файл на каждое событие.
- Учет звуков пишет локальную базу в каталоге кеша.
Установка
- Работает в
Ручная установка
go install claudio.click/cmd/claudio@latestСборка из исходников требует Go 1.25.13 или новее; готовый бинарный файл можно скачать из релизов GitHub. Затем `claudio install` ставит хуки.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Установка дописывает хуки в файлы настроек агентов и запускает бинарный файл на каждое событие.
- Учет звуков пишет локальную базу в каталоге кеша.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Claudio слушает события хуков Claude Code, Codex CLI, Gemini CLI, Qwen Code, GitHub Copilot CLI, Command Code и OpenCode и проигрывает подходящий звук, не заставляя агента ждать конца воспроизведения. Свои звуки получают запуск и успех инструмента, ошибка, ввод запроса, уведомление, завершение, сжатие контекста, старт сессии и события субагентов. Команды Bash разбираются по составу: `git commit`, `npm test` и `go build` озвучиваются по-разному. Звуковые наборы бывают трех видов: папка, JSON-карта и git-репозиторий, подключаемый через `claudio soundpack add`. Формат файлов: WAV, MP3, AIFF.
Для кого. Разработчикам, которые запускают долгие задачи агента в фоне и хотят узнавать о ходе работы на слух.
Подходит, если
- Агент работает в соседнем окне, а о завершении или ошибке нужно узнать сразу.
- Разные инструменты и команды Bash должны звучать по-разному.
- Один набор звуков нужен сразу в Claude Code и Codex.
- Агент запущен по SSH, и звук надо вывести на локальную машину через PulseAudio.
Не подходит, если
- Работа идет в общем помещении, где звуки мешают.
- Хуки агента уже заняты другим инструментом, и менять их нельзя.
- Сервер без звукового устройства и без проброса PulseAudio.
Пример запроса к агенту
Поставь Claudio, подключи хуки для Claude Code и поставь громкость 0.4.Ограничения
Команда `claudio install` правит файлы настроек агентов, для Claude Code это `~/.claude/settings.json` или каталог из `CLAUDE_CONFIG_DIR`; перед установкой стоит сделать копию. После установки хуков в Codex нужно выполнить `/hooks` и подтвердить хук Claudio. У OpenCode нет хуков в настройках, поэтому Claudio пишет плагин в `~/.config/opencode/plugins/claudio.js`. Учет звуков включен по умолчанию и пишет данные в локальную базу SQLite. На удаленной машине без звука Claudio молчит.
Как отключить. Выполните `claudio uninstall --agent all --scope global`, затем удалите бинарный файл. Для тишины без удаления хватит `claudio mute`.
Частые вопросы
Как подключить Claudio только к одному агенту?
Укажите агента флагом: `claudio install --agent codex --scope global`. Без флага `claudio install` сам находит все поддерживаемые агенты и ставит хуки для них.
Как заменить стандартные звуки на свои?
Соберите набор: `claudio soundpack init my-pack --from-platform`, положите файлы WAV, MP3 или AIFF и установите через `claudio soundpack install ./my-pack.json --default`.
Как узнать, каких звуков не хватает набору?
`claudio analyze missing --preset last-week` показывает пропущенные варианты за неделю, `claudio analyze usage` дает сводку по используемым звукам.
Какие агенты поддерживает Claudio?
Claude Code, Codex CLI, Gemini CLI, Qwen Code, GitHub Copilot CLI, Command Code и OpenCode.
Как временно отключить звук?
Выполните `claudio mute`, вернуть звук можно командой `claudio unmute`. Громкость меняет `claudio volume 0.4`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛокальный голосовой слой для Claude Code и Codex на macOS: когда агент закончил работу или упал, коротко говорит, что случилось
Code-Notify присылает уведомление на рабочий стол, когда Claude Code, Codex или Gemini CLI закончили задачу или ждут вашего ответа
Звуковые и экранные уведомления для агентов: голосовые реплики из игр, когда агент закончил задачу или ждет разрешения
Claude Code Toolkit (robertguss)
Claude Code Toolkit
Набор скиллов и хуков для Claude Code: брейншторм, ведение проекта воркерами, вики, конвейер книги.
Голосовое управление сессиями Claude Code и Codex на ваших машинах: агент на каждой машине связывает ее с облаком pitupitu.
Agent Standup показывает сессии Claude Code, Codex и Mistral Vibe как живой созвон команды: кто работает, кто ждет.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Claudio (эта карточка) | нет | 120 | |
| peon-ping | нет | 5 108 | Claudio озвучивает больше событий и разбирает команды Bash, наборы бывают папкой, JSON или git-репозиторием |
| Claude Code Hooks (voice) | нет | 567 | там хуки отвечают голосом; Claudio проигрывает звуковые файлы и работает с семью агентами |
Коротко о README
Готовые бинарные файлы лежат в релизах GitHub и включают звуковой бэкенд, компилятор C не нужен. Установку хуков, громкость и отключение звука задают отдельными командами.