diff --git a/README.md b/README.md
index d0e71f8..7e2cdda 100644
--- a/README.md
+++ b/README.md
@@ -1,366 +1,225 @@
-
-
Gemini Nexus
+

-
- ๐ Professional multi-account AI gateway for Google Gemini & Claude
-
+# Gemini Nexus
-
- English | Portuguรชs | ไธญๆ | Espaรฑol
-
+**A desktop gateway that pools your Google Gemini and Claude accounts behind one
+local OpenAI- and Anthropic-compatible API โ with automatic account switching,
+usage analytics and full traffic inspection.**
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+English | [Portuguรชs](README.pt-BR.md) | [ไธญๆ](README.zh-CN.md) | [Espaรฑol](README.es.md)
+
+[Install](#installation) ยท [Features](#features) ยท [How it works](#how-it-works) ยท [Build from source](#build-from-source) ยท [CI/CD](#cicd)
+
+
+
+> [!NOTE]
+> **Project status:** actively released โ current version is **0.15.3** (2026-05-02),
+> versioned automatically by semantic-release from Conventional Commits (see
+> [`CHANGELOG.md`](CHANGELOG.md)). The app started as a fork of
+> [AntigravityManager](https://github.com/Draculabo/AntigravityManager); most of the
+> code has since been rewritten (see [Licensing and credits](#licensing-and-credits)).
> [!IMPORTANT]
-> **Windows Users:** If you see a **"Windows protected your PC"** (SmartScreen) warning during installation, click **"More info"** and then **"Run anyway"**. This is an expected security prompt for new, unsigned applications.
+> **Mixed licensing.** Code inherited from AntigravityManager is under
+> **CC BY-NC-SA 4.0** ([`LICENSE`](LICENSE) โ non-commercial, share-alike); all new
+> code is under **MIT** ([`LICENSE-MIT`](LICENSE-MIT)). The project is being migrated
+> to MIT as the remaining original code is rewritten. Check both files before any
+> commercial use.
----
+## Why Gemini Nexus
-## ๐ Table of Contents
+Working with AI-powered IDEs and coding tools on a single account means quota that
+runs out, manual account switching, no idea how many tokens you spent, and no view
+of what the proxy actually sends. Gemini Nexus puts all of that in one desktop app:
-- [โจ Why Gemini Nexus?](#-why-gemini-nexus)
-- [๐ฏ Features](#-features)
-- [๐ธ Screenshots](#-screenshots)
-- [โก Installation & Quick Start](#-installation--quick-start)
-- [๐ ๏ธ Tech Stack](#๏ธ-tech-stack)
-- [๐ป Development](#-development)
-- [โ FAQ](#-faq)
-- [๐ค Contributing](#-contributing)
-- [๐ License](#-license)
+- **Account pool** โ add as many Google accounts as you need via OAuth.
+- **Smart auto-switching** โ rotates to the next available account when quota is low or rate-limited.
+- **Drop-in local proxy** โ speaks the OpenAI and Anthropic protocols, so Cursor, Windsurf, OpenCode and any compatible tool can point at it.
+- **Observability** โ live traffic monitor, request replay and per-model capability inspector.
+- **Usage analytics** โ token charts, trends and cost tracking.
----
+## Features
-## โจ Why Gemini Nexus?
+| Area | What you get |
+|---|---|
+| **Cloud account pool** | OAuth sign-in; avatar, email, status (Active / Rate Limited / Expired) and last-used time; per-account proxy URL; device identity profiles with history |
+| **Local API gateway** | `POST /v1/chat/completions` (OpenAI), `POST /v1/messages` (Anthropic), `GET /v1/models` and `GET /v1/models/capabilities`; SSE streaming; model mapping (e.g. `claude-sonnet-4-6` โ `gemini-3-flash`); configurable port, timeout (default 120 s) and API key; per-model visibility |
+| **Auto-switching** | Switches when an account's quota drops below 5 % or it is rate-limited; background quota monitor every 5 minutes; scheduling modes `cache-first`, `balance` and `performance-first`; circuit breaker with 60 s โ 5 min โ 30 min โ 2 h backoff |
+| **Usage analytics** | Token consumption charts (daily/hourly, prompt vs. completion), trend indicators, model ranking, cost tracking with custom model pricing |
+| **Proxy observability** | Traffic monitor (latency, status, model), request replay, model capabilities (vision, thinking, streaming, JSON mode), cURL and Python snippets, IDE Quick Setup (OpenCode, Cursor, VS Code, Claude Code) |
+| **Security** | AES-256-GCM for sensitive data, OS credential storage (Keytar + Electron SafeStorage), automatic migration of legacy plaintext data |
+| **Desktop experience** | System tray, dark / light / system theme, collapsible sidebar, status bar with live proxy indicators, UI in English, ็ฎไฝไธญๆ, ะ ัััะบะธะน and Tiแบฟng Viแปt |
-When using AI-powered IDEs and coding tools, have you ever run into these problems?
+The account-pool and auto-switching design is written up in
+[`docs/cloud_features.md`](docs/cloud_features.md).
-- ๐ซ **Quota limits:** Single account quotas run out quickly, requiring frequent manual switching.
-- ๐ **Account management:** Managing multiple Google/Claude accounts is cumbersome.
-- ๐ **Blind usage:** You don't know how much quota or how many tokens you've actually consumed.
-- ๐ **Integration issues:** You need a reliable local API proxy that speaks OpenAI/Anthropic protocols natively.
-- ๐ **Lack of transparency:** You can't see what's actually being sent or received by the proxy under the hood.
+
-
-
- โ๏ธ Cloud Account Pool
-
- - Add unlimited Google Gemini / Claude accounts via OAuth
- - Display avatar, email, status, and last used time
- - Real-time status monitoring (Active, Rate Limited, Expired)
- - Per-account proxy URL configuration
- - Device identity profile management with history
-
- |
-
- ๐ Usage Analytics Dashboard
-
- - Real-time token consumption with 15s auto-refresh
- - Area charts for daily/hourly prompt & completion tokens
- - Trend indicators (% change vs previous period)
- - Inline sparklines on stat cards
- - Model distribution ranking with horizontal bar charts
- - Prompt/Completion ratio visualization
-
- |
-
-
-
- ๐ Local API Proxy (Gateway)
-
- - OpenAI
/v1/chat/completions compatible endpoint
- - Anthropic
/v1/messages compatible endpoint
- - Full SSE streaming support (tested with Cursor, Windsurf, OpenCode)
- - Model mapping (e.g.
claude-sonnet-4-6 โ gemini-3-flash)
- - Configurable port, timeout, and API key
- - Model visibility control (show/hide specific models)
-
- |
-
- ๐ Intelligent Auto-Switching
-
- - Unlimited pool mode with smart backup selection
- - Auto-switch when quota < 5% or rate-limited
- - Background monitoring every 5 minutes
- - Graceful fallback with status reason tracking
-
- |
-
-
-
- ๐ Proxy Observability (Advanced)
-
- - Traffic Monitor โ Live request/response log with latency, status, and model info
- - Request Replay โ Replay any recorded request for debugging
- - Model Capabilities โ Inspect vision, thinking, streaming, JSON mode support per model
- - Developer Tools โ cURL & Python code generation, one-click copy
-
- |
-
- ๐ Security & Encryption
-
- - AES-256-GCM encryption for all sensitive data
- - OS native credential manager integration (Keytar + SafeStorage)
- - Auto migration of legacy plaintext data
- - Encrypted token & quota storage per account
-
- |
-
-
-
- โ๏ธ Settings & Customization
-
- - Dark / Light / System theme support
- - Multi-language: English & Portuguรชs (Brasil)
- - Per-account proxy URL override
- - Model visibility toggles
- - Log directory access
-
- |
-
- ๐ฅ๏ธ Desktop Experience
-
- - Native Electron app with system tray integration
- - Collapsible sidebar with persistent state
- - Responsive layouts across all views
- - Status bar with live proxy and connection indicators
- - Error boundaries with user-friendly fallbacks
-
- |
-
-
-
----
-
-## ๐ธ Screenshots
-
-
-