К основному содержанию
скилл CX Codex

task-banner — скилл для Claude Code: уведомление о завершении задачи

Скилл task-banner показывает макос-баннер на рабочем столе, когда Claude Code заканчивает работу, с кратким описанием того, что было сделано. Баннер выглядит как большое окно поверх других приложений и не требует разрешений на уведомления.

MIT 126 установок ★ 750 обновлён 2026-10-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add OpenClaudia/openclaudia-skills --skill task-banner -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/task-banner/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/task-banner/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
applescript martinholovsky Скилл для AppleScript и JXA: агент пишет и запускает скрипты автоматизации приложений macOS с проверкой опасных команд. CX Codex +1 315установок simple-notifications davila7 Хук simple-notifications для Claude Code отправляет системное уведомление, когда агент завершил работу или ждёт ввода. Срабатывает автоматически на macOS и Linux без лишних действий. 10 199установок xcodemcp lapfelix MCP-сервер xcodemcp для Claude Code управляет Xcode через JavaScript for Automation из интерфейса IDE. Запускает сборку проектов и разбирает ошибки компиляции на macOS. CX Codex +1 ★ 59звёзд репо c-notify daxaur Скилл c-notify отправляет нативные уведомления macOS через terminal-notifier по завершении задач агента. Пригодится при долгих сборках и тестах. CX Codex +1 ★ 179звёзд репо telegram-bot claude-office-skills Скилл telegram-bot для Claude Code и других платформ: чат-боты, уведомления, ИИ-ассистенты и автоматизация групп. Собирает обработчики сообщений и сценарии. CX Codex +1 6 500установок calendar-event-manager terrylica Скилл calendar-event-manager заводит события в macOS Calendar со звуковыми будильниками и парными напоминаниями в Reminders, чтобы встреча не прошла мимо. CX Codex +1 214установок

Из того же набора73

Весь набор →
github-stars Скилл github-stars показывает прирост звёзд репозитория в виде ASCII-графиков по дням и часам в любом часовом поясе. Нужен, чтобы отследить запуск, всплеск на Product Hunt или рост проекта в реальном времени. CX Codex +1 197установок organize-skills Скилл organize-skills для Claude Code проверяет библиотеку скиллов, переименовывает их в зависимости от продукта или бэкенда и чинит связанные ссылки. Приводит имена и связи в нескольких хабах в порядок. CX Codex +1 139установок ai-citations-report Скилл ai-citations-report для Claude Code строит GEO-отчёт по домену с запросами, в которых сайт цитируют Google AI Overview и ChatGPT. Проверяет AI-видимость и пробелы в контенте. CX Codex +1 136установок geo-analysis Скилл geo-analysis для Claude Code запускает GEO/SEO-анализ домена через API Enception и скачивает PDF-отчёт о видимости бренда в ИИ, рынке и конкурентах. Используется для клиентских аудитов. CX Codex +1 135установок geo-difficulty Скилл geo-difficulty оценивает, насколько сложно попасть в топ по запросу — учитывает авторитетность страниц конкурентов, присутствие в AI Overview Google и текущую позицию сайта. CX Codex +1 134установок marketing-slides Скилл marketing-slides пишет план питч-дека или колоды для продаж, а после вашего одобрения собирает слайды в ChatSlide. CX Codex +1 132установок gsc-portfolio-audit Скилл gsc-portfolio-audit для Claude Code, Codex и других платформ, который проводит аудит всех ресурсов в Google Search Console. Сравнивает клики, показы и ключевые слова между периодами для анализа портфолио. CX Codex +1 112установок wechat-moments Ранжирует и суммирует ленту WeChat Moments. Лента сортируется по весу событий и объему переписки с авторами. CX Codex +1 107установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой