code-notify

🥈Silver

Code-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.

19240Updated 4w ago

Intermediate30min to implementautomation

Saves ~15 min per use

Quick InstallView Source

git clone https://github.com/mylee04/code-notify.git

Works with:

Claude

Overview

About This Skill

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."}]

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-notify

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

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.
```