hookreplay
v1.0.19
Published
Debug webhooks locally - capture, inspect, and replay webhooks to your local server
Maintainers
Readme
HookReplay CLI
Capture once. Replay forever.
Debug webhooks locally. Capture, inspect, and replay webhooks to your local development server.
Installation
npm install -g hookreplayAlternative Installation
# .NET Tool (requires .NET 9+)
dotnet tool install --global HookReplay.CliQuick Start
Get an API key from hookreplay.dev/settings/api-keys
Configure and connect:
hookreplay > config api-key YOUR_API_KEY > connectReceive webhooks - Click "Send to CLI" in the web interface to forward requests to your local server.
Commands
| Command | Description |
|---------|-------------|
| help | Show available commands |
| config api-key <key> | Set your API key |
| config server <url> | Set server URL |
| connect | Connect and wait for replays |
| disconnect | Disconnect from server |
| status | Show connection status |
| history | Show received requests |
| replay <id> [url] | Replay a request |
| version | Show version info |
| update | Check for and install updates |
| quit | Exit the CLI |
How It Works
Webhook Provider → HookReplay → CLI → localhost:3000- Create a webhook endpoint at hookreplay.dev
- Point your webhook provider to your HookReplay URL
- Webhooks are captured and stored
- Connect CLI and click "Send to CLI" to forward to localhost
- Debug with your IDE's breakpoints
Changelog
v1.0.19 (2026-01-23)
📚 Documentation
- Fixed repository URLs in README and CONTRIBUTING.md
- Added contributing section
v1.0.18 (2026-01-23)
🐛 Bug Fixes
- Fixed response body display: HTML/XML responses with
[and]characters no longer crash the CLI - Fixed markup escaping: All response content is now properly escaped
✨ New Features
- Auto-reconnect: CLI automatically reconnects when the connection drops
- Exponential backoff: 1s → 2s → 5s → 10s → 30s
- Up to 10 reconnection attempts
- Manual disconnect disables auto-reconnect
v1.0.17
- Self-update feature: CLI can update itself
- Version checking on startup
Contributing
We welcome contributions! See CONTRIBUTING.md for guidelines.
# Clone the repo
git clone https://github.com/ahmedmandur/hookreplay-cli.git
cd hookreplay-cli
# Build
dotnet build
# Run
dotnet run --project src/HookReplay.CliLinks
- Website: https://hookreplay.dev
- Documentation: https://hookreplay.dev/docs
- GitHub: https://github.com/ahmedmandur/hookreplay-cli
License
MIT
