explaingit

proxymanapp/proxyman

6,819Audience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A native macOS app that captures and displays all HTTP and HTTPS network traffic from Mac apps, iPhones, and Android devices, with tools to pause, modify, and script requests for debugging.

Mindmap

mindmap
  root((repo))
    Traffic Capture
      Mac Apps
      iPhone
      Android
    Debugging Tools
      Breakpoints
      Request Redirect
      Scripting
    Network Simulation
      Slow Connections
      Request Blocking
    Team Features
      HAR File Sharing
      Role Permissions
    Installation
      Direct Download
      Homebrew
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Inspect every HTTP and HTTPS request your iOS app makes to debug API issues without adding logging code.

USE CASE 2

Set a breakpoint to pause and modify a network request mid-flight before it reaches the server.

USE CASE 3

Simulate slow network conditions to test how your app behaves on a poor connection.

USE CASE 4

Share captured network logs as HAR files with teammates to diagnose API problems together.

Tech stack

SwiftSwiftNIOmacOS

Getting it running

Difficulty · easy Time to first run · 30min

HTTPS interception requires installing a root certificate on each target device, a paid license is needed for continued use.

Proprietary, requires purchasing a license for continued use, a free version is available but ongoing development is supported by paid licenses.

In plain English

Proxyman is a macOS desktop application that lets developers see exactly what network requests their apps and devices are sending and receiving. It works as a proxy, sitting between your apps and the internet so it can record and display every HTTP and HTTPS communication in a readable format. You can watch traffic coming from a Mac, an iPhone, or an Android device all in one place. The app is built natively for macOS using Swift, Apple's programming language, and uses a framework called SwiftNIO to handle lots of network activity quickly. It supports Apple's newer chips (M1, M2, M3, M4) and was built for macOS 26 Tahoe. You can download it directly or install it with Homebrew, a popular Mac package manager. Beyond just watching traffic, Proxyman includes a set of debugging tools. You can pause requests mid-flight with a breakpoint, redirect traffic to a local file instead of the real server, simulate slow network conditions, block certain requests, and write scripts that modify requests or responses on the fly. A command palette lets you search and navigate without touching the mouse. These tools are aimed at developers who need to understand or fix problems in how their apps communicate with servers. There is also a separate iOS app that can capture HTTPS traffic directly on an iPhone without needing a Mac as an intermediary. Teams can use a paid workspace subscription to share logs and HAR files (a standard format for captured network sessions) with colleagues, with role-based permissions so admins and developers see different things. Support is available through GitHub, Discord, and email. The project is maintained by a small engineering team and asks users to buy a license to support ongoing development.

Copy-paste prompts

Prompt 1
I am debugging an iOS app and want to see all its HTTPS requests. How do I set up Proxyman on my Mac to intercept traffic from my iPhone and decrypt HTTPS?
Prompt 2
I need to test how my app handles a 500 error from a specific API endpoint. How do I use Proxyman to return a fake error response for that endpoint?
Prompt 3
My app behaves differently on slow connections. How do I use Proxyman to throttle bandwidth and simulate a 3G network?
Prompt 4
Show me how to write a Proxyman script that automatically adds an Authorization header to every request going to api.myservice.com.
Open on GitHub → Explain another repo

← proxymanapp on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.