# agent-notifications

The agent-notifications Claude Code skill sends desktop alerts during an agent’s work. It acts on user questions, blockers, and meaningful milestones.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · ★ 835 repo stars
- Author: 777genius
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/777genius/agent-notifications/tree/HEAD/skills/agent-notifications/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/agent-notifications

## What it does

The skill calls Agent Notifications plugin tools to send an alert while work is underway. It uses `attention` for a request that needs a reply, `progress` for an intermediate milestone, and `info` for an informational update.

It searches for `notify` and `notification_status` before treating either tool as unavailable, then checks the notification status. It avoids duplicating completion hooks and native approval prompts in Codex Desktop. The plugin and notification permissions must be configured first.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add 777genius/agent-notifications --skill agent-notifications -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/agent-notifications/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/agent-notifications/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add 777genius/agent-notifications --skill agent-notifications -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/agent-notifications/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add 777genius/agent-notifications --skill agent-notifications -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/agent-notifications/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install 777genius/agent-notifications skills/agent-notifications
```

2. **Manually: put the files in place**
- File: `.github/skills/agent-notifications/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add 777genius/agent-notifications --skill agent-notifications -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/777genius/agent-notifications --path skills/agent-notifications
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/agent-notifications/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add 777genius/agent-notifications --skill agent-notifications -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/777genius/agent-notifications/tree/HEAD/skills/agent-notifications/SKILL.md

## When to use it
- alert the user when a blocker needs their input
- ask a question while an agent is working
- send an update about an intermediate milestone

## Example prompts
- Send me a desktop alert when you need my answer.
- Notify me if work pauses because of a blocker.
- Send an alert when you reach an important milestone.

## Similar
- [setting-up-cloudwatch-alarm-notifications](https://affpapa.org/en/nevibecode/skills/setting-up-cloudwatch-alarm-notifications.md) — skill · 7200 installs
- [push-notifications](https://affpapa.org/en/nevibecode/skills/push-notifications.md) — skill · 4500 installs
- [capacitor-push-notifications](https://affpapa.org/en/nevibecode/skills/capawesome-team-capacitor-push-notifications.md) — skill · 1600 installs
- [notifications-and-recovery](https://affpapa.org/en/nevibecode/skills/notifications-and-recovery.md) — skill · 1000 installs
- [configure-notifications](https://affpapa.org/en/nevibecode/skills/configure-notifications.md) — skill · 850 installs
- [syncfusion-react-notifications](https://affpapa.org/en/nevibecode/skills/syncfusion-react-notifications.md) — skill · 690 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
