claude-notifications-go

🥈Silver

Cross-platform smart notifications plugin for Claude Code. Supports 6 notification types, instant delivery, and context analysis. Zero dependencies, webhooks, and easy installation. Ideal for operations teams managing Claude agents.

553110Updated 2mo ago

Intermediate30min to implementautomation

Saves ~30 min per use

Quick InstallView Source

git clone https://github.com/777genius/claude-notifications-go.git

Works with:

Claude

Overview

About This Skill

How to Use

[{"step":"Install the plugin","action":"Run `claude install claude-notifications-go` in your terminal. Verify installation with `claude notifications --version`.","tip":"Ensure you have Claude Code v1.0+ installed. The plugin uses native Go binaries with no external dependencies."},{"step":"Configure notification channels","action":"Edit `~/.claude/notifications/config.json` to add your destinations. Example for Slack: `{ \"type\": \"slack\", \"webhook_url\": \"https://hooks.slack.com/services/...\", \"channel\": \"#ops-alerts\" }`","tip":"Use environment variables for sensitive data like webhook URLs: `export SLACK_WEBHOOK_URL=...`"},{"step":"Define triggers and templates","action":"Create a trigger file in `~/.claude/notifications/triggers/` named `data_failure.json` with content matching your workflow. Example: `{ \"agent\": \"data-processor\", \"event\": \"csv_parse_error\", \"message\": \"❌ CSV Error: {file} - {error}\" }`","tip":"Use placeholders like {file}, {error}, {duration} for dynamic content. Test with `claude notifications test --trigger data_failure`"},{"step":"Start monitoring","action":"Run your Claude agent with notifications enabled: `claude run --with-notifications data_processor.claude`","tip":"Check active notifications with `claude notifications status`. Monitor delivery with `claude notifications log --tail 50`"},{"step":"Iterate based on feedback","action":"Review failed deliveries in the logs and adjust templates or channels. Use `claude notifications metrics` to analyze patterns over time.","tip":"For high-volume workflows, consider batching notifications or adding priority levels (critical/warning/info)"}]

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/777genius/claude-notifications-go

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 [NOTIFICATION_TYPE] alerts for [CLAUDE_AGENT_NAME] using claude-notifications-go. Configure the alert to trigger when [TRIGGER_CONDITION] occurs during [WORKFLOW_STEP]. Send the notification to [DESTINATION_CHANNEL] with the following message format: '[SUMMARY_LINE] - [DETAILED_CONTEXT]'. Test the notification by simulating [TEST_SCENARIO].

Example Output

```json
{
  "notification_config": {
    "agent": "claude-data-analyzer",
    "type": "workflow_completion",
    "trigger": "csv_analysis_failed",
    "destination": "#ops-alerts",
    "message_template": "⚠️ Data Analysis Failed - {file}: {error_message}\nDuration: {duration}s | Retries: {retry_count}",
    "test_result": {
      "status": "success",
      "output": "Alert sent to #ops-alerts at 2024-05-15T14:32:18Z\nContent: ⚠️ Data Analysis Failed - sales_data.csv: Invalid column 'revenue'\nDuration: 45s | Retries: 2"
    }
  }
}
```

**Configuration Details:**
- **Agent:** `claude-data-analyzer` (handles quarterly sales reports)
- **Trigger:** CSV parsing failure detected during step 3 of the workflow
- **Destination:** Slack channel `#ops-alerts` with @channel mention for critical failures
- **Message Breakdown:**
  - Emoji indicator (⚠️) for visual scanning
  - File name and specific error (invalid column)
  - Performance metrics (duration, retry count)
- **Test Scenario:** Simulated a malformed CSV with missing 'revenue' column
- **Delivery Confirmation:** Webhook response showed 200 OK with message ID `alert_12456`

**Next Steps:**
1. Verify the alert appears in your Slack channel within 30 seconds
2. Check claude-notifications-go logs for any delivery errors: `cat /var/log/claude-notifications.log`
3. Adjust the message template if needed by editing `~/.claude/notifications/config.json`

**Performance Metrics:**
- Average delivery latency: 1.2s (tested over 50 notifications)
- Supported platforms: macOS (x86/ARM), Linux (x86/ARM), Windows (WSL)
- Memory footprint: <5MB per agent instance