3d87c04d20
- Add docs/architecture.md with 4 mermaid diagrams - Add docs/mitm.md with 3 mermaid diagrams (replaces mitm-interception-status) - Add docs/traces.md documenting per-call trace system - Rewrite README.md to be concise with mermaid and doc refs - Rewrite GEMINI.md for core philosophy and agent usage - Clean extension-server-analysis.md (remove stale debug sections) - Delete temp docs: standalone-ls-todo, panel-stream-investigation, endpoint-gap-analysis, request-comparison
Antigravity Proxy
OpenAI-compatible proxy that intercepts and relays requests to Google's Antigravity language server, impersonating the real Electron webview.
%%{init: {'theme': 'dark', 'themeVariables': {'primaryColor': '#1a1a2e', 'primaryTextColor': '#e0e0e0', 'primaryBorderColor': '#7c3aed', 'lineColor': '#7c3aed', 'secondaryColor': '#16213e', 'tertiaryColor': '#0f3460', 'edgeLabelBackground': '#1a1a2e', 'nodeTextColor': '#e0e0e0'}}}%%
graph LR
Client["Client"] -->|"OpenAI / Gemini API"| Proxy["Proxy :8741"]
Proxy -->|"gRPC (dummy prompt)"| LS["Standalone LS"]
LS -->|"HTTPS :443"| MITM["MITM :8742"]
MITM -->|"Modified request\n(real prompt + tools)"| Google["Google API"]
Google -->|"SSE response"| MITM
MITM -->|"Usage, errors,\nfunction calls"| Proxy
LS -.->|"iptables redirect\n(UID-scoped)"| MITM
style Proxy fill:#7c3aed,color:#fff
style MITM fill:#e94560,color:#fff
style LS fill:#2563eb,color:#fff
style Google fill:#059669,color:#fff
Quick Start
# Headless mode (no running Antigravity app needed)
RUST_LOG=info ./target/release/antigravity-proxy --headless
# Or use the daemon manager
proxyctl start
Endpoints
| Method | Path | Description |
|---|---|---|
POST |
/v1/responses |
Responses API (sync + streaming) |
POST |
/v1/chat/completions |
Chat Completions API (OpenAI compat) |
POST |
/v1/gemini |
Native Gemini API |
POST |
/v1beta/models/{model}:{action} |
Official Gemini v1beta routes |
GET/POST |
/v1/search |
Web Search via Google grounding |
GET |
/v1/models |
List available models |
GET |
/v1/sessions |
List active sessions |
DELETE |
/v1/sessions/{id} |
Delete a session |
POST |
/v1/token |
Set OAuth token at runtime |
GET |
/v1/usage |
MITM-intercepted token usage |
GET |
/v1/quota |
LS quota and rate limits |
GET |
/health |
Health check |
Authentication
The proxy needs an OAuth token:
- Env var:
ANTIGRAVITY_OAUTH_TOKEN=ya29.xxx - Token file:
~/.config/antigravity-proxy-token - Runtime:
curl -X POST http://localhost:8741/v1/token -d '{"token":"ya29.xxx"}'
proxyctl Commands
| Command | Description |
|---|---|
proxyctl start |
Start the proxy daemon |
proxyctl stop |
Stop the proxy daemon |
proxyctl restart |
Rebuild + restart |
proxyctl rebuild |
Build release binary only |
proxyctl status |
Service status + quota + usage |
proxyctl logs [N] |
Tail last N lines + follow |
proxyctl test [msg] |
Quick test request |
proxyctl health |
Health check |
Documentation
| Doc | Contents |
|---|---|
| architecture.md | System overview, module map, request lifecycle (mermaid) |
| mitm.md | MITM proxy internals, event flow, request modification |
| traces.md | Per-call debug trace system |
| extension-server-analysis.md | Extension server protocol reverse engineering |
| ls-binary-analysis.md | LS binary reverse engineering — model catalog, gRPC services, protos |
License
Private. Do not distribute.