> ## Documentation Index
> Fetch the complete documentation index at: https://rockxy-develop.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Get Rockxy running and capturing network traffic in under 5 minutes.

# Quick Start

This guide takes you from download to inspecting your first captured request in about 5 minutes. Rockxy is a free, native macOS app — no account, no license key, no cloud dependency.

## 1. Download Rockxy

Grab the latest release from [GitHub Releases](https://github.com/LocNguyenHuu/Rockxy/releases). Rockxy currently ships a universal `.dmg` that supports both Apple Silicon and Intel Macs.

## 2. Install

Open the `.dmg` and drag **Rockxy.app** to the **Applications** folder. Launch it from Applications or Spotlight.

If macOS blocks the app, right-click it and select **Open**, then click **Open** again in the confirmation dialog.

## 3. Trust the Root CA

<Warning>
  HTTPS interception will not work until you install and trust the root CA certificate. Skip this step only if you need to capture plain HTTP traffic.
</Warning>

1. In the Rockxy menu bar, go to **Certificate > Install Root CA**.
2. Enter your macOS password to add the certificate to your system keychain.
3. Open **Keychain Access**, find **Rockxy CA**, double-click it.
4. Expand **Trust** and set **When using this certificate** to **Always Trust**.
5. Close the dialog and enter your password to confirm.

The root CA private key is stored in your macOS Keychain and never leaves your machine. Per-host certificates are generated on the fly during HTTPS interception.

## 4. Start Capturing Traffic

Click the **Start** button in the toolbar or use the keyboard shortcut. Rockxy sets itself as the system HTTP/HTTPS proxy and begins capturing traffic from all applications.

<Tip>Press **Cmd+Shift+R** to toggle traffic capture on and off.</Tip>

Open a browser or any app that makes network requests. You will see requests appear in the request list in real time.

<Frame caption="Rockxy capturing live HTTP and HTTPS traffic.">
  <img className="block dark:hidden" src="https://mintlify.s3.us-west-1.amazonaws.com/rockxy-develop/images/traffic-capture.png" alt="Rockxy traffic capture view" />

  <img className="hidden dark:block" src="https://mintlify.s3.us-west-1.amazonaws.com/rockxy-develop/images/traffic-capture-dark.png" alt="Rockxy traffic capture view (dark mode)" />
</Frame>

## 5. Inspect a Request

Click any request in the list to open the inspector panel. The inspector has several tabs:

* **Headers** — request and response headers, status code, HTTP version.
* **Body** — request and response bodies with syntax highlighting for JSON, XML, HTML, and other formats.
* **Cookies** — parsed cookie key-value pairs from both request and response.
* **Timing** — connection timing breakdown: DNS, TLS handshake, time to first byte, total duration.
* **Raw** — the complete raw HTTP message for both request and response.

For WebSocket connections, you will see individual frames listed with their opcode, direction, and payload.

## 6. Explore Logs

Switch to the **Logs** tab in the sidebar to see captured application logs from OSLog streams and process stdout/stderr. Logs are correlated with network requests by timestamp and process, so you can trace a request from the network layer through to the application log output.

## 7. Connect Rockxy to Claude

If you want to inspect traffic that Rockxy captures for Claude, open **Settings → MCP** in Rockxy, turn on **Enable MCP Server**, and copy the generated config snippet.

Rockxy uses a **local MCP** setup for Claude CLI and Claude Desktop. It is not configured through Claude's remote **Connectors** flow.

For the full setup guide, including Claude CLI and Claude Desktop instructions, see [MCP Integration](/features/mcp).

## Next Steps

<CardGroup cols={2}>
  <Card title="HTTPS Interception" icon="lock" href="/features/https-interception">
    How Rockxy decrypts TLS traffic and manages certificates.
  </Card>

  <Card title="Traffic Rules" icon="filter" href="/features/rules">
    Set breakpoints, map requests to local files, block or throttle endpoints.
  </Card>

  <Card title="Log Intelligence" icon="scroll" href="/features/log-intelligence">
    Capture and correlate OSLog streams with network requests.
  </Card>

  <Card title="Keyboard Shortcuts" icon="keyboard" href="/customization/keyboard-shortcuts">
    All available keyboard shortcuts for fast navigation.
  </Card>

  <Card title="Sessions & HAR" icon="floppy-disk" href="/features/sessions">
    Save, restore, import, and export captured traffic.
  </Card>

  <Card title="MCP Integration" icon="plug" href="/features/mcp">
    Connect Rockxy to Claude and inspect flows directly from your chat.
  </Card>
</CardGroup>