simple-notifications — хук для Claude Code: что делает и установка
Отправляет системные оповещения в macOS и Linux, когда Claude Code завершает задачу или ожидает ввода от пользователя.
npx claude-code-templates@latest --hook automation/simple-notificationsЧто делает simple-notifications
Хук отслеживает два события в Claude Code: Stop и Notification. При завершении задачи он показывает системное уведомление о финише работы. Когда Claude Code ждёт ответа, хук запрашивает внимание пользователя. События срабатывают автоматически.
Внутри запускаются шелл-команды, которые проверяют окружение. На macOS вывод выполняется через osascript, причём запрос ввода сопровождается звуковым сигналом Ping. В Linux используется вызов notify-send. При этом запросу ввода назначен флаг -u critical.
Без утилиты notify-send в Linux или osascript на macOS вызовы завершатся вхолостую, потому что другие каналы оповещений в коде не предусмотрены. Параметры хуков сохраняются в конфигурационный файл .claude/settings.json.
Какие задачи решает
- получать всплывающее уведомление, когда Claude Code заканчивает выполнение
- слышать звуковой сигнал Ping при запросе ввода на macOS
- отправлять срочное оповещение через
notify-sendс флагом-u criticalв Linux
Примеры запросов агенту
- Выполни полный прогон тестов и дай знать, когда завершишь
- Проанализируй зависимости проекта и запроси моё подтверждение перед обновлением
Как установить simple-notifications
1Через claude-code-templates
npx claude-code-templates@latest --hook automation/simple-notifications2Вручную: положить файлы
.claude/settings.jsonБлок hooks: событие (PreToolUse, PostToolUse, Stop…) → команда. Личные — ~/.claude/settings.json
По шагам, с командами для каждой платформы: Хуки Claude Code: что это, где настраивать и как запретить опасную команду
Вопросы о simple-notifications
Как установить simple-notifications в Claude Code?
Выполните команду npx claude-code-templates@latest --hook automation/simple-notifications. Она добавит настройки хука в файл .claude/settings.json.
Что делает хук simple-notifications?
Он отправляет системные оповещения на рабочий стол в macOS и Linux, когда Claude Code завершает работу или требует внимания пользователя.
Какие системные утилиты нужны для работы хука?
В macOS хук вызывает osascript со звуком Ping. В Linux требуется наличие утилиты notify-send для вывода уведомлений.
Исходный текст
simple-notifications.json · MIT
{
"description": "Send desktop notifications when Claude Code finishes working or needs user input. Works on macOS and Linux systems.",
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "if command -v osascript >/dev/null 2>&1; then osascript -e 'display notification \"Claude has finished working\" with title \"Claude Code\"'; elif command -v notify-send >/dev/null 2>&1; then notify-send 'Claude Code' \"Claude has finished working\"; fi"
}
]
}
],
"Notification": [
{
"hooks": [
{
"type": "command",
"command": "if command -v osascript >/dev/null 2>&1; then osascript -e 'display notification \"Claude needs your input\" with title \"Claude Code\" sound name \"Ping\"'; elif command -v notify-send >/dev/null 2>&1; then notify-send -u critical 'Claude Code' \"Claude needs your input\"; fi"
}
]
}
]
}
}
© davila7 · MIT · davila7/claude-code-templates
