httpwut

HTTP request debugger. "Why isn't my request working?" — this tool answers that.

Install

npm install -g httpwut

Usage

# Simple GET request with full debug info
httpwut https://api.example.com/users

# POST request
httpwut https://api.example.com/users -X POST -d '{"name":"test"}'

# With headers
httpwut https://api.example.com -H "Authorization: Bearer token123"

# Show only specific parts
httpwut https://api.example.com --headers-only
httpwut https://api.example.com --body-only
httpwut https://api.example.com --status-only

# Follow redirects (show chain)
httpwut https://example.com --follow
httpwut https://example.com -L

# Show timing breakdown
httpwut https://api.example.com --timing

# Compare two endpoints
httpwut https://api.example.com/v1 --compare https://api.example.com/v2

# Test multiple status codes
httpwut https://api.example.com --expect 200
httpwut https://api.example.com -e 200,201,204

# Save response
httpwut https://api.example.com --output response.json
httpwut https://api.example.com -o response.json

# Verbose mode (show everything)
httpwut https://api.example.com -v

# Help
httpwut --help

Options

| Option | Description | |--------|-------------| | -X, --method | HTTP method (GET, POST, PUT, DELETE) | | -H, --header | Add header (can use multiple) | | -d, --data | Request body | | -o, --output | Save response to file | | -e, --expect | Expected status codes | | -L, --follow | Follow redirects | | -v, --verbose | Show everything | | --headers-only | Show only headers | | --body-only | Show only body | | --status-only | Show only status | | --timing | Show timing breakdown | | --compare | Compare with another URL | | --insecure | Skip SSL verification | | --timeout | Request timeout in ms |

Output

$ httpwut https://api.github.com/users/octocat

  httpwut — bruh.tools
  ────────────────────
  GET https://api.github.com/users/octocat

  STATUS
  ──────
  200 OK ✓

  TIMING
  ──────
  TTFB:           ████████░░  123ms
  Download:       ██░░░░░░░░   33ms
  ──────────────────────────────────
  Total:                      156ms

  HEADERS
  ───────
  content-type: application/json; charset=utf-8
  cache-control: public, max-age=60
  ...

  BODY
  ────
  {
    "login": "octocat",
    "id": 583231,
    "type": "User"
  }

Error Messages

httpwut gives you helpful error messages:

$ httpwut https://localhost:9999
  bruh. nothing is listening on that port. is your server running?

$ httpwut https://notarealsite.invalid
  bruh. DNS lookup failed. check the hostname.

$ httpwut https://api.example.com/secret
  STATUS
  ──────
  401 Unauthorized ✗

  bruh. unauthorized. missing or bad auth credentials.

License

MIT

bruh.tools - no cap fr fr