Files

Nikketryhard 3d87c04d20 docs: overhaul docs, add architecture and traces, update README/GEMINI

- 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

2026-02-18 01:31:18 -06:00

4.3 KiB

Raw Blame History

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.

4.3 KiB Raw Blame History