Code-Notify CLI
Code-Notify присылает уведомление на рабочий стол, когда Claude Code, Codex или Gemini CLI закончили задачу или ждут вашего ответа
- 291 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Правит конфигурацию Claude Code, Codex и Gemini CLI: добавляет хуки, которые запускают скрипт на каждое событие агента
- Тексты уведомлений уходят в Slack или Discord, если включить вебхук
- Скрипт `postinstall` в npm-пакете при установке меняет пути хуков Claude на macOS и Linux
Установка
- Работает в
Ручная установка
npm install -g code-notifyРаботает на macOS, Linux и Windows. Затем `cn on all`, `cn test` и `cn status`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Правит конфигурацию Claude Code, Codex и Gemini CLI: добавляет хуки, которые запускают скрипт на каждое событие агента
- Тексты уведомлений уходят в Slack или Discord, если включить вебхук
- Скрипт `postinstall` в npm-пакете при установке меняет пути хуков Claude на macOS и Linux
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Code-Notify — консольная утилита `cn` (она же `code-notify`). Она подключается к хукам Claude Code, Codex, Gemini CLI и Oh My Pi и показывает системное уведомление, когда агент закончил работу или ждет ввода. Команда `cn on` включает уведомления для всех найденных инструментов, `cn on claude` для одного, `cnp on` для текущего проекта. По умолчанию сигнал приходит, когда агент простаивает и ждет ответа (`idle_prompt`). Командой `cn alerts` добавляют запросы разрешений, вопросы агента (`ask_user`) и завершение субагентов. К уведомлению подключают звук, голосовое объявление на macOS и Windows и дублирование в Slack или Discord через входящие вебхуки. Отдельная функция для macOS и Linux — оповещения о лимитах. Режим `cn usage setup --watch` следит за квотой Codex и Claude и сообщает при остатке 20 и 10 процентов. Перед сбросом недельного лимита приходят напоминания за 48, 24, 12, 6 и 2 часа и за 30 минут, расписание меняет `cn usage reset-reminders set 24,6,1`.
Для кого. Тем, кто запускает агентов в терминале или редакторе и работает в соседних окнах, пока идет долгая задача.
Подходит, если
- Долгая задача идет в Claude Code или Codex, а вы читаете почту или пишете код в другом окне
- Агент застрял на запросе разрешения, и простой стоит времени: тип `permission_prompt` шлет сигнал сразу
- Уведомления нужны только в одном проекте: `cnp on` включает их локально и не трогает остальные
- Статус задач хочется видеть в рабочем канале Slack или Discord через входящий вебхук
- Недельная квота Codex или Claude подходит к концу, и важно успеть до сброса лимита
Не подходит, если
- Запросы разрешений Codex нужны в уведомлениях: он отдает хуку только событие завершения
- Требуется контроль действий агента: утилита сообщает о событиях и ничего не блокирует
- Оповещения о лимитах нужны на Windows: режим `cn usage` работает на macOS и Linux, включая WSL
- Голосовое объявление нужно на Linux: оно есть только на macOS и Windows
Пример запроса к агенту
Поставь Code-Notify, включи уведомления для Claude Code и Codex и убедись командой cn test, что на рабочем столе появляется сообщение.Ограничения
- Codex отдает хуку только событие завершения, поэтому запросы разрешений и `request_permissions` от Codex уведомлениями не приходят.
- Оповещения о лимитах работают на macOS и Linux, включая WSL, и включаются отдельно командой `cn usage setup --watch`.
- Голосовые объявления доступны на macOS и Windows.
- Установка правит конфигурацию агентов: `~/.claude/settings.json`, `~/.codex/config.toml`, `~/.gemini/settings.json`. Скрипт `postinstall` в npm-пакете на macOS и Linux тихо чинит устаревшие пути хуков Claude.
Как отключить. Команда `cn off` отключает уведомления у всех инструментов, `cn off claude` у одного. Саму утилиту удаляют тем менеджером пакетов, которым ставили: npm или Homebrew.
Частые вопросы
Как включить уведомления для Claude Code и Codex?
Установите пакет командой `npm install -g code-notify` и выполните `cn on`: утилита найдет установленные инструменты и пропишет хуки. Команда `cn test` покажет тестовое уведомление, а `cn status` перечислит включенные инструменты.
Приходят ли уведомления о запросах разрешений?
В Claude Code да, если добавить тип командой `cn alerts add permission_prompt`. В Codex нет: он отдает хуку только событие завершения.
Можно ли получать сообщения в Slack или Discord?
Да, через входящие вебхуки. Доставку настраивает команда `cn channels`, события дублируются в выбранный канал.
Как проверить, что хуки включены?
Команда `cn status` показывает включенные инструменты, `cn test` отправляет тестовое уведомление. Хуки от старой раскладки claude-notify поддерживаемые обновления чинят автоматически.
Какие события можно включить?
По умолчанию сигнал приходит при простое агента (`idle_prompt`). Команда `cn alerts` показывает текущие настройки, а `cn alerts add` добавляет `permission_prompt`, `ask_user` и `SubagentStop`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыХуки для Claude Code на macOS: уведомление возвращает в прежнее окно терминала, а при простое приходит push на телефон.
Agent Notifications, плагин оповещений, показывает проект и ветку в сообщениях Claude Code и Codex для параллельных задач.
Звуковые сигналы для хуков кодинг-агентов: старт, ошибка, завершение и даже разные команды Bash звучат по-своему
Монитор лимитов и расхода токенов для Claude Code, Codex, Antigravity и Grok CLI: меню macOS, трей Windows, отчеты в HTML
Трей-приложение для Windows и Linux показывает лимиты Claude и отдает остаток квоты агенту через встроенный MCP-сервер.
CodeKanban собирает терминалы и сессии Claude Code и Codex на одной странице, а codekanban-cli управляет ими из агента
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Code-Notify (эта карточка) | нет | 291 | |
| peon-ping | нет | 5 108 | озвучка событий голосовыми репликами из игр, без дублирования в Slack и без напоминаний о лимитах |
| Agent Notifications | нет | 826 | плагин, который добавляет проект и ветку в сообщения Claude Code и Codex для параллельных задач |
Коротко о README
README открывается ссылками на загрузки, Homebrew и npm, затем описывает новую возможность, напоминания о сбросе лимитов, и возможности утилиты. Дальше идут установка для людей и готовый блок для ИИ-агентов, таблица команд, схема работы через хуки, типы оповещений и настройки звука, голоса и каналов.