# Rockxy

## Docs

- [Automatic Setup](https://docs.rockxy.io/automatic-setup/automatic-setup.md): Open a prepared Rockxy terminal or browser session for runtimes and tools that do not automatically follow the macOS system proxy.
- [Manual Setup](https://docs.rockxy.io/automatic-setup/manual-setup.md): Copy Rockxy's setup command into your own terminal so the current shell session can send traffic through Rockxy.
- [Automatic Setup Troubleshooting](https://docs.rockxy.io/automatic-setup/troubleshooting.md): Fix common Automatic Setup and Manual Setup problems, including missing traffic, HTTPS trust errors, stale sessions, browser profile issues, and localhost routing.
- [Changelog](https://docs.rockxy.io/changelog.md): Product updates and release history for Rockxy.
- [Filters and Search](https://docs.rockxy.io/core-features/filters-and-search.md): Filter HTTP traffic by app, domain, path, protocol, method, status, and content so you can find the one request that matters.
- [Logs and Timeline](https://docs.rockxy.io/core-features/logs-and-timeline.md): Use Rockxy logs and request timing views to correlate API failures, latency, and client behavior during debugging.
- [Keyboard Shortcuts](https://docs.rockxy.io/customization/keyboard-shortcuts.md): Current keyboard shortcuts for proxy control, sessions, tabs, navigation, rules, diff, and scripting
- [Settings](https://docs.rockxy.io/customization/settings.md): Configure Rockxy settings for proxy behavior, certificates, privacy, plugins, MCP, licensing, tools, and advanced helper diagnostics.
- [Architecture](https://docs.rockxy.io/development/architecture.md): SwiftNIO proxy engine, actor concurrency model, coordinator pattern, and module dependencies
- [Building](https://docs.rockxy.io/development/building.md): Build from source, run tests, lint, and set up your development environment
- [Code Style](https://docs.rockxy.io/development/code-style.md): SwiftLint rules, SwiftFormat configuration, naming conventions, and coding standards
- [Design Decisions](https://docs.rockxy.io/development/design-decisions.md): Why SwiftNIO, NSTableView, actors, the privileged helper, and key performance and storage design choices
- [Security Architecture](https://docs.rockxy.io/development/security.md): Layered security model, XPC trust boundaries, certificate trust, input validation, and vulnerability reporting
- [Request Diff](https://docs.rockxy.io/features/diff.md): Compare two captured transactions in a dedicated workspace with candidate pool, structured sections, and side-by-side or unified views.
- [GraphQL-over-HTTP Detection](https://docs.rockxy.io/features/graphql.md): Automatic detection and inspection of GraphQL operations sent as HTTP POST requests
- [HTTPS Interception](https://docs.rockxy.io/features/https-interception.md): Man-in-the-middle proxy for inspecting encrypted HTTPS traffic with automatic certificate generation
- [License Management](https://docs.rockxy.io/features/license-management.md): Understand Rockxy Pro's perpetual license, updates window, activation states, and how to activate, deactivate, restore, or transfer a license on macOS.
- [MCP Integration](https://docs.rockxy.io/features/mcp.md): Connect Rockxy to Claude CLI or Claude Desktop through Rockxy's local MCP bridge so AI tools can inspect captured traffic safely.
- [Network Conditions](https://docs.rockxy.io/features/network-conditions.md): Simulate slow networks with latency presets applied to proxied HTTP and HTTPS requests.
- [Pro Features](https://docs.rockxy.io/features/pro-features.md): Understand what Rockxy Pro unlocks today, what remains in Community, and where Pro adds value in the current app.
- [Request Replay](https://docs.rockxy.io/features/request-replay.md): Re-send captured HTTP requests with optional editing for iterative API testing and debugging.
- [Traffic Rules](https://docs.rockxy.io/features/rules.md): Use Rockxy traffic rules to intercept, rewrite, block, or delay requests and responses during API debugging on macOS.
- [JavaScript Scripting](https://docs.rockxy.io/features/scripting.md): Create JavaScript scripts to inspect, modify, mock, or filter traffic passing through the proxy.
- [Sessions & HAR](https://docs.rockxy.io/features/sessions.md): Save, open, import, and export captured traffic using native .rockxysession files or the industry-standard HAR format.
- [Traffic Capture](https://docs.rockxy.io/features/traffic-capture.md): Capture, inspect, and filter HTTP/HTTPS network traffic from any application
- [WebSocket Inspection](https://docs.rockxy.io/features/websocket.md): Capture and inspect WebSocket frames including text, binary, ping/pong, and close messages
- [Workspaces](https://docs.rockxy.io/features/workspaces.md): Native macOS tabs that split a single capture into independently filtered, sorted, and inspected views.
- [Certificates and Trust](https://docs.rockxy.io/getting-started/certificates-and-trust.md): Learn how Rockxy inspects HTTPS traffic on macOS, what the local root certificate does, and how to fix common certificate trust problems.
- [Developer Setup Hub](https://docs.rockxy.io/getting-started/developer-setup-hub.md): Use Rockxy's Developer Setup Hub to configure runtimes, browsers, frameworks, simulators, and devices with both manual setup and automation-aware workflows.
- [First Capture Checklist](https://docs.rockxy.io/getting-started/first-capture.md): Use this checklist to verify proxy startup, certificate trust, and client routing when Rockxy is not capturing traffic the way you expect.
- [Overview](https://docs.rockxy.io/index.md): Rockxy is a native macOS HTTP debugging proxy for inspecting HTTPS traffic, replaying requests, debugging mobile apps, exporting HAR, and troubleshooting API calls.
- [Installation](https://docs.rockxy.io/installation.md): Install Rockxy on macOS, trust the root certificate for HTTPS inspection, understand local storage, and build from source if needed.
- [Quick Start](https://docs.rockxy.io/quickstart.md): Learn how to inspect HTTPS traffic on macOS with Rockxy in a few minutes, including certificate trust, first capture, and replay.
- [Block and Allow Lists](https://docs.rockxy.io/rules/block-and-allow-lists.md): Use Rockxy block and allow lists to remove noise, isolate the requests you care about, and keep debugging sessions focused.
- [Breakpoints](https://docs.rockxy.io/rules/breakpoints.md): Pause HTTP requests and responses in Rockxy, edit them live, and continue the request only after you have changed what matters.
- [Map Local](https://docs.rockxy.io/rules/map-local.md): Mock an HTTP response in Rockxy by returning a local file for a matching request, without waiting for backend changes.
- [Map Remote](https://docs.rockxy.io/rules/map-remote.md): Rewrite a request destination in Rockxy so traffic goes to a different host, port, path, or protocol during debugging.
- [Modify Headers](https://docs.rockxy.io/rules/modify-headers.md): Add, replace, or remove request and response headers in Rockxy to test auth, caching, routing, and proxy-sensitive behavior.
- [Android Device](https://docs.rockxy.io/setup-guides/android-device.md): Configure a physical Android device to use Rockxy with Wi-Fi proxy setup, user CA trust, and debug-build requirements.
- [Android Emulator](https://docs.rockxy.io/setup-guides/android-emulator.md): Configure Android Emulator to use Rockxy with emulator proxy setup, certificate trust, and debug-build guidance.
- [Browsers and API Clients](https://docs.rockxy.io/setup-guides/browsers-and-api-clients.md): Configure browsers and API clients such as Firefox, Postman, Insomnia, and Paw to send HTTP and HTTPS traffic through Rockxy.
- [cURL](https://docs.rockxy.io/setup-guides/curl.md): Configure cURL to use Rockxy with direct proxy flags or environment variables for fast validation and debugging.
- [Device Debugging](https://docs.rockxy.io/setup-guides/device-debugging.md): Browse Rockxy setup guides for iOS, Android, tvOS, watchOS, and Vision Pro device or simulator traffic debugging.
- [Docker](https://docs.rockxy.io/setup-guides/docker.md): Configure Docker containers to send HTTP and HTTPS traffic through Rockxy using host.docker.internal and mounted certificate trust.
- [ElectronJS](https://docs.rockxy.io/setup-guides/electronjs.md): Configure Electron apps to use Rockxy through CLI proxy flags or session.setProxy with certificate trust for HTTPS inspection.
- [Environments](https://docs.rockxy.io/setup-guides/environments.md): Browse Rockxy setup guides for environment-oriented targets such as Docker.
- [Firefox](https://docs.rockxy.io/setup-guides/firefox.md): Configure Firefox to use Rockxy by setting the browser proxy and importing the Rockxy root certificate into Firefox.
- [Flutter](https://docs.rockxy.io/setup-guides/flutter.md): Configure Flutter apps to use Rockxy with Dart or Dio client setup plus the underlying iOS or Android trust path.
- [Frameworks](https://docs.rockxy.io/setup-guides/frameworks.md): Browse Rockxy setup guides for Flutter, React Native, Next.js, and ElectronJS application frameworks.
- [Golang](https://docs.rockxy.io/setup-guides/golang.md): Configure Go HTTP clients to use Rockxy for HTTPS inspection and API debugging.
- [Insomnia](https://docs.rockxy.io/setup-guides/insomnia.md): Configure Insomnia to use Rockxy for HTTPS inspection and API debugging.
- [iOS Device Setup](https://docs.rockxy.io/setup-guides/ios-device.md): Capture HTTP and HTTPS traffic from an iPhone or iPad with Rockxy by configuring Wi-Fi proxy settings and trusting the certificate on the device.
- [iOS Simulator Setup](https://docs.rockxy.io/setup-guides/ios-simulator.md): Capture HTTP and HTTPS traffic from iOS Simulator with Rockxy, including proxy behavior, certificate trust, and common simulator debugging issues.
- [Java VMs](https://docs.rockxy.io/setup-guides/java-vms.md): Configure Java and Kotlin HTTP clients to use Rockxy by importing the root certificate into the JVM trust store.
- [Next.js](https://docs.rockxy.io/setup-guides/nextjs.md): Configure Next.js server-side traffic to use Rockxy with App Router route handlers, proxy env vars, and certificate trust for fetch.
- [Node.js](https://docs.rockxy.io/setup-guides/nodejs.md): Configure Node.js HTTP clients to use Rockxy for HTTPS inspection and API debugging.
- [Paw](https://docs.rockxy.io/setup-guides/paw.md): Configure Paw to use Rockxy with the macOS system proxy and certificate trust flow.
- [Postman](https://docs.rockxy.io/setup-guides/postman.md): Configure Postman to use Rockxy for HTTPS inspection and API debugging on macOS.
- [Python](https://docs.rockxy.io/setup-guides/python.md): Configure Python HTTP clients to use Rockxy for HTTPS inspection, replay, and API debugging on macOS.
- [React Native](https://docs.rockxy.io/setup-guides/react-native.md): Configure React Native apps to use Rockxy with platform-specific trust, fetch validation, Android debug XML, and Metro-aware troubleshooting.
- [Ruby](https://docs.rockxy.io/setup-guides/ruby.md): Configure Ruby HTTP clients to use Rockxy for HTTPS inspection and debugging.
- [Rust](https://docs.rockxy.io/setup-guides/rust.md): Configure Rust HTTP clients such as reqwest to use Rockxy for HTTPS inspection and debugging.
- [Terminal Runtimes and Frameworks](https://docs.rockxy.io/setup-guides/terminal-runtimes-and-frameworks.md): Browse Rockxy setup guides for programming languages, terminal runtimes, and framework-adjacent local development targets.
- [tvOS and watchOS](https://docs.rockxy.io/setup-guides/tvos-watchos.md): Follow Rockxy setup guidance for tvOS and watchOS by reusing the relevant iOS device or simulator trust and proxy flow.
- [Vision Pro](https://docs.rockxy.io/setup-guides/vision-pro.md): Follow Rockxy setup guidance for Vision Pro using the same manual trust and reachable-network path as an iOS-class device.
- [Capture Issues](https://docs.rockxy.io/troubleshooting/capture-issues.md): Fix the most common reasons Rockxy is not capturing HTTP or HTTPS traffic, including proxy startup, client routing, and runtime-specific setup.
- [Certificate and HTTPS Issues](https://docs.rockxy.io/troubleshooting/certificates-and-https-issues.md): Troubleshoot TLS errors, untrusted certificates, CONNECT-only capture, and other HTTPS inspection problems in Rockxy.
- [Device Setup Issues](https://docs.rockxy.io/troubleshooting/device-setup-issues.md): Troubleshoot iPhone, iPad, Android, simulator, and emulator traffic capture problems when Rockxy can capture on macOS but not on the target device.
- [FAQ](https://docs.rockxy.io/troubleshooting/faq.md): Quick answers to common Rockxy questions about HTTPS capture, devices, HAR export, replay, Pro licensing, and local MCP setup.
- [Helper and Proxy Issues](https://docs.rockxy.io/troubleshooting/helper-and-proxy-issues.md): Troubleshoot Rockxy proxy startup, helper tool state, port conflicts, listen-address issues, and system-proxy control problems on macOS.
- [API Debugging on macOS](https://docs.rockxy.io/use-cases/api-debugging-on-macos.md): Use Rockxy as a native macOS API debugging tool to inspect HTTPS requests, replay calls, export HAR, and troubleshoot real client traffic.
- [Browser DevTools vs a System Proxy Debugger](https://docs.rockxy.io/use-cases/browser-devtools-vs-system-proxy-debugger.md): Learn when browser DevTools are enough and when a system-level proxy debugger like Rockxy is the better tool for API and HTTPS inspection.
- [Mobile App Network Debugging](https://docs.rockxy.io/use-cases/mobile-app-network-debugging.md): Debug iOS and Android app traffic with Rockxy, including setup, HTTPS trust, replay, and targeted request modification.

## OpenAPI Specs

- [openapi](https://docs.rockxy.io/api-reference/openapi.json)

## Optional

- [GitHub](https://github.com/RockxyApp/Rockxy)
- [Releases](https://github.com/RockxyApp/Rockxy/releases)