ReqRes documentation

Download the ReqRes disk image, move the app to Applications, and choose the free version or activate a Pro license on first launch.

Approve the ReqRes network extension and VPN configuration in System Settings so ReqRes can start capturing traffic on your Mac.

Install and trust the ReqRes CA so ReqRes can read HTTPS, see what it relays until then, and remove or replace the certificate when you need to.

Start and stop capture from the toolbar, the Capture menu or the menu bar, and know what keeps running when you close the ReqRes window.

Route curl, git, the Claude Code CLI, node, Python and Go traffic through ReqRes by exporting the certificate and pasting a few environment lines.

Move the ReqRes proxy off port 8034, choose another port when a program already holds it, and copy the environment lines again for your terminals.

Read the traffic list's columns and kinds of row, resize its columns, act on requests from the row menu, and know how many requests ReqRes keeps.

Read the headers, body, timings and cURL command of a captured request and its response, and the Events, Messages and RPC tabs some responses add.

Turn on the HTTP/2 beta, see which protocol a request used, and read gRPC-Web, Connect and native gRPC calls with their messages and status.

Read the messages a WebSocket sends and receives in the Messages tab, search them, and see how many ReqRes keeps for each connection.

Watch a slow or streaming request while it is still open, read server-sent events and JSON lines in the Events tab, and read an LLM answer whole.

Read Failed, Aborted and Timed out rows, the reason in one sentence and the 502 ReqRes answers with, and find them with the outcome: token.

See which app or process opened each connection in the App column, and filter traffic to one app or one process ID.

Search captured traffic by text, or narrow it with tokens for host, method, status, path, app, pid, country, outcome, gRPC status and protocol.

Give a host its own entry in the sidebar with a host filter, which also scopes the rules you create for that host.

Keep a request after you quit, find it again in the Saved Sessions window, and know where ReqRes stores it on disk.

See on a map which countries your captured requests went to, and filter the traffic list by country or destination.

Mock a response, add request headers, or answer from a local file with a rule in Extend, Override or Map Local mode on a host filter.

Write a rule path that matches, test it against a real URL before you save, and avoid the 4 patterns that never fire.

Hold a matching HTTPS or plain HTTP request before it reaches the server. Send it on, edit it or fail it with a status, or let a connected agent answer it.

Pass a host's HTTPS and plain HTTP traffic through without decrypting or recording it, for code signing, mTLS servers and apps that pin certificates.

ReqRes relays apps that pin their certificates, and the Apple services macOS pins, so they work while you capture. Forget a pin to decrypt it again.

Connect Claude Code, Claude Desktop, Cursor, Windsurf or another stdio MCP client to ReqRes, and check that the connection works.

Every ReqRes MCP tool, with what it does, its main arguments and limits, and whether ReqRes asks you before it runs.

How ReqRes asks you before an agent changes rules, host filters or capture, what each kind of change means, and how to allow a session.

What ReqRes redacts before captured traffic reaches an agent, how to send one host unmasked, and where the real values still exist.

Review every change an agent asked for in the activity log, undo rule, host filter and exclusion changes, and export the log to a file.

Recipes for common agent jobs with ReqRes, such as reproducing a bug, mocking an error, comparing 2 requests and keeping the evidence.

Run Diagnose Setup from the Capture menu to find the first thing that stops capture, and learn what each check means and what to do.

Find out why a request or an app is missing from ReqRes, or why HTTPS shows only connections, from setup and filters to tools that skip the proxy.

Fix HTTPS problems while ReqRes captures, from an untrusted certificate and codesign timestamp errors to pinned apps and node errors.

Find out why a rule never fires or changes a status it should keep, why a breakpoint holds nothing or too much, and what to do when a page hangs.

Fix an agent that cannot reach ReqRes, has its token rejected, is refused a change, or does not see its own requests in the traffic list.

Every keyboard shortcut in ReqRes, for capture, host filters, rules, search, the traffic list, saved sessions, Destinations and sheets.

What each ReqRes menu contains, what the menu bar icon shows while capturing or holding requests, and how to hide the icon.

What each tab of ReqRes Settings controls, from General and Capture to MCP, Storage and Breakpoints, with every option on the General tab.

What the free version of ReqRes includes, the 3 limits Pro removes, and what a Pro license covers (pay once, 2 Macs, every 1.x update).

Free a place on your ReqRes license from the license page, let an idle Mac release itself, get your key again by email, and what the online check does.

What ReqRes keeps on your Mac, what it writes to disk, and what leaves your Mac, from map tiles to license checks.

What ReqRes 1.1 captures for each protocol, from HTTPS, plain HTTP and WebSocket to HTTP/2, gRPC and streams, and what it only relays or never sees.

What changed in ReqRes 1.1, from an MCP server for AI agents and HTTP/2, gRPC and WebSocket messages to failed-request rows and a certificate per install.