by 777genius
🔔 Cross-platform smart notifications for Claude/Codex/OpenCode/Cursor/Gemini/Qoder. Desktop alerts, sounds, click-to-focus, and webhooks. macOS, Linux, and Windows.
# Add to your Claude Code skills
git clone https://github.com/777genius/agent-notificationsGuides for using ai agents skills like agent-notifications.
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
}See how agent-notifications compares with popular alternatives.
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/Codex/OpenCode/Cursor/Gemini/Qoder. Desktop alerts, sounds, click-to-focus, and webhooks. macOS, Linux, and Windows. It has 817 GitHub stars.
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.
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).
agent-notifications is primarily written in Go. It is open-source under 777genius on GitHub, so you can review or fork the full source.
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.
No comments yet. Be the first to share your thoughts!
30 days in the Featured rail · terms & refunds
⚠️ 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.
Automated security scan — not a certification.
Desktop notifications for Claude, Codex CLI, OpenCode, Gemini CLI, Cursor CLI and Qoder on macOS, Linux and Windows. Supported architectures and events vary by agent; see the support table and linked setup guides. Claude and Codex also support sounds and click-to-focus.
Guided installer or run:
(set -o pipefail; curl -fsSL https://agent-notifications.com/install.sh | bash)
Cursor CLI: install separately with an explicit CLI executable and profile. The managed UAP integration sends informational Stop notifications and optional webhooks; it does not provide Cursor IDE, question or permission alerts.
Choose Claude, Codex CLI, OpenCode, Gemini CLI, or a combination. Install the selected agent CLIs first and make them available on PATH. The installer also requires curl, Bash, and a working python3 or node on PATH; see agent/platform prerequisites. Run the same command to update.
Windows: use Git Bash, not WSL, for a native Windows installation.
After setup:
/hooks.The installer selects a release from the platform channels for your OS and architecture. See that page for current versions and the release notes for validation details and known limitations.
Run the command once to migrate a normal Claude marketplace installation to its platform channel. Claude's plugin updater then follows that channel; rerun setup to update a standalone Codex bundle. Explicitly pinned/custom marketplace sources are retained.
For Codex only:
(set -o pipefail; curl -fsSL https://agent-notifications.com/install.sh | bash -s -- --product codex)
Use --product claude or --product both for Claude or Claude + Codex. For Claude, Codex and OpenCode on any supported platform:
(set -o pipefail; curl -fsSL https://agent-notifications.com/install.sh | bash -s -- --products claude,codex,opencode --desktop)
On macOS/Linux/Windows, add ,gemini to --products for all four agents, or use --product gemini for Gemini only. Fresh OpenCode/Gemini setup defaults to desktop notifications with webhooks off; updates preserve saved channel choices when no channel flags are supplied. Explicit flags replace the channel pair: --desktop enables desktop only, --webhook enables webhooks only, and both enable both. Webhook destinations need separate configuration. These flags do not change Claude/Codex channels.
Claude/Codex setup also installs the agent-notifications MCP server and agent-notifications skill so an agent can notify you during a task. Open a new session after setup. When an existing managed MCP installation or binding is detected, automatic setup keeps absent clients off; use --agent-notify to add them explicitly. Use --skip-agent-notify to skip their setup for that run; it neither removes an existing MCP installation nor records a permanent opt-out. Setup and recovery details.
Manual installation · Manual Codex registration · Uninstall · Troubleshooting
| Agent | Alerts | Sounds / click-to-focus | Details |
|---|---|---|---|
| Claude | Completions, reviews, questions, plans, session limits and API errors | Yes | Notification types |
| Codex CLI | Turn completion and tool permissions; experimental question hooks and final-message question/error detection | Yes | Setup and limits |
| OpenCode | Root-session completion, questions, permissions and errors | No | Setup and limits |
| Gemini CLI | Turn completion and tool permissions | No | Cross-platform setup and qualification |
| Cursor CLI | Agent loop stopping; fixed informational text | No | Qualified versions, platforms and explicit setup |
| Qoder (source support) | Completion, question, permission, plan and subagent/idle-teammate hooks; separate package | Exact-chat focus unavailable | Local package setup and release limits |
OpenCode V1 and V2 use one installed plugin. The installer accepts stable V1 >= 1.18.29 and V2 >= 2.0.0; prereleases and unknown API generations are rejected. This compatibility range does not mean every version has been tested. See OpenCode setup, release reports and delivery limits for qualification of specific versions and platforms.
The installer requires exactly Gemini CLI 0.62.0. See the Gemini guide for platform evidence and limits. A completed Gemini turn does not necessarily mean task success or a final answer. Gemini alerts and OpenCode webhooks use generic text; OpenCode desktop alerts may include native session titles and current question text. Gemini's built-in notifications can cause duplicate desktop alerts; choose one desktop source or use Agent Notifications for webhooks only.
For OpenCode on