dsh-agy

Google Antigravity (agy) access for DeepSeek Harness: OAuth authentication, a multi-account pool with automatic 429 rotation, device fingerprinting, and both CLI and web management.

中文文档：docs/README_zh.md

Features

OAuth login: one-click sign-in via browser OAuth callback, with headless paste-URL mode and a remote paste-credential blob channel.
Two management surfaces: web and CLI, either one works, core features are the same.
Multi-account pool: encrypted account store, automatic rotation on rate limits, per-account cooldown with tiered backoff, per-account device fingerprints.
Quota dashboard: only active when DSH Web is running; append /agy to your dsh web address: login, account management, per-model quota bars, model testing, credential export/import, fingerprint management.
CLI: dsh-agy login|status|import|verify|logout works standalone, with or without a harness.

Screenshots

The /agy dashboard inside DSH Web — account cards, per-model quota bars, and one-shot model tests:

dsh-agy dashboard

Quickstart

Path A: DSH Web GUI Users (Recommended — 100% Web UI, zero CLI commands)

For users using DeepSeek Harness browser workspace / Web GUI:

# 1. Install plugin into DSH web profile (via dsh CLI, or pnpx/npx if dsh is not in PATH)
dsh plugin --profile web add dsh-agy
# or: npx @deepseek-ai/dsh plugin --profile web add dsh-agy

# 2. Launch DSH Web
dsh web

# 3. Open dashboard at http://127.0.0.1:3080/agy
# Click "Login with Google", complete OAuth authorization, and start using the agy provider

Path B: Headless / Terminal Only (Standalone CLI)

For Linux VPS, SSH remote servers, or headless CI environments:

# Run directly without global install (npx / pnpx)
npx dsh-agy login
npx dsh-agy status

# Or install globally
npm install -g dsh-agy
dsh-agy login          # interactive OAuth (browser, --headless paste, or --blob)
dsh-agy status         # list accounts + quota summary
dsh-agy verify         # refresh + health check
dsh-agy import   # import agy auth.json or credential blob (--blob)
dsh-agy logout         # remove account

Command	Options	Description
`dsh-agy login`	`--headless` — print the auth URL and wait for a pasted redirect URL
`--blob` — print a paste-credential blob instead of storing the account
`--port` — loopback callback port (default `51121`)
`--project` — bind the login to a specific project
`--timeout` — callback timeout (default `300000`)	Interactive Google OAuth
`dsh-agy status`	—	List accounts + per-model quota summary
`dsh-agy import`	`--blob` — the pasted value is a credential blob
`--email` — set the account email (skips userinfo verification)
`--overwrite` — replace an existing account with the same email	Import agy auth.json files or credential blobs (multiple files / multi-line paste = batch import)
`dsh-agy export`	`--index` — export one account by index (default: all)
`--out` — write one `dsh-agy-.blob` per account (default: print to stdout, one blob per line)	Export account credentials as paste blobs
`dsh-agy verify`	`--index` — verify one account by index (default: all)	Refresh + health check
`dsh-agy logout`	`--index` — account index (default: active)
`--email` — account email	Remove an account

Category	Behavior
`soft_rate_limit` (Retry-After < 3s)	immediate retry on the same account, no cooldown
`rate_limited`	5-minute cooldown + switch to the next account (same account when single)
`quota_exhausted` ("quota reached", "individual quota", RESOURCE_EXHAUSTED…)	24-hour cooldown — no further calls to that account for the day
`unknown`	exponential backoff

Source	Content
opencode-antigravity-auth (archived)	OAuth flow shape, account-store schema & versioned migration, 429/backoff concepts, fingerprint design
antigravity-claude-proxy PR #170	Device fingerprint generation (via opencode-antigravity-auth)
OmniRoute	Wire format (envelope, headers, SSE), endpoint order, `agy` token-file parsing, paste-credential blob codec, thoughtSignature replay, 429 category engine
DeepSeek Harness	Plugin shell, `LlmAdapter` seam, DSH conventions

dsh-agy

安装

说明文档

dsh-agy

Features

Screenshots

Quickstart

Path A: DSH Web GUI Users (Recommended — 100% Web UI, zero CLI commands)

Path B: Headless / Terminal Only (Standalone CLI)

CLI reference

Path C: Local Development & Link

Uninstall

Other things you may care about

Rotation mechanics

About cache hits: why not 99% like DeepSeek V4?

Storage & secrets

⚠️ Disclaimer

Credits

Development