grith notifications
Manage notification channels — Slack, Discord, Telegram, Teams, email, webhook, and more.
grith notifications [status | channels | test]
Inspect channel state and send test messages. Channel configuration lives in
~/.config/grith/config.toml under [notifications.channels.*] — see
Notifications guides for per-channel setup.
Subcommands
grith notifications channels
List configured channels and their health.
$ grith notifications channels
CHANNEL STATE DELIVERED FAILED LAST
slack healthy 412 0 12s ago
telegram healthy 312 1 8m ago
pagerduty paused 0 0 —
webhook-ops healthy 54 0 3m ago
email unhealthy 12 8 1d ago (smtp timeout)
Possible states: healthy, paused (user-disabled), unhealthy (recent delivery
failures), not-configured.
grith notifications status
A one-line summary plus per-channel delivery counts over the last 24h. Useful in status dashboards.
grith notifications test <CHANNEL>
Send a synthetic notification to verify the channel is working.
grith notifications test slack
Output:
[slack] test message sent → delivered in 312ms
For webhook channels, the test posts a stub digest item shape; receiving endpoints can verify their HMAC handling against it.
Configuration
Channels are configured in config.toml rather than via CLI. Example:
[notifications.channels.slack]
enabled = true
webhook_url = "https://hooks.slack.com/services/..."
default_room = "#grith-alerts"
[notifications.channels.pagerduty]
enabled = true
service_key = "..."
severity_map = { canary = "critical", queue = "warning" }
See [notifications] config and the per-channel guides for
the full field set.
Per-channel guides
| Channel | Guide |
|---|---|
| Slack | Notifications: Slack |
| Discord | Notifications: Discord |
| Telegram | Notifications: Telegram |
| Microsoft Teams | Notifications: Teams |
| Email (SMTP) | Notifications: Email |
| Generic webhook | Notifications: Webhook |
| PagerDuty | Notifications: PagerDuty |
| Opsgenie | Notifications: Opsgenie |
| Notifications: WhatsApp | |
| Desktop | Notifications: Desktop |
| WebSocket | Notifications: WebSocket |