Documentation

Quickstart

Install Kite and stream your first webhook in under two minutes.

Get Kite running and stream your first webhook in under two minutes.

// 011. Install the CLI

bash

curl -sSL https://getkite.sh/install | sh

This installs the kite binary to /usr/local/bin. See Installation for alternative methods including Homebrew and direct binary downloads.

bash

kite login

This opens your browser for device auth. Once approved, your API key is stored locally at ~/.config/kite/config.toml.

bash

kite endpoints create --source github

Kite returns a webhook URL and a one-time signing secret. Add these to your GitHub repository settings under Settings → Webhooks.

bash

kite stream --source github

Push a commit or open a pull request. You'll see CloudEvent payloads arrive in real time:

code

[com.github.push] refs/heads/main — 1 commit(s) by alice
[com.github.pull_request.opened] PR #42 by alice — "Add quickstart guide"

If you have a local HTTP server, use kite proxy to forward events directly:

bash

kite proxy --source github --target http://localhost:3000/webhooks