English | Tiếng Việt | 中文 | 繁體中文 | Español | Português do Brasil | 日本語 | 한국어 | Français | Deutsch | Italiano | Türkçe | Polski | Nederlands | Русский | Українська | العربية | فارسی | বাংলা | Română | ქართული
O proxy de debug open-source e auditável para macOS.
Intercepte, inspecione e modifique tráfego HTTP/HTTPS/WebSocket/GraphQL com um app Swift nativo que você pode auditar, compilar e confiar.
Feito para workflows de debug de API, mobile, MCP-assisted, AI e da era blockchain enquanto o Rockxy evolui.
Uma alternativa local-first, AGPL-3.0 ao Proxyman e Charles Proxy.
Inspecione tráfego HTTP, HTTPS, WebSocket e GraphQL de qualquer app Mac, CLI ou dispositivo iOS. Browser DevTools para no navegador; Rockxy vê o resto da sua stack.
`HTTP / HTTPS` · `WebSocket` · `GraphQL` · `iOS Device & Simulator` · `Filter by Process ID` · `Timing Waterfall`
### Filtro e Busca Avançados
Reduza milhares de requests capturados em segundos. Combine filtros por method, host, status, header, body e process, ou rode full-text search na sessão inteira.
`Multi-Field Filters` · `Full-Text Search` · `Status / Method` · `Header / Body Match` · `Process / Host` · `Saved Filters`
### MCP Server para AI Assistants
Deixe Claude Desktop ou Cursor lerem seu tráfego capturado por um MCP server local. Pergunte "por que isso retornou 500?" em vez de colar headers no chat. Local, redaction-aware e open source.
`Claude Desktop` · `Cursor` · `Local stdio` · `Redaction` · `Open Source`
### Developer Setup Hub
Copie snippets de proxy para Python, Node.js, Go, Rust, cURL, Docker e browsers, depois clique em Run Test para confirmar que o tráfego está fluindo.
`Python` · `Node.js` · `Go / Rust / Java` · `cURL / Docker` · `One-Click Verify` · `Trust Diagnostics`
### Gerenciamento de Certificados para HTTPS Debugging
Uma root CA P-256 ECDSA gerada no primeiro launch e selada no seu Keychain. Decifre HTTPS na primeira tentativa; hosts com pinning passam automaticamente.
`P-256 ECDSA Root CA` · `Keychain-Sealed Key` · `Per-Host Leaf Certs` · `Trust Wizard` · `Pinned-Host Passthrough` · `Rotate / Reset`
### SSL Proxy e Decriptação HTTPS
Escolha quais hosts recebem TLS decryption. O tráfego decriptado mostra headers e JSON reais; o resto passa criptografado. Regras wildcard permitem scope por domínio em um clique.
`Per-Host Decryption` · `Wildcard Rules` · `Allow / Deny List` · `TLS 1.2 / 1.3` · `Pinned Host Passthrough`
### Bypass Proxy
Pule hosts específicos para que apps com certificate pinning, serviços internos ou telemetria barulhenta nunca entrem na captura.
`Per-Host Bypass` · `Wildcard Patterns` · `Skip Pinned Hosts` · `Mute Telemetry` · `Reduce Noise` · `Toggle Anytime`
### Block List
Faça qualquer host falhar. Corte ad networks, trackers ou uma dependência instável para ver como sua app degrada sem mudar código.
`Per-Host Block` · `Wildcard Match` · `Simulate Outage` · `Test Fallbacks` · `Strip Trackers` · `Toggle Anytime`
### Map Local
Sirva um arquivo salvo ou uma árvore de diretórios no lugar de uma resposta real. Troque um JSON, repita um snapshot ou fixe uma API flaky em uma cópia local enquanto debuga.
`File or Directory` · `Response Snapshot` · `Regex Patterns`
### Map Remote
Reescreva o destino de um request capturado sem tocar no código da app nem em `/etc/hosts`. Aponte tráfego de produção para staging, seu dev server ou a máquina de um colega.
`Host Rewrite` · `Regex Patterns` · `Preserve Host Header`
### Breakpoints e Regras
Pause um request ou response, edite method, headers, body ou status e continue. O jeito rápido de testar "e se a API retornar 401?" sem tocar no backend.
`Request Breakpoints` · `Response Breakpoints` · `Block` · `Throttle` · `Regex / Wildcard Match` · `Inject Failure States`
### Modificar Headers
Adicione, remova ou substitua headers em qualquer host sem redeploy. Teste CORS, auth ou cache em segundos com presets integrados.
`Add / Remove / Replace` · `CORS Presets` · `Auth Stripping` · `Request Phase` · `Response Phase` · `URL Pattern Scope`
### Custom Request & Response Headers
Sobrescreva headers por host com controle total das duas fases. Injete auth tokens, remova Set-Cookie ou fixe um User-Agent customizado como regras nomeadas.
`Per-Host Override` · `Request Phase` · `Response Phase` · `Auth Token Inject` · `Cookie Strip` · `Named Rules`
### Condições de Rede
Limite para 3G, EDGE, LTE, WiFi ou uma latência customizada. Seu laptop está na fibra; seus usuários não. Veja a UX a 400 ms RTT antes deles.
`3G` · `EDGE` · `LTE` · `WiFi` · `Very Bad Network` · `Custom Latency`
### Compose — Editar e Repetir
Reconstrua qualquer request HTTP capturado, mude method, URL, headers, query params ou body, e reenvie sem sair do Rockxy. Itere prompts LLM, teste limites de auth ou reproduza falhas em endpoints OpenAI, Anthropic e Cohere em segundos.
`Edit Headers` · `Edit Body` · `Edit Query` · `Edit Method` · `LLM Prompt Iteration` · `Postman Alternative` · `OAuth Flow Debug` · `Webhook Replay`
### Compare
Coloque duas responses capturadas lado a lado e encontre cada campo que mudou: status, headers, JSON keys e bytes do body. Pegue regressões silenciosas de API, outputs LLM não determinísticos e prompt drift sem mandar dados para diff de terceiros.
`Diff Compare` · `Side-by-Side` · `JSON Diff` · `Header Diff` · `Body Diff` · `LLM Output Compare` · `Non-determinism` · `API Regression` · `Schema Drift`
### Custom Previewer Tabs
Renderize request e response bodies do seu jeito. Fixe tabs extras para JSON, GraphQL, JWT, imagem ou seu próprio formato, reutilizáveis em cada request capturado.
`JSON` · `GraphQL` · `JWT Decoder` · `Image / Hex` · `Custom Format` · `Pinned per Inspector`
### Sessões e Export
Salve sessões, importe/exporte HAR, copie qualquer request como cURL ou JSON. Redija authorization headers, cookies e bearer tokens antes de compartilhar.
`.rockxysession` · `HAR Import / Export` · `Copy as cURL` · `Copy as JSON` · `Raw HTTP` · `Secret Redaction` · `Token Sanitize` · `Privacy-Safe Share`
### Workspaces Multi-Tab
Rode sessões de captura independentes lado a lado: uma tab para staging, uma para prod e uma para o build de iOS device.
`Independent Sessions` · `Per-Tab Filters` · `Per-Tab Inspector` · `Compare Environments` · `Mac & iOS Together` · `Detach & Rename`
### JavaScript Scripting
Hooks JS em requests e responses para casos que uma regra estática não cobre: redigir PII, assinar tokens, reescrever payloads. Erros aparecem inline sem corromper tráfego.
`Request Hooks` · `Response Hooks` · `Programmatic Filtering` · `PII Redaction` · `Inline Error Feedback`
## Mais Funcionalidades Em Breve
Funcionalidades futuras são acompanhadas publicamente e só serão entregues quando implementação, testes, privacy behavior e documentação estiverem prontos.
### AI Traffic Inspection `Em Breve`
Torne model traffic mais fácil de debugar dentro do workflow normal de captura. Detecte AI requests, inspecione model calls selecionados, diagnostique streaming responses, compare prompt/output behavior e entenda tool-call chains sem colar payloads sensíveis em outro serviço.
`AI Requests` · `Model Inspector` · `Streaming Diagnostics` · `Tool Calls` · `Prompt Safety` · `Usage Signals`
### Web3/RPC Inspection `Em Breve`
Transforme chamadas de rede da era blockchain em debugging evidence legível. Inspecione JSON-RPC e Solana RPC traffic, agrupe calls relacionadas em flows, explique erros RPC comuns e replay selected requests sem transformar Rockxy em wallet ou block explorer.
`JSON-RPC` · `Solana RPC` · `Wallet Flows` · `RPC Errors` · `Replay Helpers` · `Network Evidence`
### x402 Payment Flow Debugging `Em Breve`
Entenda payment-gated HTTP flows pela camada de rede. Destaque payment-required responses, siga o retry path e mantenha a evidence local e redaction-aware.
`Payment Required` · `Retry Flow` · `Headers` · `Redaction` · `Local First`
### Redacted Evidence Bundles `Em Breve`
Compartilhe os fatos necessários para reproduzir um bug sem vazar secrets. Empacote selected traffic com protocol summaries, redaction previews e source-backed context auditável.
`Debug Bundles` · `Protocol Summary` · `Export Preview` · `Secret Redaction` · `Repro Context`
### Protocol-Aware Filters & Rules `Em Breve`
Use metadata AI e Web3 onde Rockxy já trabalha: filters, badges, optional columns, comparison, rules, Developer Setup e local MCP summaries.
`Smart Filters` · `Request Badges` · `Optional Columns` · `Rules` · `Compare` · `Local MCP`
### Team Sharing & Collaboration `Em Breve`
Envie uma sessão capturada para um colega com um clique. Anote requests com falha inline, veja quem está olhando o quê em tempo real e faça pair-debug de tráfego HTTPS sem compartilhar tela.
`Shared Sessions` · `Team Workspaces` · `Inline Comments` · `Live Cursor` · `Cloud Sync` · `Pair Debug` · `SSO` · `Audit Log`
> 100% macOS nativo. Sem Electron. Sem web views. SwiftUI + AppKit + SwiftNIO.
## Quick Start
```bash
git clone https://github.com/RockxyApp/Rockxy.git
cd Rockxy
open Rockxy.xcodeproj
```
Compile e rode no Xcode. A janela Welcome guia você pela configuração da root CA, instalação do helper e ativação do proxy.
**Requisitos:** macOS 14.0+, Xcode 16+, Swift 5.9
Se quiser conectar Rockxy a um client MCP local após a instalação, veja o [guia de integração MCP](docs/features/mcp.mdx).
## Rockxy vs. Alternativas
| | **Rockxy** | **Proxyman** | **Charles Proxy** |
|---|---|---|---|
| **Modelo de projeto** | Projeto open-source AGPL-3.0 | App comercial proprietário | App comercial proprietário |
| **Código-fonte** | Público, auditável, forkable | Fechado | Fechado |
| **Compilar do source** | Grátis com Xcode a partir deste repo | Não disponível por source público | Não disponível por source público |
| **Base macOS nativa** | Swift + SwiftNIO + SwiftUI/AppKit | App macOS comercial nativo | App comercial multiplataforma |
| **Captura local-first** | Proxy, certificados, helper e dados ficam no seu Mac | App desktop proxy | App desktop proxy |
| **Developer setup workflow** | Developer Setup Hub integrado para runtimes, clients, devices, frameworks e environments | Guias específicos do produto | Guias específicos do produto |
| **External proxy + PAC routing** | HTTP/HTTPS upstream proxy, PAC auto-configuration e bypass rules | Tooling proxy comercial maduro | Tooling proxy comercial maduro |
| **MCP/local automation bridge** | Integrado, token-authenticated, redaction por padrão | Não declarado em docs públicas revisadas | Não declarado em docs públicas revisadas |
| **Caminho aberto de contribuição** | Issues, discussions, roadmap e PRs públicos | Produto controlado por vendor | Produto controlado por vendor |
No roadmap: workflows replay/diff/rules/scripting mais profundos, melhor inspeção WebSocket e GraphQL, debug protocol-aware de AI e Web3/RPC, visibilidade de payment flows estilo x402, e exploração de gRPC/Protobuf mais HTTP/2 e HTTP/3.
## Segurança
Rockxy intercepta tráfego de rede: segurança é fundação, não opcional.
- O helper XPC valida callers por **comparação de certificate-chain**, não só bundle ID
- Plugins rodam em **JavaScriptCore sandboxed** com timeout de 5 segundos, sem acesso a filesystem/network
- **Validação de input** em todos os boundaries: caps de body size, URI limits, regex DoS protection, path traversal prevention
- Credenciais são **automaticamente redigidas** em logs capturados
- Arquivos sensíveis salvos com permissões **0o600**
Reporte vulnerabilidades via [SECURITY.md](SECURITY.md). Veja a [arquitetura de segurança completa](docs/development/security.mdx).
## Roadmap
O roadmap público do Rockxy é orientado a workflows e sem datas fixas. Ele foca em confiabilidade, UX macOS nativa, debugging workflows, protocol support, visibilidade de tráfego AI/Web3-era, documentação e onboarding de contributors.
- [ROADMAP.md](ROADMAP.md): direção pública de engenharia em alto nível
- [Rockxy Public Roadmap](https://github.com/orgs/RockxyApp/projects/1): visibilidade operacional para issues do roadmap
## Documentação
Documentação completa em [Rockxy Docs](docs/index.mdx):
- [Quickstart Guide](docs/quickstart.mdx) — comece em minutos
- [Developer Setup Hub](docs/features/developer-setup-hub.mdx) — snippets por runtime, device guides, validation probes e support matrix
- [MCP Integration](docs/features/mcp.mdx) — conecte Rockxy a clients MCP locais
- [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 que SwiftNIO, NSTableView, actors
- [Building from Source](docs/development/building.mdx) — build, test, lint e debug
- [Code Style](docs/development/code-style.mdx) — SwiftLint, SwiftFormat e convenções
- [Changelog](CHANGELOG.md) — trabalho unreleased e releases taggeadas
## Contribuindo
Contribuições são bem-vindas: código, tests, docs, bug reports e feedback UX.
Veja **[CONTRIBUTING.md](CONTRIBUTING.md)** para setup, code style e checklist PR.
Issues para começar são marcadas como [`good first issue`](https://github.com/RockxyApp/Rockxy/labels/good%20first%20issue). Ao abrir um PR, você concorda com o [CLA](CLA.md).
## Sponsors & Partners
Rockxy é construído e mantido por desenvolvedores independentes. Sponsorships financiam desenvolvimento contínuo, auditorias de segurança e novas funcionalidades.
Feito por Stephen. Construído com Swift, SwiftNIO, SwiftUI e AppKit.