cursor-vibe-webhook

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

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

Features

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

Installation

npm install cursor-vibe-webhook

Then copy to your Cursor plugins directory:

mkdir -p ~/.cursor/plugins
cp -r node_modules/cursor-vibe-webhook ~/.cursor/plugins/

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 Cursor normally - notifications will be sent when tasks complete.

Configuration

Config File

Create ~/.config/cursor/vibe-webhook.json:

{
  "vibeAgentUrl": "http://localhost:3005",
  "vibeNotifyEnabled": true,
  "webhooks": [
    {
      "url": "https://hooks.slack.com/services/xxx",
      "name": "Slack",
      "enabled": true
    }
  ],
  "events": ["session-end", "stop"],
  "notifyOnEveryToolUse": false,
  "notifyOnFileEdit": false,
  "notifyOnShellExecution": false,
  "notifyOnAgentResponse": 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 Cursor hook events:

| Event | Description | Default | |-------|-------------|---------| | session-end | Session completed | ✅ Enabled | | stop | Agent stopped | ✅ Enabled | | post-tool-use | After tool execution | ❌ Disabled | | file-edited | After file edit | ❌ Disabled | | shell-executed | After shell command | ❌ Disabled | | agent-response | After agent response | ❌ Disabled |

Debug

Enable debug logging:

export VIBE_WEBHOOK_DEBUG=true

View logs:

tail -f /tmp/cursor-vibe-webhook.log

Related

• @burdenoff/vibe-plugin-notify - VibeControls notification plugin
• opencode-vibe-webhook - OpenCode plugin
• claude-code-vibe-webhook - Claude Code plugin
• gemini-cli-vibe-webhook - Gemini CLI extension

License

MIT