Skip to content
ProxyPro

Download

ProxyPro ships in three forms: a pre-built .dmg for macOS (Apple Silicon or Intel, ad-hoc signed) hosted on GitHub Releases, a standalone engine binary for headless npx proxypro-harness use, and the source tree on GitHub for anyone who’d rather build it themselves.

Pre-built .dmg

ProxyPro v0.1.0-alpha.19 — Apple Silicon macOS arm64, ad-hoc signed, ~116 MB
ProxyPro v0.1.0-alpha.19 — Intel macOS x86_64, ad-hoc signed, ~121 MB

Install

  1. Download the .dmg from the card above
  2. Open it; drag ProxyPro.app into Applications
  3. Do the Gatekeeper workaround above that matches your macOS
  4. Continue with the Quickstart for cert install + proxy setup

Verify

Terminal window
shasum -a 256 ~/Downloads/proxypro-0.1.0-*.dmg

GitHub serves the .dmg over TLS from objects.githubusercontent.com, which is generally enough integrity assurance. If you want to belt-and- suspenders it, the build from source below produces the same bits from the tagged commit (v0.1.0-alpha.19).

Standalone engine (headless / npx proxypro-harness)

The proxypro-harness npm package ships the MCP server + Playwright glue but not the Go engine — it resolves the engine from an installed ProxyPro.app, the --engine flag, or the PROXYPRO_ENGINE env var. If you only want the headless harness and don’t install the GUI app, grab the standalone universal (arm64 + x86_64) engine from the release and point PROXYPRO_ENGINE at it:

Terminal window
curl -L -o engine.tar.gz \
  https://github.com/trongitnlu/proxypro/releases/download/v0.1.0-alpha.19/proxypro-engine-0.1.0-alpha.19-darwin-universal.tar.gz
tar -xzf engine.tar.gz
export PROXYPRO_ENGINE="$PWD/proxypro-engine"
npx proxypro-harness        # boots the engine + MCP server on 127.0.0.1:9091

Installing the .dmg already embeds this same engine, so GUI users need none of the above.

Build from source

The source build is small (~2 min on M-series macs) and gives you a fresh, ad-hoc-signed .app with no Gatekeeper warning (since macOS won’t have quarantined a file you compiled).

Terminal window
git clone https://github.com/trongitnlu/proxypro.git
cd proxypro
make bootstrap       # one-time: install Go protoc plugins + pnpm deps
make engine          # universal arm64+amd64 engine binary
make dist            # electron-builder packages .app + .dmg
open app/dist/mac/ProxyPro.app   # or drag from app/dist into Applications

Requirements: macOS 14+, Node 20 LTS, pnpm 9+, Go 1.22+. See the Quickstart for full details.

Why two distribution forms?

  • .dmg for non-developers — drag-to-Applications experience.
  • Source build for contributors — also useful if you don’t trust the binary and prefer to compile yourself.

Release notes

Latest: v0.1.0-alpha.19 (2026-07-04) — Full-permission AI copilot: the AI Copilot tab becomes a full local AI assistant with unrestricted control over ProxyPro (full access by default + persisted, with a Read-only toggle and mutation-log / Cancel / Restore-rules safety nets); agentic slash commands (/scenario, /autodebug, /mock) with a 10-minute turn budget (30-min ceiling) and elapsed timer; chat UX with @mention flows/rules, image/file attachments, a model picker, and edit-&-resend / regenerate (conversation forks); history search / rename / pin / Markdown export and the conversation cap raised 50→200; collapsible tool-call cards with inline rule-mutation change cards. Also fixes the SSL decrypt-mode toggle when attached to a shared engine. The Go engine is unchanged from alpha.17 (rebuilt + restamped).

Previously: v0.1.0-alpha.18 (2026-06-28) — Closed-loop AI debugging (proxypro-autodebug) + shared engine (attach-or-spawn) + AI traffic-comprehension MCP tools.

Earlier: v0.1.0-alpha.17 (2026-06-23) — AI copilot + WebSocket/SSE stream rules + JSON body editor. See the GitHub release for full notes, or the changelog for the cumulative history.

All releases live at github.com/trongitnlu/proxypro/releases.

For maintainers — how this page is updated

  1. Local build: make release VERSION=vX.Y.Z (builds + smoke-tests both arch dmgs + skill zip; stamps the engine version)
  2. Manual browser E2E (the smoke script doesn’t cover browser_*): launch the packaged app, claude mcp add --transport http proxypro http://127.0.0.1:9091/mcp, confirm the browser tools are listed, then browser_launch → browser_goto → the request appears in the GUI capture list → browser_close
  3. Tag + push: git tag -a vX.Y.Z -m "..." && git push origin vX.Y.Z
  4. Package the standalone engine: tar -czf proxypro-engine-X.Y.Z-darwin-universal.tar.gz -C engine/bin proxypro-engine
  5. Create the release with gh release create vX.Y.Z --notes-file notes.md and the four assets: both .dmg files + the engine tarball + proxypro-claude-skill.zip (all from app/dist/, engine tarball wherever step 4 wrote it)
  6. Edit the href on the two LinkCards above + the engine curl URL in the “Standalone engine” section to point at the new version (DMG URL pattern is github.com/trongitnlu/proxypro/releases/download/vX.Y.Z/proxypro-X.Y.Z-<arch>.dmg)
  7. Git push — Cloudflare Pages rebuilds + redeploys automatically