What problem does it solve?
Enable external services to automatically activate Monika agent workflows by turning incoming HTTP POST events into contextual agent runs, removing manual polling and bridging third-party event sources into automated responses.
Core Features & Use Cases
- Create and manage subscriptions: Easy CLI-based creation, listing, testing, and removal of named webhook subscriptions.
- Secure delivery: Per-subscription HMAC-SHA256 secrets with signature validation and optional custom secrets.
- Flexible routing and templating: Event filtering, prompt templates using dot.notation for nested JSON, and configurable delivery targets (Telegram, Discord, GitHub comments, origin, etc.).
- Hot-reload and persistence: Subscriptions persist to ~/.monika/webhook_subscriptions.json and the adapter hot-reloads changes with minimal overhead.
- Real-world examples: GitHub issue triage, PR review notifications, Stripe payment alerts, CI/CD build notifications, and generic monitoring/IoT alerts.
Quick Start
Create a new webhook subscription that triggers a Telegram notification for GitHub issue events by running the monika webhook subscribe command with an appropriate events filter and prompt template.