English | Tiếng Việt | 中文 | 繁體中文 | Español | Português do Brasil | 日本語 | 한국어 | Français | Deutsch | Italiano | Türkçe | Polski | Nederlands | Русский | Українська | العربية | فارسی | বাংলা | Română | ქართული
El proxy de depuración open-source y auditable para macOS.
Intercepta, inspecciona y modifica tráfico HTTP/HTTPS/WebSocket/GraphQL con una app Swift nativa que puedes auditar, compilar y confiar.
Construido para workflows de depuración de API, mobile, MCP-assisted, AI y la era blockchain mientras Rockxy evoluciona.
Una alternativa local-first, AGPL-3.0 a Proxyman y Charles Proxy.
Inspecciona tráfico HTTP, HTTPS, WebSocket y GraphQL desde cualquier app Mac, CLI o dispositivo iOS. Browser DevTools termina en el navegador; Rockxy ve el resto de tu stack.
`HTTP / HTTPS` · `WebSocket` · `GraphQL` · `iOS Device & Simulator` · `Filter by Process ID` · `Timing Waterfall`
### Filtros y Búsqueda Avanzada
Reduce miles de requests capturados en segundos. Combina filtros por method, host, status, header, body y process, o ejecuta full-text search en toda la sesión.
`Multi-Field Filters` · `Full-Text Search` · `Status / Method` · `Header / Body Match` · `Process / Host` · `Saved Filters`
### MCP Server para AI Assistants
Permite que Claude Desktop o Cursor lean tu tráfico capturado mediante un MCP server local. Pregunta "¿por qué esto devolvió 500?" en vez de pegar headers en un chat. Local, redaction-aware y open source.
`Claude Desktop` · `Cursor` · `Local stdio` · `Redaction` · `Open Source`
### Developer Setup Hub
Copia snippets de proxy para Python, Node.js, Go, Rust, cURL, Docker y navegadores, luego pulsa Run Test para confirmar que el tráfico realmente fluye.
`Python` · `Node.js` · `Go / Rust / Java` · `cURL / Docker` · `One-Click Verify` · `Trust Diagnostics`
### Gestión de Certificados para HTTPS Debugging
Una root CA P-256 ECDSA generada en el primer launch y sellada en tu Keychain. Descifra HTTPS al primer intento; los hosts con pinning pasan automáticamente.
`P-256 ECDSA Root CA` · `Keychain-Sealed Key` · `Per-Host Leaf Certs` · `Trust Wizard` · `Pinned-Host Passthrough` · `Rotate / Reset`
### SSL Proxy y Descifrado HTTPS
Elige qué hosts se descifran con TLS. El tráfico descifrado muestra headers y JSON reales; el resto pasa cifrado. Las reglas wildcard permiten scope por dominio en un clic.
`Per-Host Decryption` · `Wildcard Rules` · `Allow / Deny List` · `TLS 1.2 / 1.3` · `Pinned Host Passthrough`
### Bypass Proxy
Omite hosts específicos para que apps con certificate pinning, servicios internos o telemetría ruidosa nunca entren en la captura.
`Per-Host Bypass` · `Wildcard Patterns` · `Skip Pinned Hosts` · `Mute Telemetry` · `Reduce Noise` · `Toggle Anytime`
### Block List
Haz fallar cualquier host. Corta ad networks, trackers o una dependencia inestable para ver cómo se degrada tu app sin cambiar código.
`Per-Host Block` · `Wildcard Match` · `Simulate Outage` · `Test Fallbacks` · `Strip Trackers` · `Toggle Anytime`
### Map Local
Sirve un archivo guardado o un árbol de directorios en lugar de una respuesta real. Cambia un JSON, repite un snapshot o fija una API flaky a una copia local mientras depuras.
`File or Directory` · `Response Snapshot` · `Regex Patterns`
### Map Remote
Reescribe el destino de un request capturado sin tocar el código de la app ni `/etc/hosts`. Manda tráfico de producción a staging, a tu dev server o a la máquina de un colega.
`Host Rewrite` · `Regex Patterns` · `Preserve Host Header`
### Breakpoints y Reglas
Pausa un request o response, edita method, headers, body o status y continúa. La forma rápida de probar "¿qué pasa si la API devuelve 401?" sin tocar backend.
`Request Breakpoints` · `Response Breakpoints` · `Block` · `Throttle` · `Regex / Wildcard Match` · `Inject Failure States`
### Modificar Headers
Agrega, elimina o reemplaza headers en cualquier host sin redeploy. Prueba CORS, auth o cache en segundos con presets integrados.
`Add / Remove / Replace` · `CORS Presets` · `Auth Stripping` · `Request Phase` · `Response Phase` · `URL Pattern Scope`
### Custom Request & Response Headers
Sobrescribe headers por host con control completo de ambas fases. Inyecta auth tokens, elimina Set-Cookie o fija un User-Agent personalizado como reglas nombradas.
`Per-Host Override` · `Request Phase` · `Response Phase` · `Auth Token Inject` · `Cookie Strip` · `Named Rules`
### Condiciones de Red
Limita a 3G, EDGE, LTE, WiFi o una latencia custom. Tu laptop está en fibra; tus usuarios no. Mira la UX a 400 ms RTT antes que ellos.
`3G` · `EDGE` · `LTE` · `WiFi` · `Very Bad Network` · `Custom Latency`
### Compose — Editar y Repetir
Reconstruye cualquier request HTTP capturado, cambia method, URL, headers, query params o body, y vuelve a enviarlo sin salir de Rockxy. Itera prompts LLM, prueba límites de auth o reproduce fallos de endpoints OpenAI, Anthropic y Cohere en segundos.
`Edit Headers` · `Edit Body` · `Edit Query` · `Edit Method` · `LLM Prompt Iteration` · `Postman Alternative` · `OAuth Flow Debug` · `Webhook Replay`
### Compare
Pon dos responses capturadas lado a lado y detecta cada campo que cambió: status, headers, JSON keys y bytes del body. Encuentra regresiones silenciosas de API, outputs LLM no deterministas y prompt drift sin enviar datos a un diff de terceros.
`Diff Compare` · `Side-by-Side` · `JSON Diff` · `Header Diff` · `Body Diff` · `LLM Output Compare` · `Non-determinism` · `API Regression` · `Schema Drift`
### Custom Previewer Tabs
Renderiza request y response bodies como quieras. Fija tabs extra para JSON, GraphQL, JWT, imagen o tu propio formato, reutilizables en cada request capturado.
`JSON` · `GraphQL` · `JWT Decoder` · `Image / Hex` · `Custom Format` · `Pinned per Inspector`
### Sesiones y Export
Guarda sesiones, importa/exporta HAR, copia cualquier request como cURL o JSON. Redacta authorization headers, cookies y bearer tokens antes de compartir.
`.rockxysession` · `HAR Import / Export` · `Copy as cURL` · `Copy as JSON` · `Raw HTTP` · `Secret Redaction` · `Token Sanitize` · `Privacy-Safe Share`
### Workspaces Multi-Tab
Ejecuta sesiones de captura independientes lado a lado: una tab para staging, otra para prod y otra para el build de iOS device.
`Independent Sessions` · `Per-Tab Filters` · `Per-Tab Inspector` · `Compare Environments` · `Mac & iOS Together` · `Detach & Rename`
### JavaScript Scripting
Hooks JS en requests y responses para casos que una regla estática no cubre: redactar PII, firmar tokens, reescribir payloads. Los errores aparecen inline sin corromper tráfico.
`Request Hooks` · `Response Hooks` · `Programmatic Filtering` · `PII Redaction` · `Inline Error Feedback`
## Más Funciones Próximamente
Las funcionalidades futuras se rastrean públicamente y se publican solo cuando la implementación, tests, privacidad y documentación están listas.
### AI Traffic Inspection `Próximamente`
Haz que el tráfico de modelos sea más fácil de depurar dentro del workflow normal de captura. Detecta requests AI, inspecciona model calls seleccionados, diagnostica streaming responses, compara prompt/output behavior y entiende tool-call chains sin pegar payloads sensibles en otro servicio.
`AI Requests` · `Model Inspector` · `Streaming Diagnostics` · `Tool Calls` · `Prompt Safety` · `Usage Signals`
### Web3/RPC Inspection `Próximamente`
Convierte llamadas de red blockchain-era en evidence de depuración legible. Inspecciona JSON-RPC y Solana RPC traffic, agrupa llamadas relacionadas en flows, explica errores RPC comunes y replay selected requests sin convertir Rockxy en wallet o block explorer.
`JSON-RPC` · `Solana RPC` · `Wallet Flows` · `RPC Errors` · `Replay Helpers` · `Network Evidence`
### x402 Payment Flow Debugging `Próximamente`
Entiende payment-gated HTTP flows desde la capa de red. Resalta payment-required responses, sigue el retry path y mantiene la evidence local y redaction-aware.
`Payment Required` · `Retry Flow` · `Headers` · `Redaction` · `Local First`
### Redacted Evidence Bundles `Próximamente`
Comparte los hechos necesarios para reproducir un bug sin filtrar secretos. Empaqueta selected traffic con protocol summaries, redaction previews y source-backed context auditable.
`Debug Bundles` · `Protocol Summary` · `Export Preview` · `Secret Redaction` · `Repro Context`
### Protocol-Aware Filters & Rules `Próximamente`
Usa metadata AI y Web3 donde Rockxy ya trabaja: filters, badges, optional columns, comparison, rules, Developer Setup y local MCP summaries.
`Smart Filters` · `Request Badges` · `Optional Columns` · `Rules` · `Compare` · `Local MCP`
### Team Sharing & Collaboration `Próximamente`
Envía una sesión capturada a un compañero con un clic. Anota requests fallidos inline, ve quién mira qué en tiempo real y pair-debuggea tráfico HTTPS sin compartir pantalla.
`Shared Sessions` · `Team Workspaces` · `Inline Comments` · `Live Cursor` · `Cloud Sync` · `Pair Debug` · `SSO` · `Audit Log`
> 100% macOS nativo. Sin Electron. Sin web views. SwiftUI + AppKit + SwiftNIO.
## Quick Start
```bash
git clone https://github.com/RockxyApp/Rockxy.git
cd Rockxy
open Rockxy.xcodeproj
```
Compila y ejecuta en Xcode. La ventana Welcome te guía por la configuración de root CA, instalación del helper y activación del proxy.
**Requisitos:** macOS 14.0+, Xcode 16+, Swift 5.9
Si quieres conectar Rockxy a un cliente MCP local tras instalarlo, consulta la [guía de integración MCP](docs/features/mcp.mdx).
## Rockxy vs. Alternativas
| | **Rockxy** | **Proxyman** | **Charles Proxy** |
|---|---|---|---|
| **Modelo de proyecto** | Proyecto open-source AGPL-3.0 | App comercial propietaria | App comercial propietaria |
| **Código fuente** | Público, auditable, forkable | Cerrado | Cerrado |
| **Compilar desde source** | Gratis con Xcode desde este repo | No disponible desde source público | No disponible desde source público |
| **Base macOS nativa** | Swift + SwiftNIO + SwiftUI/AppKit | App macOS comercial nativa | App comercial multiplataforma |
| **Captura local-first** | Proxy, certificados, helper y datos quedan en tu Mac | App desktop proxy | App desktop proxy |
| **Developer setup workflow** | Developer Setup Hub integrado para runtimes, clients, devices, frameworks y environments | Guías específicas del producto | Guías específicas del producto |
| **External proxy + PAC routing** | HTTP/HTTPS upstream proxy, PAC auto-configuration y bypass rules | Tooling proxy comercial maduro | Tooling proxy comercial maduro |
| **MCP/local automation bridge** | Integrado, token-authenticated, redaction por defecto | No declarado en docs públicas revisadas | No declarado en docs públicas revisadas |
| **Ruta de contribución abierta** | Issues, discussions, roadmap y PRs públicos | Producto controlado por vendor | Producto controlado por vendor |
En el roadmap: workflows replay/diff/rules/scripting más profundos, mejor inspección WebSocket y GraphQL, depuración protocol-aware AI y Web3/RPC, visibilidad de payment flows estilo x402, y exploración de gRPC/Protobuf más HTTP/2 y HTTP/3.
## Seguridad
Rockxy intercepta tráfico de red: la seguridad es fundacional, no opcional.
- El helper XPC valida callers mediante **comparación de certificate-chain**, no solo bundle ID
- Los plugins corren en **JavaScriptCore sandboxed** con timeout de 5 segundos, sin acceso a filesystem/network
- **Validación de input** en todos los boundaries: caps de body size, URI limits, regex DoS protection, path traversal prevention
- Credenciales **automáticamente redactadas** en logs capturados
- Archivos sensibles guardados con permisos **0o600**
Reporta vulnerabilidades mediante [SECURITY.md](SECURITY.md). Consulta la [arquitectura de seguridad completa](docs/development/security.mdx).
## Roadmap
El roadmap público de Rockxy está orientado a workflows y no tiene fechas fijas. Se enfoca en confiabilidad, UX macOS nativa, debugging workflows, protocol support, visibilidad de tráfico AI/Web3-era, documentación y onboarding de contributors.
- [ROADMAP.md](ROADMAP.md): dirección pública de ingeniería de alto nivel
- [Rockxy Public Roadmap](https://github.com/orgs/RockxyApp/projects/1): visibilidad operacional para issues del roadmap
## Documentación
Documentación completa en [Rockxy Docs](docs/index.mdx):
- [Quickstart Guide](docs/quickstart.mdx) — empieza en minutos
- [Developer Setup Hub](docs/features/developer-setup-hub.mdx) — snippets por runtime, device guides, validation probes y support matrix
- [MCP Integration](docs/features/mcp.mdx) — conecta Rockxy a clientes MCP locales
- [Architecture](docs/development/architecture.mdx) — proxy engine, actor model, data flow
- [Security Model](docs/development/security.mdx) — trust boundaries, XPC validation, certificate management
- [Design Decisions](docs/development/design-decisions.mdx) — por qué SwiftNIO, NSTableView, actors
- [Building from Source](docs/development/building.mdx) — build, test, lint y debug
- [Code Style](docs/development/code-style.mdx) — SwiftLint, SwiftFormat y convenciones
- [Changelog](CHANGELOG.md) — trabajo unreleased y releases etiquetados
## Contribuir
Contribuciones bienvenidas: código, tests, docs, bug reports y feedback UX.
Consulta **[CONTRIBUTING.md](CONTRIBUTING.md)** para setup, code style y checklist PR.
Los issues para empezar están etiquetados como [`good first issue`](https://github.com/RockxyApp/Rockxy/labels/good%20first%20issue). Al abrir un PR, aceptas el [CLA](CLA.md).
## Sponsors & Partners
Rockxy es construido y mantenido por desarrolladores independientes. Los sponsorships financian desarrollo continuo, auditorías de seguridad y nuevas funciones.
Hecho por Stephen. Construido con Swift, SwiftNIO, SwiftUI y AppKit.