English | Tiếng Việt | 中文 | 日本語 | 한국어 | Français | Deutsch
The open-source, auditable HTTP debugging proxy for macOS.
Intercept, inspect, and modify HTTP/HTTPS/WebSocket/GraphQL traffic with a native Swift app you can inspect, build, and trust.
A local-first, AGPL-3.0 alternative to Proxyman and Charles Proxy.
Release Platform Swift License PRs Welcome Sponsor
v0.27.0 — 2026年06月16日
- Fixed Pro license settings so Mac activation counts and plan names reflect the correct Mac-specific activation limit instead of a combined provider limit.
See CHANGELOG.md for the full release history.
- Upstream Proxy now includes free/core Automatic Proxy Configuration with PAC URL routing for
DIRECT, HTTP, and HTTPS routes while preserving existing SOCKS5 and authentication policy boundaries. - Export workflows now cover OpenAPI YAML/HTML and selected-traffic Gist publishing with redaction-aware payload building.
- Inspector tools now include JSONPath/key/value filtering and quick previews for selected payload text such as JWTs.
- Node.js Developer Setup now mirrors the selected client during validation and has a fuller localhost sample guide.
- Developer Setup Hub now covers runtimes, browsers, clients, devices, frameworks, and environments with target-specific snippets, validation watchers, and honest guide content.
- WebSocket Protobuf work continues as part of Rockxy's richer protocol inspection direction.
The tools you reach for when browser DevTools are not enough. Core traffic debugging for Mac and iOS work — native on macOS, with public releases and a local-first workflow.
Rockxy capturing HTTP, HTTPS, WebSocket, and GraphQL traffic with a timing waterfall
Inspect HTTP, HTTPS, WebSocket, and GraphQL traffic from any Mac app, CLI, or iOS device. Browser DevTools end at the browser — Rockxy sees the rest of your stack.
HTTP / HTTPS · WebSocket · GraphQL · iOS Device & Simulator · Filter by Process ID · Timing Waterfall
Rockxy advanced filtering with multi-field filters and full-text search across a session
Narrow thousands of captured requests in seconds. Combine method, host, status, header, body, and process filters — or run a full-text search across the whole session.
Multi-Field Filters · Full-Text Search · Status / Method · Header / Body Match · Process / Host · Saved Filters
Rockxy local MCP server exposing captured traffic to Claude Desktop and Cursor
Let Claude Desktop or Cursor read your captured traffic through a local MCP server. Ask "why did this 500?" instead of pasting headers into chat. Free MCP server — no paid AI add-on or upsell, no usage cap.
Claude Desktop · Cursor · Local stdio · Redaction · Open Source
Rockxy Developer Setup Hub with copy-paste proxy snippets and one-click verify
Copy-paste proxy snippets for Python, Node.js, Go, Rust, cURL, Docker, and browsers, then click Run Test to confirm traffic is actually flowing.
Python · Node.js · Go / Rust / Java · cURL / Docker · One-Click Verify · Trust Diagnostics
Rockxy certificate management with a P-256 ECDSA root CA sealed in the Keychain
A P-256 ECDSA root CA generated on first launch, sealed in your Keychain. Decrypt HTTPS on the first try; pinned hosts pass through automatically.
P-256 ECDSA Root CA · Keychain-Sealed Key · Per-Host Leaf Certs · Trust Wizard · Pinned-Host Passthrough · Rotate / Reset
Pick which hosts get TLS decryption. Decrypted traffic shows real headers and JSON; everything else passes through encrypted. Wildcard rules let you scope by domain in one click.
Per-Host Decryption · Wildcard Rules · Allow / Deny List · TLS 1.2 / 1.3 · Pinned Host Passthrough
Rockxy bypass proxy list skipping cert-pinned apps and noisy telemetry hosts
Skip specific hosts so cert-pinned apps, internal services, or noisy telemetry never enter the capture. Wildcards keep the list short and your request log focused on what you actually care about.
Per-Host Bypass · Wildcard Patterns · Skip Pinned Hosts · Mute Telemetry · Reduce Noise · Toggle Anytime
Rockxy block list dropping ad networks and flaky dependencies to simulate outages
Make any host fail. Drop ad networks, third-party trackers, or a flaky dependency to see how your app degrades when it's gone — without changing a line of code.
Per-Host Block · Wildcard Match · Simulate Outage · Test Fallbacks · Strip Trackers · Toggle Anytime
Rockxy Map Local serving a saved file or directory tree in place of a live response
Serve a saved file or a directory tree in place of a live response. Swap a JSON payload, replay a snapshot, or pin a flaky third-party API to a local copy while you debug.
File or Directory · Response Snapshot · Regex Patterns
Rockxy Map Remote rewriting a request destination from production to staging
Rewrite the destination of a captured request without touching app code or /etc/hosts. Point production traffic at staging, your dev server, or a colleague's machine for a reproducible bug repro.
Host Rewrite · Regex Patterns · Preserve Host Header
Rockxy breakpoints pausing a request to edit method, headers, body, or status mid-flight
Pause a request or response, edit method, headers, body, or status, then continue. The fastest way to test "what if the API returns 401?" without touching the backend.
Request Breakpoints · Response Breakpoints · Block · Throttle · Regex / Wildcard Match · Inject Failure States
Rockxy modifying request and response headers per host with CORS and auth presets
Add, remove, or replace headers on any host without redeploying. Test CORS, auth, or cache changes in seconds with built-in presets.
Add / Remove / Replace · CORS Presets · Auth Stripping · Request Phase · Response Phase · URL Pattern Scope
Rockxy custom request and response header rules injecting tokens and stripping cookies
Override headers per host with full control over both phases. Inject auth tokens on outgoing requests, strip Set-Cookie on responses, or pin a custom User-Agent — saved as named rules you can toggle anytime.
Per-Host Override · Request Phase · Response Phase · Auth Token Inject · Cookie Strip · Named Rules
Rockxy network conditions throttling traffic to 3G, EDGE, LTE, or custom latency
Throttle to 3G, EDGE, LTE, WiFi, or a custom delay. Your laptop is on fiber; your users aren't — see the UX at 400 ms RTT before they do.
3G · EDGE · LTE · WiFi · Very Bad Network · Custom Latency
Rockxy Compose editing and replaying a captured HTTP request without leaving the app
Rebuild any captured HTTP request — change method, URL, headers, query params, or body — and re-send without leaving Rockxy. No Postman, Insomnia, or curl copy-paste loop. Iterate on LLM prompts, fuzz auth boundaries, or reproduce a failing case for OpenAI, Anthropic, and Cohere endpoints in seconds.
Edit Headers · Edit Body · Edit Query · Edit Method · LLM Prompt Iteration · Postman Alternative · OAuth Flow Debug · Webhook Replay
Rockxy comparing two captured responses side-by-side with JSON, header, and body diff
Stack two captured responses side-by-side and spot every field that flipped — status, headers, JSON keys, body bytes. Catch silent API regressions, non-deterministic LLM outputs, and prompt drift without piping anything into a third-party diff tool. Side-by-side diff highlights what changed; deep JSON compare ignores key ordering.
Diff Compare · Side-by-Side · JSON Diff · Header Diff · Body Diff · LLM Output Compare · Non-determinism · API Regression · Schema Drift
Rockxy custom inspector previewer tabs for JSON, GraphQL, JWT, and image bodies
Render request and response bodies the way you want. Pin extra tabs to the inspector for JSON, GraphQL, JWT, image, or your own format — reusable across every captured request.
JSON · GraphQL · JWT Decoder · Image / Hex · Custom Format · Pinned per Inspector
Rockxy session export to HAR, cURL, and JSON with secret redaction before sharing
Save sessions, import/export HAR for cross-tool handoff, copy any request as cURL or JSON. Redact authorization headers, cookies, and bearer tokens before sharing — hand a teammate a working bug repro without leaking secrets.
.rockxysession · HAR Import / Export · Copy as cURL · Copy as JSON · Raw HTTP · Secret Redaction · Token Sanitize · Privacy-Safe Share
Rockxy multi-tab workspaces running independent capture sessions side-by-side
Run independent capture sessions side-by-side — one tab for staging, one for prod, one for the iOS device build. Each tab has its own filters, selection, and inspector state, so context switching costs nothing.
Independent Sessions · Per-Tab Filters · Per-Tab Inspector · Compare Environments · Mac & iOS Together · Detach & Rename
Rockxy JavaScript scripting with request and response hooks and inline error feedback
JS hooks on requests and responses for the cases a static rule can't cover — redact PII, sign tokens, rewrite payloads. Errors surface inline instead of corrupting traffic.
Request Hooks · Response Hooks · Programmatic Filtering · PII Redaction · Inline Error Feedback
Send a captured session to a teammate with one click. Annotate failing requests inline, see who's looking at what in real time, and pair-debug HTTPS traffic without screen-sharing. Targeted for a future release.
Shared Sessions · Team Workspaces · Inline Comments · Live Cursor · Cloud Sync · Pair Debug · SSO · Audit Log
100% native macOS. No Electron. No web views. SwiftUI + AppKit + SwiftNIO.
git clone https://github.com/RockxyApp/Rockxy.git
cd Rockxy
open Rockxy.xcodeprojBuild and run in Xcode. The Welcome window guides you through root CA setup, helper installation, and proxy activation.
Requirements: macOS 14.0+, Xcode 16+, Swift 5.9
If you want to connect Rockxy to a local MCP client after installation, see the MCP Integration guide.
| Rockxy | Proxyman | Charles Proxy | |
|---|---|---|---|
| Project model | AGPL-3.0 open-source project | Proprietary commercial app | Proprietary commercial app |
| Source code | Public, auditable, forkable | Closed source | Closed source |
| Build from source | Free with Xcode from this repo | Not available from public source | Not available from public source |
| Native macOS foundation | Swift + SwiftNIO + SwiftUI/AppKit | Native macOS commercial app | Cross-platform commercial app |
| Local-first capture | Local proxy, certificates, helper, and capture data stay on your Mac | Desktop proxy app | Desktop proxy app |
| Developer setup workflow | Built-in Developer Setup Hub for runtimes, clients, devices, frameworks, and environments | Product-specific setup guidance | Product-specific setup guidance |
| External proxy + PAC routing | HTTP/HTTPS upstream proxy, PAC auto-configuration, and bypass rules | Mature commercial proxy tooling | Mature commercial proxy tooling |
| MCP/local automation bridge | Built in, token-authenticated, redaction by default | Not claimed in public docs reviewed | Not claimed in public docs reviewed |
| Open contribution path | Public issues, discussions, roadmap, and PRs | Vendor-controlled product | Vendor-controlled product |
On the roadmap: deeper replay/diff/rules/scripting workflows, improved WebSocket and GraphQL inspection, and exploration of gRPC/Protobuf plus HTTP/2 and HTTP/3 support.
Rockxy intercepts network traffic — security is foundational, not optional.
- XPC helper validates callers via certificate-chain comparison, not just bundle ID
- Plugins run in sandboxed JavaScriptCore with 5-second timeout, no filesystem/network access
- Input validation on all boundaries — body size caps, URI limits, regex DoS protection, path traversal prevention
- Credentials automatically redacted in captured logs
- Sensitive files stored with 0o600 permissions
Report vulnerabilities via SECURITY.md. See the full security architecture for details.
Rockxy's public roadmap is workflow-oriented and date-free. It focuses on reliability, native macOS UX, debugging workflows, protocol support, documentation, and contributor onboarding.
- ROADMAP.md: high-level public engineering direction
- Rockxy Public Roadmap: operational visibility for roadmap-tracked issues
Full documentation available at the Rockxy Docs:
- Quickstart Guide — get up and running in minutes
- Developer Setup Hub — runtime snippets, device guides, validation probes, and support matrix
- MCP Integration — connect Rockxy to local MCP clients
- Architecture — proxy engine, actor model, data flow
- Security Model — trust boundaries, XPC validation, certificate management
- Design Decisions — why SwiftNIO, NSTableView, actors
- Building from Source — build, test, lint, and debug
- Code Style — SwiftLint, SwiftFormat, and conventions
- Changelog — unreleased work and tagged releases
Contributions welcome — code, tests, docs, bug reports, and UX feedback.
See CONTRIBUTING.md for setup instructions, code style, and the full PR checklist.
Good first issues are labeled good first issue. By opening a PR, you agree to the CLA.
Rockxy is built and maintained by independent developers. Sponsorships fund continued development, security audits, and new features.
| Tier | Benefits |
|---|---|
| Gold Sponsor | Logo on README + docs site, priority feature requests, direct support channel |
| Silver Sponsor | Logo on README, named acknowledgment in release notes |
| Bronze Sponsor | Named acknowledgment in README and docs |
| Partner | Co-development, integration support, early access to upcoming features |
Partnership inquiries — developer tool companies, security firms, and enterprise teams looking for custom integrations or white-label solutions: rockxyapp@gmail.com
- GitHub Sponsors — support Rockxy's development
- GitHub Issues — bug reports and feature requests
- GitHub Discussions — questions and community chat
- Email — rockxyapp@gmail.com
- Security issues — see SECURITY.md for responsible disclosure
GNU Affero General Public License v3.0 — Copyright 2024–2026 Rockxy Contributors.
Made by Stephen. Built with Swift, SwiftNIO, SwiftUI, and AppKit.