Inspect Requests

Every webhook endpoint — and any tunnel started with --log — captures its requests to a local JSONL file at ~/.otterkit/requests/<subdomain>.jsonl, one JSON object per line. Each entry includes timestamp, method, path, headers, body (base64), response status, and duration.

View captured requests with the inspect command:

bash

# Pretty-print last 20 requests
npx otterkit inspect agent-a1b2c3d4

# Raw JSONL output (pipe-friendly for jq, etc.)
npx otterkit inspect agent-a1b2c3d4 --json

# Show last 50 requests
npx otterkit inspect agent-a1b2c3d4 --last 50

# Live-tail new requests as they arrive (Ctrl+C to stop)
npx otterkit inspect agent-a1b2c3d4 --follow

# Filter by method, status (exact or class), and path substring
npx otterkit inspect agent-a1b2c3d4 --method POST --status 5xx --path /webhook

# Export as HAR 1.2 — open in browser devtools or any HAR viewer
npx otterkit inspect agent-a1b2c3d4 --har > session.har

Filters combine and work with --json, --follow, and --har. The JSONL format works with standard tools like jq, tail -f, andgrep. Log files are cleaned up automatically when the daemon is stopped.

Webhook Replay Requests