copilot-api-plus 1.0.57 → 1.0.59

package/README.en.md

@@ -5,7 +5,7 @@
 
 English | [简体中文](README.md)
 
-> A proxy that converts GitHub Copilot, OpenCode Zen, and Google Antigravity into OpenAI & Anthropic compatible APIs. Works with Claude Code, opencode, and more.
+> A proxy that converts GitHub Copilot into OpenAI & Anthropic compatible APIs. Works with Claude Code and more.
 
 ---
 
@@ -15,11 +15,8 @@ English | [简体中文](README.md)
 - [Quick Start](#-quick-start)
 - [Usage Guide](#-usage-guide)
   - [GitHub Copilot Mode](#1-github-copilot-mode-default)
-  - [OpenCode Zen Mode](#2-opencode-zen-mode)
-  - [Google Antigravity Mode](#3-google-antigravity-mode)
 - [Proxy Configuration](#-proxy-configuration)
 - [Claude Code Integration](#-claude-code-integration)
-- [opencode Integration](#-opencode-integration)
 - [API Endpoints](#-api-endpoints)
 - [API Key Authentication](#-api-key-authentication)
 - [Technical Details](#-technical-details)
@@ -33,7 +30,7 @@ English | [简体中文](README.md)
 
 | Feature | Description |
 |---------|-------------|
-| 🔌 **Multiple Backends** | Choose from GitHub Copilot, OpenCode Zen, or Google Antigravity |
+| 🔌 **GitHub Copilot Backend** | Access AI models using your GitHub Copilot subscription |
 | 🤖 **Dual Protocol** | Supports both OpenAI Chat Completions API and Anthropic Messages API |
 | 💻 **Claude Code Integration** | One-command Claude Code setup (`--claude-code`) |
 | 📊 **Usage Monitoring** | Real-time API usage dashboard |
@@ -44,7 +41,6 @@ English | [简体中文](README.md)
 | 🔑 **API Key Auth** | Optional API key authentication for public deployments |
 | ✂️ **Context Passthrough** | Full context passthrough to upstream API; clients (e.g. Claude Code) manage compression |
 | 🔍 **Smart Model Matching** | Handles model name format differences (date suffixes, dash/dot versions, etc.) |
-| 🔁 **Antigravity Failover** | Circuit breaker state machine, weighted account dispatch, background task auto-downgrade, dual-endpoint auto-switching |
 
 ---
 
@@ -66,12 +62,6 @@ npx copilot-api-plus@latest start
 # Start server (defaults to GitHub Copilot)
 npx copilot-api-plus@latest start
 
-# Use OpenCode Zen
-npx copilot-api-plus@latest start --zen
-
-# Use Google Antigravity
-npx copilot-api-plus@latest start --antigravity
-
 # Use with Claude Code
 npx copilot-api-plus@latest start --claude-code
 ```
@@ -127,169 +117,6 @@ npx copilot-api-plus@latest start --account-type enterprise
 
 ---
 
-### 2. OpenCode Zen Mode
-
-Use [OpenCode Zen](https://opencode.ai/zen)'s multi-model API service, supporting GPT-5, Claude, Gemini, and other top coding models.
-
-#### Prerequisites
-1. Visit https://opencode.ai/zen
-2. Register and create an API Key
-
-#### Getting Started
-
-**Option 1: Interactive setup**
-```bash
-npx copilot-api-plus@latest start --zen
-```
-First run will prompt for an API Key, which is saved for future use.
-
-**Option 2: Provide API Key directly**
-```bash
-npx copilot-api-plus@latest start --zen --zen-api-key YOUR_API_KEY
-```
-
-#### Available Models
-
-| Model | ID | Description |
-|-------|-----|-------------|
-| GPT-5.2 | `gpt-5.2` | OpenAI latest |
-| GPT-5.1 Codex Max | `gpt-5.1-codex-max` | Code-optimized |
-| GPT-5.1 Codex | `gpt-5.1-codex` | Code-focused |
-| GPT-5 Codex | `gpt-5-codex` | OpenAI Responses API |
-| Claude Opus 4.5 | `claude-opus-4-5` | Anthropic Claude (200K) |
-| Claude Sonnet 4.5 | `claude-sonnet-4-5` | Anthropic Claude (200K) |
-| Claude Sonnet 4 | `claude-sonnet-4` | Anthropic Claude |
-| Gemini 3 Pro | `gemini-3-pro` | Google Gemini |
-| Qwen3 Coder | `qwen3-coder` | Alibaba Qwen |
-| Kimi K2 | `kimi-k2` | Moonshot |
-| Grok Code Fast 1 | `grok-code-fast-1` | xAI |
-
-More models at [opencode.ai/zen](https://opencode.ai/zen)
-
-#### API Endpoints
-
-Zen mode supports the following endpoints:
-
-| Endpoint | Description |
-|----------|-------------|
-| `/v1/chat/completions` | OpenAI-compatible Chat API |
-| `/v1/messages` | Anthropic-compatible Messages API |
-| `/v1/responses` | OpenAI Responses API (GPT-5 series) |
-| `/v1/models` | List available models |
-
-Dedicated endpoints (accessible without `--zen` flag):
-- `/zen/v1/chat/completions`
-- `/zen/v1/messages`
-- `/zen/v1/responses`
-- `/zen/v1/models`
-
-#### Manage API Key
-
-```bash
-# View/change API Key (clearing it will prompt for a new one on next start)
-npx copilot-api-plus@latest logout --zen
-```
-
----
-
-### 3. Google Antigravity Mode
-
-Use Google Antigravity API service, supporting Gemini and Claude models.
-
-#### Prerequisites
-- Google account
-
-#### Authentication Methods
-
-**Option 1: API Key (Recommended - Simplest)**
-
-1. Get an API Key at https://aistudio.google.com/apikey
-2. Start with environment variable:
-
-```bash
-# Linux/macOS
-GEMINI_API_KEY=your_api_key npx copilot-api-plus@latest start --antigravity
-
-# Windows PowerShell
-$env:GEMINI_API_KEY = "your_api_key"
-npx copilot-api-plus@latest start --antigravity
-
-# Windows CMD
-set GEMINI_API_KEY=your_api_key
-npx copilot-api-plus@latest start --antigravity
-```
-
-**Option 2: OAuth Web Login (Recommended)**
-
-```bash
-npx copilot-api-plus@latest start --antigravity
-```
-
-First run will prompt you to choose a login method:
-- **Web (Recommended)**: Opens browser for Google login, automatically captures the callback
-- **Manual**: Manually copy the callback URL to the terminal
-
-**Option 3: Custom OAuth Credentials**
-
-If you encounter an `invalid_client` error, create your own OAuth app:
-
-1. Visit https://console.cloud.google.com/apis/credentials
-2. Create an OAuth 2.0 Client ID (select "Desktop application" type)
-3. Add redirect URI: `http://localhost:8046/callback`
-4. Use environment variables or CLI arguments:
-
-```bash
-# Environment variables
-ANTIGRAVITY_CLIENT_ID=your_client_id ANTIGRAVITY_CLIENT_SECRET=your_secret \
-  npx copilot-api-plus@latest start --antigravity
-
-# CLI arguments
-npx copilot-api-plus@latest start --antigravity \
-  --antigravity-client-id your_client_id \
-  --antigravity-client-secret your_secret
-```
-
-#### Available Models
-
-| Model | ID | Description |
-|-------|-----|-------------|
-| Gemini 2.5 Pro | `gemini-2.5-pro-exp-03-25` | Google Gemini |
-| Gemini 2.5 Pro Preview | `gemini-2.5-pro-preview-05-06` | Google Gemini |
-| Gemini 2.0 Flash | `gemini-2.0-flash-exp` | Fast responses |
-| Gemini 2.0 Flash Thinking | `gemini-2.0-flash-thinking-exp` | Chain-of-thought |
-| Claude Opus 4.5 | `claude-opus-4-5` | Anthropic Claude |
-| Claude Sonnet 4.5 | `claude-sonnet-4-5` | Anthropic Claude |
-
-#### Features
-- ✅ Automatic token refresh
-- ✅ Multi-account support with weighted smart dispatch (quota health 60% + token freshness 20% + reliability 20%)
-- ✅ Auto-switch on quota exhaustion
-- ✅ Circuit breaker state machine (CLOSED → OPEN → HALF_OPEN → CLOSED)
-- ✅ Multi-signal agent/background request detection with optional model downgrade to save quota
-- ✅ Thinking model support (chain-of-thought output)
-
-#### Multi-Account Management
-
-Add multiple Google accounts; the system auto-switches when quota is exhausted:
-
-```bash
-# Add new account
-npx copilot-api-plus@latest antigravity add
-
-# List all accounts
-npx copilot-api-plus@latest antigravity list
-
-# Remove account by index
-npx copilot-api-plus@latest antigravity remove 0
-
-# Clear all accounts
-npx copilot-api-plus@latest antigravity clear
-# Or use logout
-npx copilot-api-plus@latest logout --antigravity
-```
-
----
-
 ## 🌐 Proxy Configuration
 
 Two ways to configure a proxy:
@@ -376,14 +203,7 @@ npx copilot-api-plus@latest start --proxy-env
 ### Auto Configuration (Recommended)
 
 ```bash
-# Using GitHub Copilot as backend
 npx copilot-api-plus@latest start --claude-code
-
-# Using OpenCode Zen as backend
-npx copilot-api-plus@latest start --zen --claude-code
-
-# Using Google Antigravity as backend
-npx copilot-api-plus@latest start --antigravity --claude-code
 ```
 
 After running:
@@ -412,70 +232,6 @@ Then start the copilot-api-plus server and run `claude` in that project director
 
 ---
 
-## 🔧 opencode Integration
-
-[opencode](https://github.com/sst/opencode) is a modern AI coding assistant.
-
-### Setup
-
-1. Create `opencode.json` in your project root:
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "provider": {
-    "copilot-api-plus": {
-      "api": "openai-compatible",
-      "name": "Copilot API Plus",
-      "options": {
-        "baseURL": "http://127.0.0.1:4141/v1"
-      },
-      "models": {
-        "claude-sonnet-4": {
-          "name": "Claude Sonnet 4",
-          "id": "claude-sonnet-4",
-          "max_tokens": 64000,
-          "profile": "coder",
-          "limit": { "context": 200000 }
-        },
-        "gpt-4.1": {
-          "name": "GPT-4.1",
-          "id": "gpt-4.1",
-          "max_tokens": 32768,
-          "profile": "coder",
-          "limit": { "context": 1047576 }
-        }
-      }
-    }
-  }
-}
-```
-
-2. Start copilot-api-plus:
-```bash
-npx copilot-api-plus@latest start
-```
-
-3. Run opencode in the same directory:
-```bash
-npx opencode@latest
-```
-
-4. Select `copilot-api-plus` as the provider
-
-### Shortcut: Environment Variables
-
-```bash
-# Set environment variables
-export OPENAI_BASE_URL=http://127.0.0.1:4141/v1
-export OPENAI_API_KEY=dummy
-
-# Run opencode
-npx opencode@latest
-```
-
----
-
 ## 📡 API Endpoints
 
 The server listens on `http://localhost:4141` by default.
@@ -497,13 +253,11 @@ The server listens on `http://localhost:4141` by default.
 
 ### Dedicated Endpoints
 
-Each backend has its own dedicated routes, accessible regardless of the default backend:
+Each backend has its own dedicated routes:
 
 | Route Prefix | Description |
 |--------------|-------------|
 | `/copilot/v1/*` | GitHub Copilot |
-| `/zen/v1/*` | OpenCode Zen |
-| `/antigravity/v1/*` | Google Antigravity |
 
 ### Monitoring Endpoints
 
@@ -590,35 +344,6 @@ Anthropic-format model names (e.g. `claude-opus-4-6`) may differ from Copilot's
 
 For Anthropic endpoints (`/v1/messages`), `translateModelName` also handles legacy format conversion (e.g. `claude-3-5-sonnet` → `claude-sonnet-4.5`) before applying the above strategies.
 
-### Antigravity Endpoint Failover
-
-Google Antigravity mode has multi-layered reliability features:
-
-- **Circuit breaker state machine**: Independent per model family (claude/gemini/other). Opens after 3 failures, half-opens after 30s for probing, closes after 2 consecutive successes
-- **Weighted account dispatch**: Replaces simple round-robin. Scoring formula: `score = quotaHealth×0.6 + tokenFreshness×0.2 + reliability×0.2`, always selects the healthiest account
-- **Background task detection & downgrade**: Multi-signal weighted detection (tool_calls +0.5, tool role +0.4, assistant density +0.2, long conversation +0.1). Score ≥ 0.6 identifies agent requests, which can be auto-downgraded to cheaper models (e.g. claude-sonnet-4-5 → gemini-2.5-flash). Enable via `ANTIGRAVITY_BACKGROUND_DOWNGRADE=1` env var (off by default)
-- **Dual-endpoint auto-switching**: Daily sandbox and production endpoints; automatically switches on failure
-- **Exponential backoff retry**: Auto-retry on 429/503 errors; short intervals stay on the same endpoint, longer intervals switch endpoints
-
-#### Background Downgrade Environment Variable
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `ANTIGRAVITY_BACKGROUND_DOWNGRADE` | `0` (off) | Set to `1` to enable automatic model downgrade for agent/background requests |
-
-Downgrade mapping:
-
-| Original Model | Downgraded To |
-|----------------|---------------|
-| `claude-sonnet-4-5` | `gemini-2.5-flash` |
-| `claude-sonnet-4-5-thinking` | `gemini-2.5-flash-thinking` |
-| `claude-opus-4-5-thinking` | `claude-sonnet-4-5-thinking` |
-| `gemini-2.5-pro` | `gemini-2.5-flash` |
-| `gemini-3-pro-high` | `gemini-3-flash` |
-| `gemini-3-pro-low` | `gemini-3-flash` |
-
-Clients can also explicitly mark background requests via the `X-Request-Type: background` header, bypassing detection entirely.
-
 ### Request Logging
 
 Each API request outputs a log line with model name, status code, and duration:
@@ -648,7 +373,6 @@ Built-in retry for transient network errors (TLS disconnect, connection reset, e
 | `auth` | Run GitHub authentication only |
 | `logout` | Clear saved credentials |
 | `proxy` | Configure proxy settings |
-| `antigravity` | Manage Google Antigravity accounts |
 | `check-usage` | View Copilot usage |
 | `debug` | Show debug information |
 
@@ -660,11 +384,6 @@ Built-in retry for transient network errors (TLS disconnect, connection reset, e
 | `--verbose` | `-v` | false | Verbose logging |
 | `--account-type` | `-a` | individual | Account type (individual/business/enterprise) |
 | `--claude-code` | `-c` | false | Generate Claude Code launch command |
-| `--zen` | `-z` | false | Enable OpenCode Zen mode |
-| `--zen-api-key` | - | - | Zen API Key |
-| `--antigravity` | - | false | Enable Google Antigravity mode |
-| `--antigravity-client-id` | - | - | Antigravity OAuth Client ID |
-| `--antigravity-client-secret` | - | - | Antigravity OAuth Client Secret |
 | `--rate-limit` | `-r` | - | Request interval (seconds) |
 | `--wait` | `-w` | false | Wait instead of error when rate limited |
 | `--manual` | - | false | Manually approve each request |
@@ -691,29 +410,10 @@ Built-in retry for transient network errors (TLS disconnect, connection reset, e
 | Option | Alias | Description |
 |--------|-------|-------------|
 | `--github` | `-g` | Clear GitHub Copilot credentials only |
-| `--zen` | `-z` | Clear Zen credentials only |
-| `--antigravity` | - | Clear Antigravity credentials only |
 | `--all` | `-a` | Clear all credentials |
 
 > **Tip**: Running `logout` without arguments shows an interactive menu.
 
-### antigravity Subcommands
-
-| Subcommand | Description |
-|------------|-------------|
-| `add` | Add a new Antigravity account (OAuth login) |
-| `list` | List all configured accounts and their status |
-| `remove <index>` | Remove account by index |
-| `clear` | Clear all Antigravity accounts (requires confirmation) |
-
-```bash
-# Examples
-npx copilot-api-plus@latest antigravity add      # Add account
-npx copilot-api-plus@latest antigravity list     # List accounts
-npx copilot-api-plus@latest antigravity remove 0 # Remove account at index 0
-npx copilot-api-plus@latest antigravity clear    # Clear all accounts
-```
-
 ---
 
 ## 🐳 Docker Deployment
@@ -776,8 +476,6 @@ All data is stored in `~/.local/share/copilot-api-plus/`:
 | File | Description |
 |------|-------------|
 | `github_token` | GitHub Token |
-| `zen-auth.json` | Zen API Key |
-| `antigravity-accounts.json` | Antigravity accounts |
 | `config.json` | Proxy and other settings |
 
 ### Switching Accounts
@@ -791,12 +489,6 @@ npx copilot-api-plus@latest logout --github
 # Or shorthand
 npx copilot-api-plus@latest logout -g
 
-# Clear Zen credentials
-npx copilot-api-plus@latest logout --zen
-
-# Clear Antigravity credentials
-npx copilot-api-plus@latest logout --antigravity
-
 # Clear all credentials
 npx copilot-api-plus@latest logout --all
 ```