Heard CLI
Локальный голосовой слой для Claude Code и Codex на macOS: когда агент закончил работу или упал, коротко говорит, что случилось
- 218 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Прописывает хуки в настройки Claude Code и Codex, поэтому видит события каждого вызова инструмента
- Текст пересказов уходит в ElevenLabs или Speechify, если подключены их ключи, и в Anthropic при вызове claude -p
- Продуктовая аналитика включена по умолчанию, текст озвучки и исходный код в нее не попадают
Установка
- Работает в
Ручная установка
git clone https://github.com/heardlabs/heard.git && cd heard && python3 -m venv .venv && source .venv/bin/activate && pip install -e .Сборка из исходников на macOS. Закрытое приложение Heard скачивается отдельно с сайта heard.dev.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Прописывает хуки в настройки Claude Code и Codex, поэтому видит события каждого вызова инструмента
- Текст пересказов уходит в ElevenLabs или Speechify, если подключены их ключи, и в Anthropic при вызове claude -p
- Продуктовая аналитика включена по умолчанию, текст озвучки и исходный код в нее не попадают
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Heard ставится из исходников как Python-пакет и озвучивает работу ИИ-агента на macOS. Команда heard install claude-code прописывает хуки Stop, PreToolUse, PostToolUse и UserPromptSubmit в ~/.claude/settings.json, а heard install codex делает то же для Codex CLI в ~/.codex/hooks.json. Сессии приложения Codex Heard тоже отслеживает. Хуки возвращают управление сразу, поэтому агент не ждет конца фразы. Ответ целиком Heard не зачитывает. По контексту он выбирает, что сказать: что запустилось, нужно ли ваше решение, что вы уже слышали. Режим Co-pilot дает короткие вехи для работы за экраном, Companion — подробные доклады, когда заняты руки, Focus молчит до вопроса, сбоя или блокировки. Если сессий несколько, голос получает самая важная, остальные пересказываются кратко, а при смене говорящего фраза начинается с названия сессии. Голос синтезирует Kokoro на самом Mac после разовой загрузки модели командой heard download-voice, это около 350 МБ. Вместо него можно подключить ключ ElevenLabs или Speechify, а для связных пересказов ключ Anthropic: без него фразы собираются из шаблонов и текста агента. Манеру речи задают персоны aria, friday, jarvis и atlas, свою добавляет Markdown-файл в ~/Library/Application Support/heard/personas/. Команда heard run подключает к озвучке любой другой CLI.
Для кого. Разработчикам на macOS, которые запускают Claude Code или Codex на долгие задачи и отходят от экрана, пока агент работает.
Подходит, если
- Агент работает над рефакторингом, а вы отошли: голос скажет, что тесты прошли, и задаст вопрос по миграции
- Параллельно идут несколько сессий Claude Code и Codex, и нужно знать, какая из них ждет вашего ответа
- Озвучка нужна без аккаунта и ключей: Kokoro работает на самом Mac
- Звукового сигнала мало, хочется услышать, что сделал агент и чем закончил
- Для каждого проекта нужен свой голос: параметр multi_agent_auto_voices в config.yaml раздает голоса ElevenLabs
Не подходит, если
- Работа идет на Linux или Windows: движок рассчитан на macOS
- Нужен голосовой ввод: режим push to talk, диктовка и ответы голосом есть в закрытом приложении Heard на тарифе Power, а движок из репозитория только говорит
- Агенты живут в облаке, например Devin или Manus: коннекторы к ним входят в приложение
- Хватает баннера или стандартного звука: для этого проще поставить отдельный хук уведомлений
Пример запроса к агенту
Поставь Heard из репозитория, скачай локальный голос Kokoro и подключи озвучку к Claude Code, чтобы я слышал итог каждой задачиОграничения
- Работает только на macOS. Репозиторий содержит движок с открытым кодом под Apache 2.0, а скачиваемое приложение Heard 2.0 — закрытая сборка с облачными голосами и платным тарифом Power.
- Голос Kokoro требует разовой загрузки модели около 350 МБ.
- Движок говорит, но не слушает. Голосовой ввод, помощник Parrot и коннекторы облачных агентов входят только в приложение.
- Если установлена команда claude, движок может отправлять активность агента в Anthropic через claude -p с вашим входом. Продуктовая аналитика включена по умолчанию, отключается параметром product_analytics: false.
Как отключить. Хуки лежат в ~/.claude/settings.json и ~/.codex/hooks.json. Удалите оттуда записи heard, и агенты перестанут обращаться к демону Heard. Паузу на ходу ставит сочетание Shift, Option и точка, возобновляет Shift, Option и запятая. Папку клона и виртуальное окружение можно удалить вручную.
Частые вопросы
Чем Heard отличается от звукового сигнала или хука с командой say?
Сигнал сообщает, что что-то произошло, Heard называет суть. Например: «Тесты прошли, есть вопрос по миграции». При нескольких сессиях рутинные шаги склеиваются в краткие итоги, а вопросы и сбои звучат первыми.
Как получать голосовые уведомления от Codex?
Выполните heard install codex. Heard запишет хуки в ~/.codex/hooks.json и начнет следить за сессиями приложения Codex. Тот же движок обслуживает Claude Code, поэтому один голос покрывает обоих агентов.
Уходит ли вывод агента с компьютера?
Зависит от настроек. Kokoro синтезирует речь локально. ElevenLabs и Speechify получают произносимый текст по HTTPS. Для пересказов движок использует ваш ключ Anthropic или шаблоны, а при установленной команде claude может вызвать claude -p. В аналитику текст озвучки и исходный код не попадают.
Замедлит ли озвучка работу агента?
Нет. Хуки передают событие демону и сразу возвращают управление, а речь синтезируется и воспроизводится отдельно.
Сколько стоит озвучка через ElevenLabs?
Для легкого ежедневного использования хватает бесплатного тарифа. Тяжелый день парного программирования на тарифе Starter, по оценке автора, обходится от нескольких центов до нескольких десятков центов. Kokoro бесплатен и ставит жесткий потолок расходов.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЗвуковые сигналы для хуков кодинг-агентов: старт, ошибка, завершение и даже разные команды Bash звучат по-своему
Голосовая надстройка поверх Claude Code, Codex и OpenCode: агент говорит и слушает, пока фоновые задачи выполняются параллельно
MCP-сервер для голосового разговора с Claude Code и другими MCP-агентами: распознавание речи и синтез голоса, локально или через облако
Голосовое управление сессиями Claude Code и Codex на ваших машинах: агент на каждой машине связывает ее с облаком pitupitu.
Code-Notify присылает уведомление на рабочий стол, когда Claude Code, Codex или Gemini CLI закончили задачу или ждут вашего ответа
Agent Standup показывает сессии Claude Code, Codex и Mistral Vibe как живой созвон команды: кто работает, кто ждет.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Heard (эта карточка) | нет | 218 | ||
| VoiceMode | да | не нужна | 1 439 | двусторонний голосовой разговор с агентом через MCP, а не озвучка его итогов хуками |
| Code-Notify | нет | 291 | уведомление на рабочем столе о конце задачи, без пересказа сделанного |
Коротко о README
Главная страница отвечает на вопрос, что такое голосовой слой, и противопоставляет Heard команде /voice в Claude Code, которая отвечает только за ввод. Дальше описаны режимы прослушивания, персоны, работа с несколькими агентами и перечень того, что уходит с машины. Платные функции приложения вынесены в отдельные блоки, а сборка из исходников описана в разделе Self-host.