Rockxy Blog

Technical notes on local-first network debugging

Deep engineering write-ups on API, mobile, AI, WebSocket, GraphQL, Web3/RPC direction, HTTPS security, SwiftUI, AppKit, SwiftNIO, and native macOS debugging.

Strategy 11 min read

Local-First Network Evidence: Debugging API, Mobile, AI, and Web3 Traffic on macOS

Why modern debugging needs more than request visibility: capture real traffic, inspect it in context, replay failures, compare what changed, redact secrets, and share evidence without moving sensitive traffic off your Mac.

Rockxy Team
Rockxy Team Public strategy deep dive
Rockxy capturing API, mobile, AI, and Web3 traffic on macOS
ComparisonCommercial guide

Looking for a Proxyman alternative?

This shorter comparison page is the direct answer if you are evaluating native macOS proxy tools side by side.

Open the guide →
Rockxy showing app traffic and runtime trace events captured through the Babylon client on macOS
Engineering11 min read

Babylon: Proxy-Free Capture and Agent Runtime Traces in Rockxy

Babylon is a companion capture client that pairs with Rockxy and streams your app's HTTP, WebSocket, and runtime traces over an encrypted local connection — no system proxy and no CA certificate.

Rockxy Team
Rockxy TeamClient capture & runtime tracing
Rockxy capturing a localhost 127.0.0.1 request on macOS after the client was routed explicitly through the proxy
Troubleshooting9 min read

Why Localhost Traffic Isn't Showing in Your Proxy on macOS

Loopback requests to localhost and 127.0.0.1 skip the proxy by design. Route one client explicitly through Rockxy, clear the no-proxy list, and capture local traffic end to end.

Rockxy Team
Rockxy TeamLocal capture troubleshooting
Rockxy Map Local editor mocking an API response with a local JSON file on macOS
Tutorial8 min read

How to Mock an API Response on macOS with Map Local

Point one API URL at a local JSON file with Rockxy Map Local and test error and edge states without a backend change.

Rockxy Team
Rockxy TeamRules & mocking
Rockxy Diff Compare highlighting differences between two captured API responses on macOS
Tutorial9 min read

How to Compare Two API Responses on macOS with Diff Compare

Capture two flows and use Rockxy Diff Compare on macOS to see exactly what changed across status, headers, JSON body, and timing.

Rockxy Team
Rockxy TeamDiff & compare
Rockxy Breakpoint window pausing a request on macOS with editable method, URL, headers, and body
Tutorial9 min read

How to Intercept and Edit a Request with Breakpoints on macOS

Pause a live request or response with Rockxy Breakpoints on macOS, edit it in flight, and continue — test a fix before touching code.

Rockxy Team
Rockxy TeamRules & breakpoints
Rockxy capturing a request on macOS after proxy environment variables were set correctly
Troubleshooting10 min read

HTTP_PROXY, HTTPS_PROXY, and NO_PROXY on macOS: Why Your Proxy Variables Don't Work

Why HTTP_PROXY/HTTPS_PROXY get ignored and NO_PROXY silently drops your host on macOS — and how to route traffic into Rockxy.

Rockxy Team
Rockxy TeamProxy troubleshooting
Rockxy Map Remote rule rewriting a request's destination to staging or localhost on macOS
Tutorial8 min read

How to Redirect an API to Staging or Localhost with Map Remote on macOS

Point a shipped build at staging or localhost with no rebuild — Rockxy Map Remote rewrites a request's destination on macOS.

Rockxy Team
Rockxy TeamRules & routing
Rockxy upstream proxy configuration on macOS forwarding captured traffic to a corporate proxy with bypass rules
Tutorial9 min read

How to Debug Behind a Corporate Proxy on macOS by Chaining Rockxy Upstream

On a managed network every request must go through the company proxy. Chain Rockxy upstream to keep debugging.

Rockxy Team
Rockxy TeamUpstream proxy
Rockxy custom previewer tab showing a decoded GraphQL request and response on macOS
Tutorial8 min read

How to Debug GraphQL Requests over HTTP on macOS

Every GraphQL call is one POST to /graphql. Capture and read the query, variables, and response per operation in Rockxy on macOS.

Rockxy Team
Rockxy TeamGraphQL debugging
Rockxy session export view on macOS
Tutorial8 min read

How to Export and Import a HAR File on macOS

Export captured flows to a HAR bug report and import a teammate's HAR in Rockxy on macOS — redacting secrets before the file leaves your Mac.

Rockxy Team
Rockxy TeamSessions & export
Rockxy traffic capture request list on macOS
Troubleshooting8 min read

Requests Not Showing Up in Your Proxy on macOS: A Capture Checklist

An ordered triage checklist for when nothing shows up in your macOS proxy: capture state, client routing, HTTPS scope, certificate trust, and filters.

Rockxy Team
Rockxy TeamCapture troubleshooting
Rockxy local certificate and security management on macOS
Security8 min read

How to Redact Secrets and PII Before Sharing a Capture on macOS

A capture carries bearer tokens, cookies, and PII. Redact them in Rockxy first, then export a HAR or share a Workspace link — safe to hand off.

Rockxy Team
Rockxy TeamSecurity
Rockxy SSL Proxying and HTTPS decryption on macOS with a decrypted request body
Tutorial8 min read

How to Install and Trust the Rockxy Root Certificate on macOS

HTTPS rows show only tunnels? Install and trust Rockxy's root certificate on macOS to decrypt the HTTPS traffic you own.

Rockxy Team
Rockxy TeamHTTPS & certificates
Rockxy Compose editing a captured request before replaying it on macOS
Tutorial8 min read

How to Replay a Failed API Request on macOS Without Reproducing It

Replay a captured failed API call in Rockxy on macOS, edit it with Compose, and diff the result — no driving the app to reproduce it.

Rockxy Team
Rockxy TeamReplay & compose
Rockxy certificate management for local HTTPS debugging
Security10 min read

Trust, TLS, and Redaction: A Security Model for Local HTTP Debugging

How Rockxy structures certificate trust, per-host HTTPS decryption, helper boundaries, input limits, stored traffic, and redaction before sharing.

Rockxy Team
Rockxy TeamSecurity architecture
Rockxy native macOS diff workflow
Engineering12 min read

Inside a Native macOS Network Debugger: SwiftUI, AppKit, SwiftNIO, and Secure Code Structure

A technical look at Rockxy's native Swift architecture: SwiftUI surfaces, AppKit scale points, SwiftNIO proxy flow, actors, and helper boundaries.

Rockxy Team
Rockxy TeamNative macOS engineering
Rockxy Developer Setup Hub on macOS with language setup targets
Tutorial9 min read

How to Debug Go (net/http) API Requests on macOS

Go's net/http client won't route through your proxy or trust the debug cert by default. Capture Go API requests in Rockxy with explicit proxy and CA config.

Rockxy Team
Rockxy TeamGo debugging
Rockxy capturing app network traffic on macOS
Tutorial8 min read

How to Debug Ruby (Net::HTTP and Faraday) API Requests on macOS

Ruby's Net::HTTP and Faraday route through a proxy only when told to. Capture Ruby API requests in Rockxy with explicit proxy and CA settings.

Rockxy Team
Rockxy TeamRuby debugging
Rockxy Block List on macOS blocking a request to inject a failure
Tutorial10 min read

How to Simulate a Slow or Failing Network on macOS with Rockxy

Fast wifi hides your loading, timeout, and error states. Throttle, delay, or fail requests in Rockxy on macOS to test them before shipping.

Rockxy Team
Rockxy TeamNetwork conditions
Rockxy advanced filter and search narrowing a request list on macOS
Tutorial8 min read

How to Filter and Search Thousands of HTTP Requests on macOS

Isolate one flow from thousands with Rockxy's multi-field filters, saved filters, and JSONPath body matching on macOS.

Rockxy Team
Rockxy TeamFilters & search
Rockxy local MCP integration on macOS exposing captured flows to an AI assistant
Tutorial8 min read

How to Let Claude or Cursor Debug Your Captured Traffic with Local MCP on macOS

Rockxy's local MCP lets Claude, Cursor, or any MCP client list, read, replay, and diff your captured flows on macOS — no more pasting request dumps into chat.

Rockxy Team
Rockxy TeamLocal MCP
Rockxy custom previewer tab decoding a binary WebSocket frame on macOS
Tutorial8 min read

How to Inspect WebSocket and Protobuf Frames on macOS

Capture a WebSocket in Rockxy on macOS, read its frames in order, and decode binary Protobuf frames without a schema to find the message that broke your UI.

Rockxy Team
Rockxy TeamWebSocket debugging
Rockxy showing a captured request ready to copy as curl on macOS
Tutorial7 min read

How to Copy Any Captured Request as cURL on macOS

Select any captured flow in Rockxy and Copy as cURL to reproduce the exact request — method, headers, and body — in a terminal or a bug report.

Rockxy Team
Rockxy TeamcURL export
Rockxy Workspace sharing a sanitized capture as a scoped browser link on macOS
Workspace7 min read

Share a Debugging Session With Your Team Without Leaking Secrets

Rockxy Workspace turns a local macOS capture into a sanitized, scoped browser link — redact secrets locally, then share with your team. The Team tier, $9/seat/month.

Rockxy Team
Rockxy TeamWorkspace launch
Rockxy capturing app network traffic on macOS
Tutorial

How to Debug React Native API Requests on macOS

Capture React Native API traffic across JavaScript fetch calls, native SDKs, simulators, emulators, and devices with a local macOS proxy.

Rockxy capturing Flutter traffic on macOS
Tutorial12 min read

Advanced Flutter API Debugging on macOS with Rockxy

A production-style workflow for Flutter HTTPS, localhost, emulator/device routing, headers, mapping, blocking, latency, replay, and scripting.

Rockxy Team
Rockxy TeamAdvanced Flutter debugging guide
Rockxy upstream proxy and WebSocket Protobuf decoding
Guide15 min read

How to Use Upstream Proxy and WebSocket Protobuf Decoding in Rockxy

Route Rockxy through an upstream HTTP or HTTPS proxy, configure bypass rules, and decode binary WebSocket Protobuf frames without a schema.

Rockxy Team
Rockxy TeamProxy & WebSocket guide
Rockxy capturing Node.js localhost traffic on macOS
Tutorial8 min read

How to Debug Node.js API Requests on macOS

Start with one known localhost request, prove the proxy route in Rockxy, then move to axios, Node core, got, and HTTPS certificate trust.

Rockxy Team
Rockxy TeamNode.js debugging guide
Rockxy capturing Python localhost traffic on macOS
Tutorial7 min read

How to Debug Python API Requests on macOS

Start with one known localhost request, prove the proxy route in Rockxy, then move to requests, httpx, aiohttp, urllib3, and HTTPS certificate trust.

Rockxy Team
Rockxy TeamPython debugging guide
Rockxy capturing Flutter traffic on macOS
Tutorial7 min read

How to Debug Flutter API Requests on macOS

The shortest path from "my Flutter app is timing out" to "I can see the real request, response, headers, and TLS behavior."

Rockxy Team
Rockxy TeamFlutter debugging guide
MCP debugging workflow in Rockxy
Case Study8 min read

Debugging a Failing Stripe Webhook with Claude and Rockxy

A real debugging session using Rockxy capture plus MCP tools to isolate a failing Stripe webhook flow in minutes.

Rockxy Team
Rockxy TeamDebugging case study
Rockxy MCP integration interface
Integration6 min read

How to Connect Claude Desktop to Rockxy's MCP Server (3-Minute Setup)

A direct setup guide for connecting Claude Desktop to Rockxy so your assistant can inspect real captured traffic.

Rockxy Team
Rockxy TeamAI-assisted debugging
Rockxy MCP traffic view
Guide6 min read

MCP Servers for API Debugging on macOS — A Developer's Shortlist

What matters when you want an assistant to inspect local traffic, and which kinds of tools actually hold up in a real workflow.

Rockxy Team
Rockxy TeamTooling strategy
Rockxy MCP cover image
Primer7 min read

What Is an MCP Server? A Developer's Primer for 2026

A practical primer on MCP, why local tools fit stdio well, and how structured traffic access changes debugging workflows.

Rockxy Team
Rockxy TeamProtocol primer
Traffic capture interface in Rockxy
Comparison7 min read

Charles Proxy Alternatives for macOS in 2026

A side-by-side look at the main HTTP debugging tools on macOS and the trade-offs that actually matter in day-to-day use.

Rockxy Team
Rockxy TeamComparison guide
Certificate management in Rockxy
Security7 min read

How Rockxy Intercepts HTTPS Without Compromising Security

A technical walkthrough of certificate trust, per-host leaf certificates, and why local HTTPS interception does not need to be opaque.

Rockxy Team
Rockxy TeamSecurity deep dive
Rockxy workspace interface
Engineering8 min read

Virtual-Scrolling 100k Network Requests in SwiftUI

Why Rockxy uses an AppKit bridge for very large flow lists, and what that buys in memory, smoothness, and responsiveness.

Rockxy Team
Rockxy TeamPerformance engineering
Rockxy traffic capture table
Comparison6 min read

Charles Proxy vs Proxyman vs Rockxy

An honest breakdown of the three most common macOS HTTP debugging workflows: native UX, pricing, trust, and daily usability.

Rockxy Team
Rockxy TeamComparison guide
Rockxy network connection view
Engineering6 min read

Why We Chose SwiftNIO Over Network.framework

A lower-level look at the networking stack choices behind Rockxy and why byte-level control mattered for a debugging proxy.

Rockxy Team
Rockxy TeamArchitecture decision
Rockxy HTTPS proxy interface
Tutorial5 min read

How to Debug HTTPS Traffic on macOS with a Local Proxy

The practical setup path for HTTPS interception on macOS: trust, TLS, and what you can actually inspect once the proxy is live.

Rockxy Team
Rockxy TeamHTTPS setup guide
Rockxy brand image
Company4 min read

Why We Built Rockxy

The origin story behind a native, open-source macOS proxy that treats local trust, source visibility, and developer ergonomics as first-class concerns.

Rockxy Team
Rockxy TeamOrigin story