Documentation
Learn WireLens.
Set up capture on your Mac or iPhone, decrypt HTTPS, then use every tool, from breakpoints and Map Local to the command line and the MCP server.
Quick startFrom download to your first decrypted request in about five minutes, on Mac or iPhone.Install WireLens for MacDownload WireLens, trust its certificate, approve the capture helper once and start capturing.Install WireLens for iPhone and iPadCapture every app on your iPhone or iPad, on the device itself, through a local VPN that never leaves it.The WireLens root certificateWhy WireLens needs a trusted root certificate to decrypt HTTPS, and how to install, trust, export and remove it on Mac, iPhone and every runtime.
Get started
- Quick startFrom download to your first decrypted request in about five minutes, on Mac or iPhone.
- Install WireLens for MacMacDownload WireLens, trust its certificate, approve the capture helper once and start capturing.
- Install WireLens for iPhone and iPadiOSCapture every app on your iPhone or iPad, on the device itself, through a local VPN that never leaves it.
- The WireLens root certificateWhy WireLens needs a trusted root certificate to decrypt HTTPS, and how to install, trust, export and remove it on Mac, iPhone and every runtime.
- How WireLens captures trafficWhat happens between your app and the server on Mac and on iPhone, and what WireLens can and cannot see.
Capture and decrypt
- SSL ProxyingChoose which hosts WireLens decrypts. Everything else is tunnelled untouched, so pinned apps and system services keep working.
- Capture other devicesMacUse your Mac as the proxy for an iPhone, iPad, Android device, another Mac, simulators and emulators.
- Client setup for tools and runtimesMacProxy and certificate settings you can paste for curl, Node, Python, Ruby, Go, Rust, Java, PHP, .NET, Docker, Electron, React Native and Flutter.
- Allow List and Block ListRecord only the hosts you care about, and refuse connections to the ones you want gone.
- HTTP/2, HTTP/3 and QUICHow WireLens handles HTTP/2 and gRPC, what the experimental HTTP/2 switch does, and how to keep HTTP/3 traffic visible.
- SOCKS, upstream proxies and reverse proxyMacCapture SOCKS clients, route WireLens through a corporate proxy, and put a local port in front of an origin for clients that cannot use a proxy.
- Client certificates and custom rootsPresent a client certificate to origins that require mutual TLS, override the certificate a host presents, or bring your own root.
Inspect
- The traffic listFind the request you care about in thousands: filter chips, the search syntax, columns, apps and domains.
- The inspectorHeaders, bodies, JSON trees, images, hex, cookies, tokens, timing and your own preview tabs, for every request and response.
- WebSocketFollow a WebSocket connection frame by frame, in both directions, with timing and payloads that open like any other body.
- gRPC, GraphQL and ProtobufRead the places modern APIs report failure. gRPC trailers, GraphQL errors under a 200, and Protobuf with or without your schemas.
- Sessions, HAR and session packagesEvery capture run is kept as a session. Browse them, reopen them, and move traffic in and out as HAR, CSV, OpenAPI or .wirelens packages.
Debugging tools
- BreakpointsPause a matching request or response, edit it, then execute it, abort it or give yourself more time.
- Map LocalAnswer matching requests with a status, headers and body from your device. The origin is never contacted.
- Map RemoteSend matching requests to a different scheme, host, port or path, without rebuilding the app.
- RewriteAdd, remove or replace headers and query parameters, change the method, host, path or status, or replace a body on matching traffic.
- ScriptingRun JavaScript on matching requests and responses. Edit headers, query and JSON bodies, mock responses, keep state and call other services.
- Network ConditionsAdd latency and jitter, cap bandwidth and inject connection failures, globally or for a single host.
- DNS SpoofingSend a hostname to an address you choose, for testing a server before its DNS changes or pointing an app at a local machine.
- Compose and repeatBuild a request from scratch, replay a captured one with edits, or repeat it many times and read the results.
Automation
- Command line (wirelens)MacQuery captures, export HAR, add rules and control capture from Terminal and scripts with the wirelens command.
- MCP for AI agentsMacLet Claude Code, Cursor, VS Code, Windsurf or Zed read your captures and, when you allow it, add rules and control capture.
- Raycast extensionMacToggle recording and the system proxy, search flows, flip settings and export HAR without leaving Raycast.
Teams and licensing
Help
- TroubleshootingThe problems people actually hit, in the order they usually hit them, with the fix for each.
- Keyboard shortcutsMacEvery shortcut in WireLens for Mac, grouped by menu.
- Where your data livesWhat WireLens stores on your device, how to clear it, and the few things that ever reach our servers.
Using an AI agent? The WireLens MCP server ships troubleshooting and rule guides of its own, plus a diagnose_setup tool that checks your live setup. See MCP for AI agents.