slack-notify

# Slack Notify Skill

## Purpose
Automatically send Slack notifications when TodoWrite tasks are completed, providing real-time updates on work progress with repository context.

## Activation Triggers
- **Auto-trigger (Default: ON)**: Automatically activates when ALL TodoWrite tasks are marked as `completed`
  - Receives hook context via **stdin as JSON** (not environment variables)
  - Context includes `transcript_path` pointing to conversation history in JSONL format
  - Hook parses transcript to extract completed TodoWrite tasks
- **Manual invocation**: `/devnogari:slack-notify` command
- **Alternative triggers**: Git hooks, build scripts, time-based, error-based, etc. (see `docs/triggers.md`)
- **Configurable**: Can be disabled via `SLACK_NOTIFY_AUTO_TRIGGER=false` or config file

## Prerequisites

### Required
- **Slack Webhook URL**: Must be configured via **config file** (recommended) OR environment variable
- **Node.js**: Version 16.0.0 or higher
- **Plugin Installation**: Installed at `~/.claude/plugins/slack-notify/`

### Configuration

**IMPORTANT**: Webhook URL can be provided via config file OR environment variable. The script will check both locations automatically.

**📁 Config File Locations** (✅ Recommended - checked in priority order):
1. `./.claude-slack-notify.json` - Project-level (highest priority)
2. `~/.config/claude-slack-notify/config.json` - Global (✅ recommended)
3. `~/.claude-slack-notify.json` - Home directory
4. `~/.config/claude-code/slack-notify.json` - Legacy location

If a valid config file exists with `webhookUrl` set, the script will use it automatically. **No environment variable needed.**

**⚙️ Environment Variables** (Optional override):
- `SLACK_WEBHOOK_URL` - Webhook URL (only required if no config file exists)
- `SLACK_NOTIFY_PROFILE` - Config profile to use (default: "default")
- `SLACK_NOTIFY_ENABLED` - Enable/disable (default: true)
- `SLACK_NOTIFY_AUTO_TRIGGER` - Auto-trigger on TodoWrite (default: true)
- `SLACK_NOTIF