Architecture
Grroxy is made up of three components that work together.
| Component | Default Port | Description |
|---|---|---|
| grroxy (launcher) | 8888 | Project management, updates, templates |
| grroxy-app | 8090 | Per-project proxy, intercept, tools |
| grroxy-tool | 9001 | Standalone fuzzer and SDK tools |
Launcher (grroxy)
The launcher is the entry point. It manages projects, starts grroxy-app instances, and provides shared utilities like templates, regex testing, and updates.
App (grroxy-app)
Each project runs its own grroxy-app instance with an isolated database. It handles proxying, request interception, repeater, sitemap, labels, terminal, and the MCP server.
Tool (grroxy-tool)
A standalone tool instance for fuzzing and SDK operations. Connects back to a grroxy-app via the SDK.
API
All three components expose HTTP APIs. Endpoints marked (requires auth) expect a valid PocketBase session token in the Authorization header.