Skip to content

feat: add webhook notifications for port events#103

Open
productdevbook wants to merge 1 commit intomainfrom
feat/webhook-notifications
Open

feat: add webhook notifications for port events#103
productdevbook wants to merge 1 commit intomainfrom
feat/webhook-notifications

Conversation

@productdevbook
Copy link
Copy Markdown
Owner

Summary

  • Adds configurable webhook URL in Settings to receive JSON POST notifications
  • Supports three event types: port_opened, port_closed, port_killed
  • Per-event toggle checkboxes to control which events trigger webhooks
  • "Test Webhook" button to verify configuration with a test payload
  • Webhooks fire on port scan changes and process kills

Payload Format

{
  "event": "port_opened",
  "port": 3000,
  "process": "node",
  "pid": 12345,
  "timestamp": "2025-01-15T10:30:00Z",
  "hostname": "MacBook-Pro.local"
}

Closes #29

Test plan

  • Set a webhook URL in Settings > Webhooks
  • Click "Test Webhook" — verify success indicator
  • Start a process on a port — verify port_opened webhook fires
  • Stop that process — verify port_closed webhook fires
  • Kill a process via PortKiller — verify port_killed webhook fires
  • Disable specific events — verify they no longer fire
  • Clear URL — verify no webhooks are sent

🤖 Generated with Claude Code

Send JSON POST requests to a configurable URL when ports are opened,
closed, or killed. Includes per-event toggles and a test webhook button
in Settings.

Closes #29

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: Webhook notifications for port events

1 participant