laurel-proxy

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