dread

webhooks in your terminal

1. install

curl -sSL dread.sh/install | sh

2. create a channel

$ dread new "Stripe Prod"

Created channel: Stripe Prod (ch_stripe-prod_a1b2c3)
Webhook URL:     https://dread.sh/wh/ch_stripe-prod_a1b2c3

3. paste the webhook URL into your service

# Stripe, GitHub, Slack, Linear, anything that sends webhooks

done

# desktop notifications are automatic — no terminal needed
# open the TUI anytime to see the live feed:
$ dread

set up a workspace for your team

A workspace is just a set of channels — one per service you care about. One person creates the channels and wires up the webhooks. Everyone else subscribes with a single command and starts getting notifications.

1. create channels for each service

$ dread new "Stripe Prod"
Webhook URL: https://dread.sh/wh/ch_stripe-prod_a1b2c3

$ dread new "GitHub Deploys"
Webhook URL: https://dread.sh/wh/ch_github-deploys_d4e5f6

$ dread new "Sentry Alerts"
Webhook URL: https://dread.sh/wh/ch_sentry-alerts_g7h8i9

2. paste each webhook URL into the corresponding service

# go to Stripe → Developers → Webhooks → Add endpoint
# go to GitHub → Settings → Webhooks → Add webhook
# go to Sentry → Settings → Integrations → Webhooks

3. share channels with your team

$ dread share ch_stripe-prod_a1b2c3

Share this with your team:
  dread add ch_stripe-prod_a1b2c3 "Stripe Prod"

# send that command to your team over Slack, email, wherever

4. teammates install and subscribe

# each teammate runs:
$ curl -sSL dread.sh/install | sh
$ dread add ch_stripe-prod_a1b2c3 "Stripe Prod"
$ dread add ch_github-deploys_d4e5f6 "GitHub Deploys"
$ dread add ch_sentry-alerts_g7h8i9 "Sentry Alerts"

# notifications start immediately — nothing else to configure

that's it

# everyone on the team now gets desktop notifications
# for every webhook event across all subscribed channels
# no accounts, no dashboards, no browser tabs

features

desktop notifications native macOS + Linux — works in the background, no terminal needed
terminal TUI live feed of all webhook events with full payload inspection
team sharing one person sets up the webhooks, shares channel IDs — everyone gets notifications
multiple channels separate channels per service — Stripe, GitHub, Slack, whatever
event filtering filter by source, type, or content — in the TUI and in watch mode
event history scroll back through past events, stored server-side
webhook forwarding forward events to localhost or any URL for local development
event replay re-forward any past event to a URL for debugging
auto-reconnect drops connection? reconnects in 3 seconds, picks up new channels
runs at login installs as a launchd/systemd service — starts automatically
works with everything any service that sends webhooks — just paste the URL

commands

basics

dread                       # launch TUI with live feed
dread new "Stripe Prod"     # create a channel
dread list                  # show all channels + webhook URLs
dread logs                  # print recent events to stdout
dread status                # show channels, last events, service status

team

dread share <id>            # print a command to share with teammates
dread add <id> "Name"       # subscribe to a shared channel
dread remove <id>           # unsubscribe from a channel

notifications

dread watch                 # headless desktop notifications
dread watch --filter stripe # only notify on matching events

development

dread --forward http://...  # forward webhooks to localhost
dread --filter payment      # TUI filtered to matching events
dread test <id>             # send a test webhook event
dread replay <event-id>     # re-forward a past event