Skip to content

RockxyApp/Rockxy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

300 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Rockxy

Rockxy

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

Rockxy running on macOS


Latest Tagged Release

v0.19.1 — 2026-05-17

Fixed

  • Restored access to the License settings pane for activating, restoring, and managing Rockxy Pro.

See CHANGELOG.md for the full release history.

Current Branch Highlights

  • 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.
  • HTTPS response prompts, sidebar actions, and the request table now stay in sync when SSL proxying is enabled or disabled by domain or app.
  • The inspector and main request table were polished with scrolling tabs, top-aligned query content, clearer status/code separation, request/response byte columns, duration fixes, and live SSL state icons.

Features

Traffic Capture — SwiftNIO proxy with CONNECT tunnel, auto-generated per-host TLS certificates, WebSocket frame capture, and automatic GraphQL operation detection.

Inspect Everything — JSON tree viewer, hex inspector, timing waterfall (DNS/TCP/TLS/TTFB/Transfer), headers, cookies, query params, auth — all in a tabbed inspector.

Mock & Modify — Map Local (serve from files), Map Remote (redirect to another server), Breakpoints (pause and edit mid-flight), Block, Throttle, Modify Headers, Allow List, Bypass Proxy.

Log Correlation — Capture macOS logs (OSLog) and correlate them with network requests by timestamp. See which app made each request.

Extend with Plugins — JavaScript scripting in a sandboxed JavaScriptCore runtime. Inspect, modify, and automate traffic with custom hooks.

Built for Scale — NSTableView virtual scrolling handles 100k+ requests. Ring buffer eviction, disk body offloading, batched UI updates. Zero lag.

Developer Setup Hub — Guided setup per runtime, browser, device, framework, and environment with copyable snippets, validation probes, and troubleshooting notes.

Local MCP Bridge — Bundled Model Context Protocol server lets local MCP clients query live traffic, rules, and proxy status. Local-only, token-authenticated, sensitive data redacted by default.

100% native macOS. No Electron. No web views. SwiftUI + AppKit + SwiftNIO.

Quick Start

git clone https://github.com/RockxyApp/Rockxy.git
cd Rockxy
open Rockxy.xcodeproj

Build 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 vs. Alternatives

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
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.

Security

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.

Roadmap

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.

Documentation

Full documentation available at the Rockxy Docs:

Contributing

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.

Sponsors & Partners

Rockxy is built and maintained by independent developers. Sponsorships fund continued development, security audits, and new features.

Sponsor Rockxy

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

Support

License

GNU Affero General Public License v3.0 — Copyright 2024–2026 Rockxy Contributors.

Star History

Star History Chart

Made by Stephen. Built with Swift, SwiftNIO, SwiftUI, and AppKit.

Sponsor this project

 

Packages

 
 
 

Contributors

Languages