claude-code-vibe-webhook

Claude Code plugin for VibeControls webhook notifications. Companion plugin for @burdenoff/vibe-plugin-notify.

Get notified via Slack, Discord, or custom webhooks when Claude Code completes tasks.

Features

• 🔔 Webhook notifications on task completion
• 🎯 Pre-configured for VibeControls Agent integration
• 💬 Native Slack & Discord formatting
• 🔧 Hook-based event detection (Stop, PostToolUse, PreToolUse)
• ⚙️ Configurable via JSON or environment variables

Installation

npm install claude-code-vibe-webhook

Then copy or link to your Claude Code plugins directory:

# Copy
cp -r node_modules/claude-code-vibe-webhook ~/.claude-code/plugins/

# Or link
ln -s $(pwd)/node_modules/claude-code-vibe-webhook ~/.claude-code/plugins/

Or use the --plugin-dir flag:

claude --plugin-dir ./node_modules/claude-code-vibe-webhook

Setup with VibeControls Agent

1. Install and start VibeControls Agent with the notify plugin:

npm install -g @burdenoff/vibe-agent
vibe plugin install @burdenoff/vibe-plugin-notify
vibe start

2. Add webhooks in VibeControls:

vibe notify add https://hooks.slack.com/services/YOUR/SLACK/WEBHOOK

3. Use Claude Code normally - notifications will be sent when tasks complete.

Configuration

Config File

Create ~/.config/claude-code/vibe-webhook.json:

{
  "vibeAgentUrl": "http://localhost:3005",
  "vibeNotifyEnabled": true,
  "webhooks": [
    {
      "url": "https://hooks.slack.com/services/xxx",
      "name": "Slack",
      "enabled": true
    }
  ],
  "events": ["stop", "post-tool-use"],
  "notifyOnEveryToolUse": false,
  "debug": false
}

Environment Variables

• VIBE_AGENT_URL - VibeControls Agent URL (default: http://localhost:3005)
• VIBE_WEBHOOK_URL - Direct webhook URL (added to webhooks list)
• VIBE_WEBHOOK_DEBUG - Enable debug logging (set to true)

Events

The plugin listens to these Claude Code hook events:

| Event | Description | Default | |-------|-------------|---------| | stop | Session/task completed | ✅ Enabled | | post-tool-use | After tool execution | ❌ Disabled (enable with notifyOnEveryToolUse) | | pre-tool-use | Before tool execution | ❌ Disabled |

Debug

Enable debug logging:

export VIBE_WEBHOOK_DEBUG=true

View logs:

tail -f /tmp/claude-code-vibe-webhook.log

Related

• @burdenoff/vibe-plugin-notify - VibeControls notification plugin
• opencode-vibe-webhook - OpenCode plugin
• gemini-cli-vibe-webhook - Gemini CLI extension
• cursor-vibe-webhook - Cursor plugin

License

MIT