github-to-signal

HTTP server that receives GitHub webhook events and forwards them as Signal messages via signal-cli.

Supported Events

• Push — commits pushed to a branch
• Issues — opened, closed, reopened, etc.
• Issue comments — new comments on issues
• Pull requests — opened, closed, merged, etc.
• PR reviews — approved, changes requested, commented
• PR review comments — inline code comments on PRs
• Releases — published, drafted, etc.
• Stars — starred/unstarred (with count)
• Forks — repo forked
• Workflow runs — CI completed (with pass/fail indicator)
• Branch/tag create — new branches or tags
• Branch/tag delete — deleted branches or tags

Setup

1. Signal Profile

Register a phone number with signal-cli, then set up the bot profile:

# Set the bot's display name
signal-cli -a +1YOURNUMBER updateProfile --given-name "Github" --family-name "PRs"

# Set the octocat avatar (included in assets/)
signal-cli -a +1YOURNUMBER updateProfile --avatar assets/octocat.png

2. Run signal-cli daemon

signal-cli -a +1YOURNUMBER daemon --http 127.0.0.1:8080 --no-receive-stdout

3. Configure

Copy config.example.toml to config.toml:

# GitHub webhook secret (set in your GitHub webhook settings)
webhook_secret = "your-secret-here"

# Address to listen on
listen_addr = ":9900"

# signal-cli JSON-RPC endpoint
signal_url = "http://127.0.0.1:8080"

# signal-cli account (phone number registered with signal-cli)
signal_account = "+1YOURNUMBER"

# Signal recipient UUID to send notifications to
signal_recipient = "your-uuid-here"

All values can also be set via environment variables with GH2SIG_ prefix:

export GH2SIG_WEBHOOK_SECRET="your-secret"
export GH2SIG_SIGNAL_ACCOUNT="+1YOURNUMBER"
export GH2SIG_SIGNAL_RECIPIENT="recipient-uuid"

4. Build and run

go build -o github-to-signal .
./github-to-signal

5. Add GitHub webhook

In your repo (or org) settings:

1. Go to Settings > Webhooks > Add webhook
2. Payload URL: https://your-host:9900/webhook
3. Content type: application/json
4. Secret: same value as webhook_secret in your config
5. Events: select the events you want, or "Send me everything"

Endpoints

Path	Method	Description
/webhook	POST	GitHub webhook receiver
/health	GET	Health check (returns ok)

Dependencies

• cbrgm/githubevents — GitHub webhook event handling
• taigrr/signalcli — signal-cli Go client
• taigrr/jety — configuration (TOML/JSON/YAML/env)

License

0BSD