code-notify
🥈SilverCode-Notify provides cross-platform desktop notifications for AI coding tools like Claude Code, Codex, and Gemini. It alerts developers when tasks complete or input is needed, improving workflow efficiency. Integrates with CLI tools on Linux, macOS, and Windows.
24840Updated 3mo ago
Intermediate30min to implementautomation
Saves ~15 min per use
Quick InstallView Source
git clone https://github.com/mylee04/code-notify.gitWorks with:
Claude
Overview
About This Skill
Code-Notify delivers system notifications when AI coding agents complete tasks or require user input, integrating with Claude Code, OpenAI Codex, Google Gemini CLI, and Oh My Pi. The tool works across macOS, Linux, and Windows, supporting native desktop alerts, sound, voice announcements, and webhooks for Slack and Discord. Developers can enable notifications per-tool or project-wide, customize delivery channels, and monitor token usage limits for Codex and Claude. Installation is straightforward via Homebrew, npm, or platform-specific installers.
How to Use
[{"step":"Choose your notification service based on your OS. For Windows, use Wox or native toast notifications. For macOS, use `terminal-notifier` or AppleScript. For Linux, use `notify-send` or `dunst`.","action":"Install the notification tool for your platform. Example for macOS: `brew install terminal-notifier`"},{"step":"Create a notification script that accepts messages and displays them. Save it as `code-notify.sh` (Linux/macOS) or `code-notify.bat` (Windows).","action":"Use the example scripts above or customize for your preferred notification method. Test it with: `./code-notify.sh \"Test notification\"`"},{"step":"Configure your AI coding tool to trigger the script. For Claude Code, edit `.claude/settings.json`. For other tools, use their plugin/extension system.","action":"Add paths to your notification script in the tool's settings file. Example for Codex: `{ \"notifications\": { \"on_complete\": \"/path/to/code-notify.sh\" } }`"},{"step":"Test the integration by running a long task. Use a simple script that takes time to complete, like a file processing task.","action":"Run: `claude --code \"import time; time.sleep(10); print('Done')\" --notify` and verify you receive the notification."},{"step":"Refine notifications based on task type. Separate notifications for errors, warnings, and completions using different script variants.","action":"Create specialized scripts like `code-error-notify.sh` and configure your tool to use them for specific events."}]
Use Cases
Get alerted when Claude Code or Codex tasks complete without manually checking the terminal
Monitor Codex token usage at 20%, 10%, and reset thresholds with voice or sound alerts
Route AI agent notifications to Slack or Discord channels for team visibility
Enable project-specific notification settings that override global tool configurations
Tags
Setup & Installation
Quick Install
No install command available. Check the GitHub repository for manual installation instructions.
Alternative Install (Git Clone)
git clone https://github.com/mylee04/code-notifyRequirements
- Claude Code or compatible AI agent
- Works with: Claude
Quick Start Guide
1
Install the Skill
Copy the install command above and run it in your terminal.
2
Open Your AI Agent
Launch Claude Code, Cursor, or your preferred AI coding agent.
3
Try It Out
Use the prompt template or examples below to test the skill.
4
Customize
Adapt the skill to your specific use case and workflow.
Usage Examples
Prompt Template
Set up a cross-platform desktop notification system for AI coding tasks. Notify me via [NOTIFICATION_SERVICE] when [TASK_TYPE] completes or requires input. Example: 'Set up a system tray notification in Windows using [Wox] when a long-running Claude Code script finishes processing.' Include the command to trigger the notification and the expected output format.
Example Output
```
# Notification System Setup for AI Coding Tasks
## Configuration for Windows (Wox)
1. Install Wox: `winget install Wox.Wox`
2. Create a batch script at `C:\scripts\code-notify.bat`:
```batch
@echo off
set "MESSAGE=%~1"
set "TITLE=AI Coding Task"
powershell -command "Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.MessageBox]::Show('%MESSAGE%', '%TITLE%', 'OK', 'Information')"
```
## Integration with Claude Code
Add this to your `.claude/settings.json`:
```json
{
"notifications": {
"on_task_complete": "C:\\scripts\\code-notify.bat 'Claude Code task completed successfully!'",
"on_input_required": "C:\\scripts\\code-notify.bat 'Claude Code requires your input for the next step.'"
}
}
```
## Expected Output
When a task completes, you'll see a popup:
- **Title**: AI Coding Task
- **Message**: Claude Code task completed successfully!
- **Action**: Click 'OK' to dismiss
For input requests:
- **Message**: Claude Code requires your input for the next step.
- **Action**: Respond via your terminal or IDE
## Verification
Run a test task:
```bash
claude --code "import time; time.sleep(5); print('Task done')" --notify-on-complete
```
You should receive the notification after 5 seconds.
```Apply to these tools
Browse all tools
Gemini
Google's multimodal AI model and assistant
Claude
AI assistant built for thoughtful, nuanced conversation
Google Voice
Google Voice is a telecommunications service that helps you manage and customize your phone, voicemail and SMS usage.
Google Performance Max
AI-automated ads across Google Search, Display, YouTube, and Gmail
Google Cloud Build
Serverless CI/CD for Google Cloud
Google Meet
Google video conferencing with AI meeting features
Compatible MCP servers
Browse all MCP servers
Find the right skills for your stack
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan