agent-notifications

Name: agent-notifications
Author: 777genius

Verified

🔔 Cross-platform smart notifications for Claude and Codex. Desktop alerts, sounds, click-to-focus, and webhooks on macOS, Linux, and Windows.

806stars

108forks

Installation

# Add to your Claude Code skills
git clone https://github.com/777genius/agent-notifications

Getting Started

Guides for using ai agents skills like agent-notifications.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 9/10/2026

{
  "issues": [
    {
      "file": "README.md",
      "line": 71,
      "type": "remote-install",
      "message": "Install command (remote install script piped to a shell — review the source before running): \"curl -fsSL https://raw.githubusercontent.com/777genius/agent-notifications/main/\"",
      "severity": "low"
    },
    {
      "file": "README.md",
      "line": 235,
      "type": "dangerous-command",
      "message": "Dangerous command (disables permission prompts): \"bypassPermissions\"",
      "severity": "medium"
    }
  ],
  "status": "PASSED",
  "scannedAt": "2026-09-10T08:40:32.493Z",
  "npmAuditRan": true,
  "pipAuditRan": true,
  "promptInjectionRan": true
}

README.md

Frequently Asked Questions

What is agent-notifications?

agent-notifications is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by 777genius. 🔔 Cross-platform smart notifications for Claude and Codex. Desktop alerts, sounds, click-to-focus, and webhooks on macOS, Linux, and Windows. It has 806 GitHub stars.

Is agent-notifications safe to use?

Yes. agent-notifications passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install agent-notifications?

Clone the repository with "git clone https://github.com/777genius/agent-notifications" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is agent-notifications written in?

agent-notifications is primarily written in Go. It is open-source under 777genius on GitHub, so you can review or fork the full source.

Are there alternatives to agent-notifications?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh agent-notifications against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

255,402

Clauge digital-marketing-pro

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.

Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.

Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

Read the Terms of Service

Notifications for Claude Code and Codex CLI (beta), with sounds, git branch display, and webhook integrations. See Codex support and limitations for differences between products.

Boost your productivity — check out the advanced task manager for Claude with a convenient UI, from the creator of this plugin.

Features
Installation
Supported Notification Types
Codex CLI Support (beta)
Platform Support
- Click-to-Focus (macOS & Linux)
Configuration
Manual Testing
Contributing
Troubleshooting
Documentation
License

Features

Cross-platform: macOS (Intel & Apple Silicon), Linux (x64 & ARM64), Windows 10+ (x64)
Claude notification types: Task Complete, Review Complete, Question, Plan Ready, Session Limit, API Error
Click-to-focus (macOS, Linux): click notification to focus the exact project window and tab — Ghostty, VS Code, iTerm2, Warp, kitty, WezTerm, Alacritty, Hyper, Apple Terminal, GNOME Terminal, Konsole, Tilix, Terminator, XFCE4 Terminal, MATE Terminal
Multiplexers: tmux (including iTerm2 -CC integration mode), zellij, WezTerm, kitty — click switches to the correct session/pane/tab
Git branch in title: ✅ Completed main [cat]
Sounds: MP3/WAV/FLAC/OGG/AIFF, volume control, audio device selection
Webhooks: Slack, Discord, Telegram, Lark/Feishu, Microsoft Teams, ntfy.sh, PagerDuty, Zapier, n8n, Make, custom — with retry, circuit breaker, rate limiting (docs)
Plugin compatibility: works with double-shot-latte and other plugins that spawn background Claude instances

Installation

Prerequisites

Claude Code and/or Codex CLI for the products you select
Windows users: Git Bash (included with Git for Windows)
macOS/Linux users: No additional software required

Quick Install (Recommended)

Prefer a guided setup? Open the installation guide to choose your agent, OS and task.

One command to install or update the notifications plugin for Claude Code, Codex, or both. The interactive menu asks you to choose:

curl -fsSL https://raw.githubusercontent.com/777genius/agent-notifications/main/bin/bootstrap.sh | bash

Windows users: open Git Bash from the Start menu and run this command there. Do not run the curl ... | bash command from PowerShell or Windows Terminal if bash opens WSL, because that targets Linux paths and binaries instead of Windows.

For automation or terminals without a controlling TTY, choose explicitly:

curl -fsSL https://raw.githubusercontent.com/777genius/agent-notifications/main/bin/bootstrap.sh | bash -s -- --product codex

Use claude, codex, or both. This installs the notifications plugin; the selected Claude Code / Codex CLI must already be on PATH.

After installation:

Claude: restart Claude Code. Optionally run /claude-notifications-go:settings to configure sounds.
Codex: start Codex, run /hooks, then review and trust the installed hooks. The installer registers them automatically; no JSON editing or manual registration command is needed. Trust approval remains yours.
Both: complete both steps above.

Codex requires a published stable plugin release v1.42.0 or newer. The installer downloads matching source and binaries, respects CODEX_HOME, and keeps a permanent runtime copy there. It reports an error if no supported release is published yet.

If installation fails, use manual Claude installation or manual Codex registration, depending on the product.

Manual Install

Run these slash commands in the Claude Code chat, not in your system terminal:

# 1) Add marketplace
/plugin marketplace add 777genius/agent-notifications
# 2) Install plugin
/plugin install claude-notifications-go@claude-notifications-go
# 3) Restart Claude Code
# 4) Download binary
/claude-notifications-go:init
# 5) (Optional) Configure sounds and settings
/claude-notifications-go:settings

Having issues with installation? See Troubleshooting.

Updating

Run the same command and choose the product(s) you want to update:

curl -fsSL https://raw.githubusercontent.com/777genius/agent-notifications/main/bin/bootstrap.sh | bash

For Claude, restart Claude Code. For Codex, restart Codex and inspect /hooks; changed hook definitions may need trust approval again. The installer refreshes the Codex runtime and registration automatically. Existing foreign hooks and shared settings in ~/.claude/claude-notifications-go/config.json are preserved.

Claude Code also periodically checks for plugin updates automatically. Binaries are updated on the next hook invocation when a version mismatch is detected.

To update manually via Claude Code UI:

Run /plugin, select Marketplaces, choose claude-notifications-go, then select Update marketplace
Select Installed, choose claude-notifications-go, then select Update now

If the binary auto-update didn't work (e.g. no internet at the time), run /claude-notifications-go:init to download it manually. If hook definitions changed in the new version, restart Claude Code to apply them.

Supported Notification Types

The Claude triggers are listed below. Codex uses a different event mapping, described in Codex support.

Status	Icon	Description	Trigger
Task Complete	✅	Main task completed	Stop/SubagentStop hooks (state machine detects active tools like Write/Edit/Bash, or ExitPlanMode followed by tool usage)
Review Complete	🔍	Code review finished	Stop/SubagentStop hooks (state machine detects only read-like tools: Read/Grep/Glob with no active tools, plus long text response >200 chars)
Question	❓	Claude has a question	PreToolUse hook (AskUserQuestion) OR Notification hook
Plan Ready	📋	Plan ready for approval	PreToolUse hook (ExitPlanMode)
Session Limit Reached	⏱️	Session limit reached	Stop/SubagentStop hooks (state machine detects "Session limit reached" text in last 3 assistant messages)
API Error	🔴	Authentication expired, rate limit, server error, connection error	Stop/SubagentStop hooks (state machine detects via `isApiErrorMessage` flag + `error` field from JSONL)
Permission Request	🔐	Codex is waiting for tool approval	Codex `PermissionRequest` hook (Codex only)

Codex CLI Support (beta)

The same binary can notify for OpenAI Codex CLI sessions.

Setup

Use the one-command installer and choose Codex or both. It downloads matching release source and binaries, registers the hooks, and keeps a stable runtime copy. Then start Codex and approve the entries in /hooks.

Manual Codex registration

Skip this section if you used the one-command installer. For manual setup, download a matching release bundle and binary (v1.42.0 or newer). The Go registration command needs no jq and is not automatically added to your PATH.

From the bundle directory:

./bin/claude-notifications setup-codex --plugin-root .

On Windows, run the downloaded claude-notifications-windows-amd64.exe in PowerShell:

.\bin\claude-notifications-windows-amd64.exe setup-codex --plugin-root .

Run these commands in the bundle directory. If you have explicitly added the binary to PATH, claude-notifications setup-codex --plugin-root <bundle-directory> also works.

It installs a self-contained copy of the plugin at `~/.codex/claude-notificati

agent-notifications

Frequently Asked Questions

What is agent-notifications?

Is agent-notifications safe to use?

How do I install agent-notifications?

What programming language is agent-notifications written in?

Are there alternatives to agent-notifications?

Related Skills

Table of Contents

Features

Installation

Prerequisites

Quick Install (Recommended)

Manual Install

Updating

Supported Notification Types

Codex CLI Support (beta)

Setup

Manual Codex registration