Claude Notification Hook

A Node.js CLI tool that sends Claude Code notifications via telert.reily.app webhook.

Installation

Global installation

npm install -g claude-notification-hook

Use with npx (no installation needed)

npx claude-notification-hook

Usage

Prerequisites

You need to set the TELERT_WEBHOOK_URL environment variable with your telert.reily.app webhook URL.

export TELERT_WEBHOOK_URL="https://telert.reily.app/webhook/your-webhook-id"

Basic Usage

The tool reads JSON from stdin. You can pipe JSON data to it:

echo '{"message": "Task completed successfully", "title": "Build Complete"}' | claude-notification-hook

Input Format

The tool expects JSON input with the following optional fields:

{
  "message": "Your notification message",
  "title": "Notification title",
  "session_id": "optional-session-identifier"
}

If fields are omitted, defaults will be used:

• message: "Claude Code notification"
• title: "Claude Code"
• session_id: "unknown"

Example Usage Scenarios

CI/CD Pipeline

# In a GitHub Actions step
echo '{"message": "Build completed successfully", "title": "CI Build"}' | npx claude-notification-hook

Development Workflow

# After completing a task
echo '{"message": "Feature implementation completed", "title": "Dev Task"}' | claude-notification-hook

Development

Local Development

# Clone the repository
git clone https://github.com/kylefang/claude-notification-hook.git
cd claude-notification-hook

# Install dependencies
npm install

# Run locally
./bin/claude-notification-hook.js
# or
npm start

Testing

# Test with sample input
echo '{"message": "Test notification", "title": "Test"}' | ./bin/claude-notification-hook.js

License

MIT

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.