See every HTTP request. Debug anything.
Capture, inspect, and replay HTTP/HTTPS traffic. Debug web APIs, reverse-engineer mobile apps, or let your AI agent query everything.
Free and open source.
Other proxy tools show traffic to humans. Laurel Proxy makes it queryable by AI agents. Tell Claude "the Stripe webhook is failing, debug it" and it queries Laurel Proxy, finds the 422 response, reads the error body, and fixes your code.
# Install and start capturing traffic in 10 seconds
npx laurel-proxy requests --tail
Why Laurel Proxy?
- AI-native. A
--format agent output mode returns enriched JSON optimized for LLM consumption. A Claude Code plugin teaches your AI assistant every command and API endpoint.
- One command.
npx @rvanbaalen/laurel-proxy starts the proxy, enables system routing, and opens an interactive TUI. Ctrl+C to clean up.
- SQLite storage. All traffic in a queryable database. Filter by host, status, method, time range. JSON output for piping.
- HTTPS interception. Local CA, per-domain cert generation, one command to trust.
- Smart filters.
--failed for 4xx/5xx, --last-hour, --last-day, --slow 500 for requests over 500ms.
- iOS inspection. Point your device at the proxy, install the cert profile, full HTTPS visibility.
- REST API + SSE. Every feature available via HTTP. Real-time streaming. Machine-readable by default.
Quick Start
# Start proxy + TUI (auto-enables system proxy on macOS)
laurel-proxy requests --tail
# Filter for a specific host
laurel-proxy requests --host api.example.com --tail
# Show only failed requests from the last hour
laurel-proxy requests --failed --last-hour
# AI-optimized output for Claude Code
laurel-proxy requests --host stripe.com --failed --format agent
Manual setup
laurel-proxy start # Start proxy
curl -x http://127.0.0.1:8080 http://httpbin.org/get # Route traffic
laurel-proxy requests # View captured traffic
open http://127.0.0.1:8081 # Open web UI
laurel-proxy stop # Stop
For HTTPS: laurel-proxy trust-ca then traffic flows through automatically.
Claude Code Plugin
/plugin marketplace add rvanbaalen/laurelproxy
After installation, just tell Claude what you need. It knows every command, filter, and API endpoint.
Installation
npx laurel-proxy # Run without installing
npm install -g laurel-proxy # Or install globally
Platform
Works on macOS and Linux. System proxy features (proxy-on/proxy-off) are macOS-only.
Interactive Mode
Running laurel-proxy with no arguments launches an interactive terminal menu:
laurel-proxy
The interactive menu provides access to all features:
- Start/Stop proxy -- toggle the proxy server on and off
- Status -- view proxy stats (port, request count, DB size)
- View requests -- browse captured traffic in the terminal
- Clear traffic -- delete all captured requests
- Open web UI -- opens the dashboard in your browser (auto-starts the proxy if needed)
- Trust CA certificate -- install the CA cert for HTTPS interception
- Enable/Disable system proxy -- route all macOS traffic through Laurel Proxy
- Quit -- stop the proxy and exit
Use arrow keys to navigate and Enter to select. Press q or Ctrl+C to quit.
The interactive mode stays in sync with the web UI -- if you stop the proxy from the web dashboard, the CLI menu updates within a second, and vice versa.
CLI Commands
start
Start the proxy server in the foreground.
laurel-proxy start [options]
| Option | Default | Description |
|---|
--port <number> | 8080 | Proxy listening port |
--ui-port <number> | 8081 | Web UI and API port |
--db-path <path> | ~/.laurel-proxy/data.db | SQLite database location |
# Default ports
laurel-proxy start
# Custom ports
laurel-proxy start --port 9000 --ui-port 9001
# Custom database location
laurel-proxy start --db-path /tmp/proxy.db