# nguyenchau4519/antigravity-manager architecture

> Architecture diagram of the GitHub repository nguyenchau4519/antigravity-manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nguyenchau4519/antigravity-manager
- Repository: https://github.com/nguyenchau4519/antigravity-manager

## Overview

Antigravity Tools is a desktop AI-account manager and local protocol-conversion gateway. Users authorize or import accounts, monitor quotas and switch accounts in the desktop UI; external AI clients send OpenAI-, Anthropic-, or Gemini-shaped requests to the local proxy. The README documents the gateway’s middleware, model-routing, account-dispatch, and protocol-mapping stages. The proxy server and OAuth flow are partly sampled, but most handler internals and backend command implementations are not, so uncertain links are omitted or marked unverified.

Main entry points: [`src-tauri/src/proxy/server.rs`](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/proxy/server.rs) (Axum gateway), [`src/App.tsx`](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/App.tsx) (App routing), [`src-tauri/src/proxy/handlers/mod.rs`](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/proxy/handlers/mod.rs) (Protocol handlers), [`src-tauri/src/proxy/upstream/client.rs`](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/proxy/upstream/client.rs) (Upstream client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop experience"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_account_ui["Account manager<br/>[Accounts.tsx]"]
  node_proxy_ui["Proxy controls<br/>[ApiProxy.tsx]"]
  node_settings_ui["Settings<br/>[Settings.tsx]"]
  node_app_router["App routing<br/>[App.tsx]"]
end

subgraph group_accounts["Account operations"]
  node_account_store["Account state<br/>[useAccountStore.ts]"]
  node_account_service["Account bridge<br/>[accountService.ts]"]
  node_native_commands["Native commands<br/>[mod.rs]"]
  node_account_core["Account operations<br/>[account.rs]"]
  node_oauth_flow["OAuth callback<br/>[oauth_server.rs]"]
  node_oauth["OAuth exchange<br/>[oauth.rs]"]
  node_quota["Quota tracking<br/>[quota.rs]"]
end

subgraph group_gateway["AI proxy gateway"]
  node_proxy_server["Axum gateway<br/>[server.rs]"]
  node_middleware["Request middleware<br/>[mod.rs]"]
  node_handlers["Protocol handlers<br/>[mod.rs]"]
end

subgraph group_conversion["Routing and conversion"]
  node_model_router["Model routing<br/>[model_mapping.rs]"]
  node_token_manager["Account dispatcher<br/>[token_manager.rs]"]
  node_protocol_mappers["Protocol mappers<br/>[mod.rs]"]
  node_upstream["Upstream client<br/>[client.rs]"]
end

subgraph group_platform["Backend services"]
  node_config_store["Configuration state<br/>[useConfigStore.ts]"]
  node_config_service["Configuration bridge<br/>[configService.ts]"]
  node_config_core["Configuration<br/>[config.rs]"]
  node_db[("Local database<br/>[db.rs]")]
end

node_client(("AI client"))
node_google(("Google AI services"))
node_anthropic(("Anthropic services"))

node_app_router -->|"routes to"| node_dashboard
node_app_router -->|"routes to"| node_account_ui
node_app_router -->|"routes to"| node_proxy_ui
node_app_router -->|"routes to"| node_settings_ui
node_account_ui -->|"uses state"| node_account_store
node_dashboard -->|"uses state"| node_account_store
node_account_store -->|"invokes"| node_account_service
node_account_service -->|"invokes commands"| node_native_commands
node_native_commands -->|"references"| node_oauth_flow
node_oauth_flow -->|"exchanges code"| node_oauth
node_account_core -.->|"refreshes tokens"| node_oauth
node_config_store -->|"invokes"| node_config_service
node_config_service -.->|"loads and saves"| node_config_core
node_proxy_ui -.->|"controls service"| node_proxy_server
node_client -->|"sends API requests"| node_proxy_server
node_proxy_server -->|"applies"| node_middleware
node_proxy_server -->|"routes requests"| node_handlers
node_handlers -.->|"maps model IDs"| node_model_router
node_handlers -.->|"selects account"| node_token_manager
node_handlers -.->|"converts protocol"| node_protocol_mappers
node_protocol_mappers -.->|"builds upstream request"| node_upstream
node_upstream -.->|"calls"| node_google
node_upstream -.->|"calls"| node_anthropic
node_proxy_server -->|"holds state"| node_token_manager

click node_dashboard "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/pages/Dashboard.tsx"
click node_account_ui "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/pages/Accounts.tsx"
click node_proxy_ui "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/pages/ApiProxy.tsx"
click node_settings_ui "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/pages/Settings.tsx"
click node_app_router "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/App.tsx"
click node_account_store "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/stores/useAccountStore.ts"
click node_account_service "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/services/accountService.ts"
click node_native_commands "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/commands/mod.rs"
click node_account_core "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/modules/account.rs"
click node_oauth_flow "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/modules/oauth_server.rs"
click node_oauth "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/modules/oauth.rs"
click node_quota "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/modules/quota.rs"
click node_config_store "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/stores/useConfigStore.ts"
click node_config_service "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/services/configService.ts"
click node_config_core "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/modules/config.rs"
click node_db "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/modules/db.rs"
click node_proxy_server "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/proxy/server.rs"
click node_middleware "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/proxy/middleware/mod.rs"
click node_handlers "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/proxy/handlers/mod.rs"
click node_model_router "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/proxy/common/model_mapping.rs"
click node_token_manager "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/proxy/token_manager.rs"
click node_protocol_mappers "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/proxy/mappers/mod.rs"
click node_upstream "https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/proxy/upstream/client.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_account_ui,node_proxy_ui,node_settings_ui,node_app_router,node_client toneBlue
class node_account_store,node_account_service,node_native_commands,node_account_core,node_oauth_flow,node_oauth,node_quota toneAmber
class node_proxy_server,node_middleware,node_handlers toneMint
class node_model_router,node_token_manager,node_protocol_mappers,node_upstream toneRose
class node_config_store,node_config_service,node_config_core,node_db,node_google,node_anthropic toneIndigo
```

## Components

### Desktop experience

- [Dashboard](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/pages/Dashboard.tsx): `src/pages/Dashboard.tsx`
- [Account manager](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/pages/Accounts.tsx): `src/pages/Accounts.tsx`
- [Proxy controls](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/pages/ApiProxy.tsx): `src/pages/ApiProxy.tsx`
- [Settings](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/pages/Settings.tsx): `src/pages/Settings.tsx`
- [App routing](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/App.tsx): `src/App.tsx`

### Account operations

- [Account state](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/stores/useAccountStore.ts): `src/stores/useAccountStore.ts`
- [Account bridge](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/services/accountService.ts): `src/services/accountService.ts`
- [Native commands](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/commands/mod.rs): `src-tauri/src/commands/mod.rs`
- [Account operations](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/modules/account.rs): `src-tauri/src/modules/account.rs`
- [OAuth callback](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/modules/oauth_server.rs): `src-tauri/src/modules/oauth_server.rs`
- [OAuth exchange](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/modules/oauth.rs): `src-tauri/src/modules/oauth.rs`
- [Quota tracking](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/modules/quota.rs): `src-tauri/src/modules/quota.rs`

### AI proxy gateway

- [Axum gateway](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/proxy/server.rs): `src-tauri/src/proxy/server.rs`
- [Request middleware](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/proxy/middleware/mod.rs): `src-tauri/src/proxy/middleware/mod.rs`
- [Protocol handlers](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/proxy/handlers/mod.rs): `src-tauri/src/proxy/handlers/mod.rs`

### Routing and conversion

- [Model routing](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/proxy/common/model_mapping.rs): `src-tauri/src/proxy/common/model_mapping.rs`
- [Account dispatcher](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/proxy/token_manager.rs): `src-tauri/src/proxy/token_manager.rs`
- [Protocol mappers](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/proxy/mappers/mod.rs): `src-tauri/src/proxy/mappers/mod.rs`
- [Upstream client](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/proxy/upstream/client.rs): `src-tauri/src/proxy/upstream/client.rs`

### Backend services

- [Configuration state](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/stores/useConfigStore.ts): `src/stores/useConfigStore.ts`
- [Configuration bridge](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src/services/configService.ts): `src/services/configService.ts`
- [Configuration](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/modules/config.rs): `src-tauri/src/modules/config.rs`
- [Local database](https://github.com/nguyenchau4519/antigravity-manager/blob/main/src-tauri/src/modules/db.rs): `src-tauri/src/modules/db.rs`

### Other components

- **AI client**
- **Google AI services**
- **Anthropic services**

## Connections

- App routing → Dashboard: routes to (evidence: `src/App.tsx`)
- App routing → Account manager: routes to (evidence: `src/App.tsx`)
- App routing → Proxy controls: routes to (evidence: `src/App.tsx`)
- App routing → Settings: routes to (evidence: `src/App.tsx`)
- Account manager → Account state: uses state (evidence: `src/pages/Accounts.tsx`)
- Dashboard → Account state: uses state (evidence: `src/pages/Dashboard.tsx`)
- Account state → Account bridge: invokes (evidence: `src/stores/useAccountStore.ts`)
- Account bridge → Native commands: invokes commands (evidence: `src/services/accountService.ts`)
- Native commands → OAuth callback: references (evidence: `src-tauri/src/commands/mod.rs`)
- OAuth callback → OAuth exchange: exchanges code (evidence: `src-tauri/src/modules/oauth_server.rs`)
- Account operations → OAuth exchange: refreshes tokens
- Configuration state → Configuration bridge: invokes (evidence: `src/stores/useConfigStore.ts`)
- Configuration bridge → Configuration: loads and saves
- Proxy controls → Axum gateway: controls service
- AI client → Axum gateway: sends API requests (evidence: `README.md`)
- Axum gateway → Request middleware: applies (evidence: `src-tauri/src/proxy/server.rs`)
- Axum gateway → Protocol handlers: routes requests (evidence: `src-tauri/src/proxy/server.rs`)
- Protocol handlers → Model routing: maps model IDs
- Protocol handlers → Account dispatcher: selects account
- Protocol handlers → Protocol mappers: converts protocol (evidence: `README.md`)
- Protocol mappers → Upstream client: builds upstream request (evidence: `README.md`)
- Upstream client → Google AI services: calls (evidence: `README.md`)
- Upstream client → Anthropic services: calls (evidence: `README.md`)
- Axum gateway → Account dispatcher: holds state (evidence: `src-tauri/src/proxy/server.rs`)
