claude-pager — плагин для Claude Code: уведомления и установка
Плагин claude-pager показывает уведомления на рабочем столе, когда Claude Code ждёт разрешения, ввода или завершил задачу. Удобен для долгих сессий.
MIT ★ 3 785 обновлён 2026-10-25
/plugin marketplace add davepoon/buildwithclaude
/plugin install claude-pager@buildwithclaudeЧто делает claude-pager
claude-pager отправляет уведомления о трёх событиях: запросе разрешения на инструмент, ожидании ввода и завершении задачи. В заголовок уведомления попадает имя проекта, поэтому проще понять, какую сессию открыть.
Плагин поддерживает звуки для каждого события: default, blow, funk, glass, ping, pop, hero или none. Типы уведомлений и звуки настраиваются через pluginConfigs в ~/.claude/settings.json. На Linux без пакета libnotify и команды notify-send рабочие уведомления не появятся.
На macOS используются terminal-notifier или osascript, на Linux — notify-send, на Windows — уведомления PowerShell. В headless-сессии или через SSH плагин выводит строку в stdout и подаёт сигнал терминала. Требуется Claude Code v2.1.0+; Node.js поставляется вместе с ним.
Какие задачи решает
- получить сигнал о запросе разрешения
- узнать, что Claude Code ждёт ввода
- отследить завершение задачи в другой сессии
- различать проекты по заголовку уведомления
Примеры запросов агенту
- Запусти задачу и запроси разрешение перед изменением файлов.
- Дождись завершения текущей задачи и сообщи итог.
- Остановись и жди моего ответа перед следующим шагом.
Как установить claude-pager
Через маркетплейс плагинов
/plugin marketplace add davepoon/buildwithclaude/plugin install claude-pager@buildwithclaudeПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о claude-pager
Как установить claude-pager в Claude Code?
Выполните /plugin marketplace add davepoon/buildwithclaude и затем /plugin install claude-pager@buildwithclaude.
Что делает claude-pager?
Плагин показывает уведомления, когда Claude Code просит разрешение, ждёт ввод или завершает задачу. Имя проекта отображается в заголовке.
Что нужно для уведомлений на Linux?
Для уведомлений рабочего стола нужен пакет libnotify и команда notify-send. В headless-режиме плагин использует stdout и сигнал терминала.
Исходный текст
claude-pager · MIT
<h1 align="center"><img src="https://i.ibb.co/jPRMBm30/icon.jpg" alt="claude-pager icon" width="36" height="36" align="center"> Claude Pager</h1>
<p align="center">Native desktop notifications for Claude Code. Get alerted when a session needs your attention — permission prompts, idle waits, or task completion.</p>
## Install
```bash
git clone https://github.com/bharat7gupta/claude-pager.git
claude --plugin-dir ./claude-pager
```
## What It Does
Each notification shows your **project name** in the title so you know which session to switch to.
### Permission — Claude needs tool approval
<img src="https://i.ibb.co/QFRXF8w8/permission.webp" alt="Permission notification" width="500">
### Idle — Claude is waiting for your input
<img src="https://i.ibb.co/nNxn5GzD/idle.png" alt="Idle notification" width="500">
### Task Completion — Claude finished working
<img src="https://i.ibb.co/WNTYt00M/task-completion.webp" alt="Task completion notification" width="500">
<img src="https://i.ibb.co/Jw5xWwCX/task-completion-2.jpg" alt="Task completion notification with summary" width="500">
## Configuration
After install, configure via `pluginConfigs` in `~/.claude/settings.json`:
```json
{
"pluginConfigs": {
"claude-pager": {
"options": {
"idle_enabled": "on",
"permission_enabled": "on",
"completion_enabled": "on",
"idle_sound": "default",
"permission_sound": "default",
"completion_sound": "default"
}
}
}
}
```
### Toggle Events
Set any `*_enabled` to `"off"` to disable that notification type.
### Sound Presets
| Preset | Description |
|---|---|
| `default` | Per-event default (idle=blow, permission=funk, completion=glass) |
| `blow` | Warm, noticeable |
| `funk` | Short, attention-grabbing |
| `glass` | Satisfying ding |
| `ping` | Subtle ping |
| `pop` | Quick pop |
| `hero` | Bold alert |
| `none` | Silent — visual notification only |
## Platform Support
| Platform | Notification | Sound | Notes |
|---|---|---|---|
| **macOS** | `terminal-notifier` or `osascript` | `afplay` | Works out of the box. `brew install terminal-notifier` for clickable notifications |
| **Linux** | `notify-send` | `paplay` / `aplay` | Requires `libnotify` package |
| **Windows** | PowerShell NotifyIcon balloon | PowerShell SystemSounds | Optional: install `BurntToast` module for modern toasts |
### Headless / SSH
When no desktop is available, falls back to a stdout line + terminal bell. No errors.
## Requirements
- Claude Code v2.1.0+
- Node.js (ships with Claude Code)
- Linux: `libnotify` / `notify-send` for desktop notifications
## License
MIT
© Bharat Gupta · MIT · davepoon/buildwithclaude