whim-proxy logo

whim-proxy

Reverse-tunnel webhooks to your laptop

version: 0.1.4

Quick start

# 1. Download client (see Download section below)

# 2. Generate a channel UUID (can be reused across sessions)
CHANNEL=$(./whim-client --gen-uuid)
echo "$CHANNEL"

# 3. Start the client on your laptop
./whim-client --server ws://whim-proxy.kakwalab.dev --channel "$CHANNEL" --target http://localhost:8080/webhook

# 4. Configure your webhook sender to POST to:
echo "http://whim-proxy.kakwalab.dev/hook/$CHANNEL"

# 5. Trigger a test event with curl:
curl -X POST http://whim-proxy.kakwalab.dev/hook/$CHANNEL \
     -H "Content-Type: application/json" \
     -d '{"event":"test"}'

# 6. Check received events:
./whim-client --server ws://whim-proxy.kakwalab.dev --channel "$CHANNEL" --logs

Download client

PlatformBinary
Linux / x86_64 whim-client-linux-amd64
Linux / ARM64 whim-client-linux-arm64
macOS / Intel whim-client-darwin-amd64
macOS / Apple Silicon whim-client-darwin-arm64
Windows / x86_64 whim-client-windows-amd64.exe
Windows / ARM64 whim-client-windows-arm64.exe

Full documentation, source code, and releases: github.com/kakwa/whim-proxy