Notifications: Discord
Route grith events to a Discord channel via webhook.
Send digest items and alerts to a Discord channel.
1. Get a webhook URL
In your Discord server:
- Channel settings → Integrations → Webhooks → New Webhook.
- Name it (e.g.
grith), pick the channel. - Copy the webhook URL (it looks like
https://discord.com/api/webhooks/...).
2. Configure
[notifications.channels.discord]
enabled = true
webhook_url = "https://discord.com/api/webhooks/..."
username = "grith"
avatar_url = "https://grith.ai/logo.png" # optional
severity_map = { canary = "critical", queue = "warning" }
3. Test
grith notifications test discord
Format
Discord messages are rich embeds:
- Title — the operation and target.
- Description — first-line summary.
- Fields — filter contributions, session info.
- Colour — green for allow, amber for queue, red for deny/canary.
Interactive buttons
Discord interactive components require a Discord bot, not a plain webhook. The v0.1 release uses webhook delivery only — buttons aren't supported. To approve or deny:
- Click the link in the embed to open the daemon dashboard.
- Or use
grith digestfrom any terminal.
A full Discord bot integration is planned for v0.2.
See also
grith notifications- Notification security model
- Other channels: Slack, Teams
Last updated: 2026-05-14Edit this page on GitHub →