Settings

Opening Settings

Open the settings panel from the menu bar: Rockxy → Settings or press Cmd+,.

Rockxy Settings panel (dark mode) — Rockxy Settings panel

General

Setting	Default	Description
Auto-Start Proxy	Off	Start the proxy server automatically when Rockxy launches
Record on Launch	On	Begin recording network traffic immediately on startup

Proxy

Setting	Default	Description
Proxy Port	`9090`	Local proxy server port. Change if another service occupies 9090
Listen Address	`127.0.0.1`	Network interface to bind. Use `0.0.0.0` to accept connections from other devices on your network
Excluded Hosts	(empty)	Comma-separated list of hosts to bypass the proxy entirely

Add noisy hosts like analytics.example.com or telemetry.sdk.io to the excluded list to keep your session focused on the traffic you care about.

Buffer Sizes

Buffer	Default	Description
Transaction Buffer	50,000	Maximum number of HTTP transactions held in the in-memory ring buffer
Log Buffer	100,000	Maximum number of log entries held in the in-memory ring buffer

When either buffer reaches capacity, the oldest 10% of entries are evicted — moved to the SQLite database or discarded depending on your retention settings. This keeps memory usage stable during long debugging sessions.

Log Capture

Toggle log capture on or off from the Log Capture section in Settings. When enabled, Rockxy captures logs from:

OSLog — system and application logs via OSLogStore (macOS 12+)
Process stdout/stderr — output from monitored processes
Custom sources — logs from installed plugins that conform to the log source protocol

Configure which sources are active and set minimum log level filters (Debug, Info, Warning, Error, Critical) per source.

MCP

Rockxy includes a dedicated Settings → MCP tab for local MCP integration.

Setting	Default	Description
Enable MCP Server	Off	Starts Rockxy’s local MCP backend and allows the bundled `rockxy-mcp` bridge to connect
MCP Configuration	Generated from your installed app path	Copyable JSON snippet for Claude Desktop and other MCP clients
Redact Sensitive Data Before Sending to AI	On	Redacts sensitive headers, query values, and supported body fields before Rockxy returns data to MCP clients

Important notes:

Rockxy’s MCP server is local-only
the generated config uses the exact installed path to rockxy-mcp
if you move Rockxy.app, copy the config again from this tab
Claude CLI and Claude Desktop use separate MCP config stores
Claude Desktop remote Connectors are not the right place for Rockxy’s local MCP bridge

For the full setup walkthrough, see MCP Integration.

Data Storage Locations

Rockxy stores data across several locations on disk:

Data	Location
User Preferences	`~/Library/Preferences/com.amunx.Rockxy.plist`
Root CA Key	macOS Keychain (managed by `KeychainHelper`)
Session Database	`~/Library/Application Support/Rockxy/sessions.db`
Large Bodies (>1MB)	`~/Library/Application Support/Rockxy/bodies/`
Rules	`~/Library/Application Support/Rockxy/rules.json`
Certificate Cache	`~/Library/Application Support/Rockxy/certs/`

The Root CA private key is stored in the macOS Keychain and protected by system-level access controls. Do not attempt to export or modify it manually — use Rockxy’s certificate management UI instead.

Getting Started

Core Debugging

Analysis & Productivity

Customization

Development

Opening Settings

General

Proxy

Buffer Sizes

Log Capture

MCP

Data Storage Locations

Next Steps

Keyboard Shortcuts

Traffic Capture

​Opening Settings

​General

​Proxy

​Buffer Sizes

​Log Capture

​MCP

​Data Storage Locations

​Next Steps

Keyboard Shortcuts

Traffic Capture

Opening Settings

General

Proxy

Buffer Sizes

Log Capture

MCP

Data Storage Locations

Next Steps