task-banner — скилл для Claude Code: уведомление о завершении задачи
Скилл task-banner показывает макос-баннер на рабочем столе, когда Claude Code заканчивает работу, с кратким описанием того, что было сделано. Баннер выглядит как большое окно поверх других приложений и не требует разрешений на уведомления.
MIT 126 установок ★ 750 обновлён 2026-10-21
npx skills add OpenClaudia/openclaudia-skills --skill task-banner -a claude-codeЧто делает task-banner
Скилл создаёт оверлей-окно через JXA-скрипт (mac-overlay.js), который работает даже когда macOS Notification Center блокирует стандартные уведомления из CLI. Баннер показывает одну строку текста, которую вы можете передать скиллу через файл /tmp/claude-banner-msg, или же по умолчанию выводит «Task done».
Установка требует трёх шагов: скопировать mac-overlay.js в ~/.claude/scripts/, добавить хук Stop в ~/.claude/settings.json и (опционально) дополнить инструкции агента строкой, которая пишет в /tmp/claude-banner-msg после каждой завершённой работы. Для отключения баннера достаточно создать пустой файл ~/.claude/banner.off.
Работает только на macOS, так как полагается на Cocoa API. Баннер можно настроить на разные цвета (синий, жёлтый, красный) и время автоматического закрытия.
Какие задачи решает
- показать уведомление о завершении задачи на macOS, когда Notification Center их не пускает
- увидеть, что именно Claude Code завершил, прямо с рабочего стола
- выключить баннер на время, не переустанавливая скилл
- передать информацию о результате работы в отдельное окно
Примеры запросов агенту
- Установи task-banner и напомни мне баннером, когда ты закончишь
- Выключи баннер на время, пока я работаю с другим приложением
- Показывай в баннере, какой файл я исправил или какую команду запустил
Как установить task-banner
1Через Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill task-banner -a claude-code2Вручную: положить файлы
~/.claude/skills/task-banner/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/task-banner/
1Через Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill task-banner -a codex2Вручную: положить файлы
.agents/skills/task-banner/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill task-banner -a cursor2Вручную: положить файлы
.cursor/skills/task-banner/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install OpenClaudia/openclaudia-skills skills/task-banner2Вручную: положить файлы
.github/skills/task-banner/SKILL.md1Через Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill task-banner -a gemini-cli2Командой платформы
gemini skills install https://github.com/OpenClaudia/openclaudia-skills --path skills/task-bannerВручную: положить файлы
.devin/skills/task-banner/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill task-banner -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о task-banner
Как установить task-banner в Claude Code?
Выполни команду npx skills add OpenClaudia/openclaudia-skills --skill task-banner -a claude-code, затем открой файл ~/.claude/skills/task-banner/SKILL.md для полной инструкции по настройке хука и скрипта.
Что делает task-banner?
Показывает баннер на macOS-рабочем столе каждый раз, когда Claude Code заканчивает задачу. Баннер содержит одну строку текста о том, что было сделано, и исчезает по клику или через установленное время.
Как отключить баннер, не переустанавливая скилл?
Выполни touch ~/.claude/banner.off — баннер будет отключен. Чтобы включить его обратно, удали файл командой rm -f ~/.claude/banner.off.
Исходный текст
SKILL.md · MIT
---
name: task-banner
description: Set up (or toggle) a macOS desktop banner that appears whenever Claude Code finishes a task, showing a one-line summary of what was done. Use when the user says "notify me when Claude is done", "desktop notification on completion", "set up the task banner", "mute the banner", or "unmute the banner".
---
# task-banner
Show a large, always-on-top desktop banner when Claude Code finishes a turn — with a one-line summary of what was actually completed. Works even when macOS Notification Center silently drops `osascript display notification` calls (a common problem: the CLI has no Notification Center registration, so the command exits 0 but nothing shows).
The banner is a borderless Cocoa overlay window drawn by `mac-overlay.js` (a JXA script adapted from [peon-ping](https://github.com/PeonPing/peon-ping)), so no notification permissions are needed.
## Requirements
- macOS (the overlay uses Cocoa via JXA / `osascript -l JavaScript`)
- Claude Code with hooks support
## Setup
1. Copy `mac-overlay.js` from this skill directory to `~/.claude/scripts/mac-overlay.js`.
2. Merge a `Stop` hook into `~/.claude/settings.json` (read the file first and preserve existing hooks):
```json
{
"hooks": {
"Stop": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "m=$(cat /tmp/claude-banner-msg 2>/dev/null); rm -f /tmp/claude-banner-msg; [ -f ~/.claude/banner.off ] || osascript -l JavaScript ~/.claude/scripts/mac-overlay.js \"${m:-Task done}\" blue \"\" 0 4 2>/dev/null || true",
"async": true
}
]
}
]
}
}
```
3. To make the banner show *what* was finished (instead of the generic "Task done"), add this to your global agent instructions file (`~/.claude/CLAUDE.md` or `AGENTS.md`):
> After finishing each task, write a short summary of what was completed to `/tmp/claude-banner-msg` (e.g. `printf 'Typecheck fixed and committed' > /tmp/claude-banner-msg`). Identify the actual task; never use a generic "task done".
The Stop hook displays the message and deletes the file. If the file is absent, it falls back to "Task done".
## Toggle (mute / unmute)
The hook checks a sentinel file — no config editing needed:
```bash
touch ~/.claude/banner.off # mute the banner
rm -f ~/.claude/banner.off # unmute
```
When the user asks to mute/unmute the banner, run the matching command and report the resulting state.
## How it works / notes
- `mac-overlay.js <message> <color> <icon> <slot> <dismiss_seconds>` — color is `blue`/`yellow`/`red`, dismiss `0` means persistent-until-click.
- The hook consumes `/tmp/claude-banner-msg` even while muted, so no stale summary pops up later when unmuted.
- On recent macOS the JXA bridge constant `NSTextAlignmentCenter` evaluates to the legacy AppKit value (2), which the unified runtime treats as right-aligned — the bundled script hardcodes alignment `1` (center) to compensate.
- `/tmp/claude-banner-msg` is shared across parallel Claude sessions; if two finish in the same instant one banner may show the other's summary. Use a per-session file path if that ever matters.
© OpenClaudia · MIT · OpenClaudia/openclaudia-skills