webcatch

A simple HTTP request inspector that captures and displays incoming requests in real-time.

Installation

Homebrew (macOS/Linux)

brew install alwedo/tap/webcatch

From Source

go install github.com/alwedo/webcatch@latest

Download Binary

Download the latest release from the releases page.

Usage

webcatch

This starts two servers:

• Capture server on :8080 - send requests here to capture them
• Viewer server on :8081 - view captured requests in your browser

Flags

--capture-port  Port for capture server (default: 8080)
--viewer-port   Port for viewer server (default: 8081)
--version       Print version and exit

Example with custom ports:

webcatch --capture-port 9000 --viewer-port 9001

Example

Send a test request:

curl -X POST http://localhost:8080/test \
  -H "Content-Type: application/json" \
  -d '{"hello":"world"}'

View it at http://localhost:8081

Using with ngrok

To capture webhooks from external services, expose the capture server with ngrok:

ngrok http 8080

Then use the ngrok URL (e.g., https://abc123.ngrok.io) as your webhook endpoint. All requests will be captured and visible at http://localhost:8081.

Features

• Captures method, path, headers, and body
• Live updates via Server-Sent Events
• Clear captured calls with one click
• Graceful shutdown with Ctrl+C

Building

go build -o webcatch

Testing

go test ./...

Version

webcatch --version

Development

Run from source:

go run .

Build locally:

go build -o webcatch
./webcatch