Antigravity-Next-for-DSH

Antigravity Next for DSH

English | 繁體中文 | 简体中文

An unofficial model provider plugin for DeepSeek Harness (DSH). It connects locally installed Google Antigravity / Cloud Code Assist models directly to your DSH agent loop under provider id agy-next.

Disclaimer: Unofficial integration. Not affiliated with, endorsed by, or officially supported by Google or DeepSeek. Requires an authorized Google account and a local installation of the official Antigravity application.

---

Highlights

• Zero Cloud Console Setup: Resolves OAuth client pairs directly from your local Antigravity desktop or Antigravity IDE installation. No need to create a project or credentials in Google Cloud Console.
• Dual Layout & IDE Support: Seamlessly supports both the official desktop app (Electron ASAR) and Antigravity IDE (VS Code fork), with automated fallback and custom directory discovery.
• Smart Path & Shortcut Piercing: Paste any install directory, executable (Antigravity.exe / Antigravity IDE.exe), internal folder (resources/app), or Windows Start Menu .lnk shortcut; the resolver automatically recovers the canonical root.
• Multi-Account Pooling: Add multiple Google accounts with quota thresholds. When one account runs out, the plugin automatically switches to a standby account.
• Quota Telemetry: Live quota progress bars for Gemini, Claude, and Gemini 4 Argon (5-hour and weekly windows) directly in the Settings panel.
• Reasoning Effort Control: Direct mapping for reasoning efforts (Low, Medium, High) across Gemini 4 Argon, Gemini 3.8 Flash, and Claude models.
• Local Credential Storage: Discovery is read-only. Tokens stay in <DSH_HOME>/storages/agy-next-oauth.json and are never uploaded.

---

Requirements

1. DeepSeek Harness: 0.1.5 ~ 0.2.x (verified through 0.2.1), Node.js >=20.
2. Official Antigravity Installation: Either the official desktop app or Antigravity IDE installed locally on Windows or macOS (Linux support in progress). The application does not need to be running.
3. Google Account: Standard Google account with browser consent capability.

---

Installation

Method 1: DSH Marketplace (Recommended)

1. Open Plugins → Marketplace in the DSH sidebar.
2. Search for agy-next or antigravity.
3. Click Install, then restart DSH.

Method 2: CLI Installation

Install directly into your profile directory:

cd ~/.dsh/profiles/desktop
npm install agy-next@latest

Method 3: Local Developer Link

dsh plugin --profile <profile> add link:/absolute/path/to/agy-next

---

Getting Started

1. Account Setup

In DSH, open Settings → AGY-Next:

1. Check Status: Confirm DSH detects the local Antigravity desktop or IDE installation.
2. Custom Path (Optional): If installed in a non-standard directory, paste the folder, executable, or Start Menu shortcut into the "Custom installation path" field and click Check ➔ Save.
3. Add Account: Click Sign in / Add account. Complete authentication in the browser.
4. The account appears in the Account Pool with real-time quota progress bars.

CLI commands:

npm run login              # Sign in account
npm run login -- --status  # Check active account & quota
npm run login -- --force   # Force re-authentication
npm run login -- --logout  # Clear stored credentials

---

Configuration

Custom parameters can be set in your profile's cordis.yml:

- id: agy-next
  name: agy-next
  config:
    clientSource: "auto"             # "auto" (default, desktop first with IDE fallback), "desktop", or "ide"
    credentialPath: ""               # Default: <DSH_HOME>/storages/agy-next-oauth.json
    streamIdleTimeoutMs: 300000      # Idle stream protection timeout (ms, default 5 mins)
    discoveryTimeoutMs: 8000         # Local client discovery timeout (ms)
    projectCacheTtlMs: 1800000       # Project metadata cache TTL (ms, 30 mins)
    runtimeModel: ""                 # Optional: pin a specific upstream model id

---

Supported Models

Model Family	Key Models	Context Window	Key Capabilities
Gemini 4 Argon	gemini-4-argon	1M tokens	Low / Medium / High reasoning efforts, 5h & weekly quota telemetry
Gemini 3 / 2.5	gemini-3.8-flash, gemini-3-flash, gemini-2.5-pro, gemini-2.5-flash	1M tokens	High-speed multimodal streaming, tool calling
Claude	claude-sonnet-5-5, claude-opus-5-5, claude-opus-4-6, claude-sonnet-4-6	1M tokens	Deep integration with Cloud Code Assist Claude runtime
Open Source	gpt-oss-120b	128k tokens	High-parameter open-weights inference

---

Development

Run offline tests inside agy-next/:

npm run check          # Syntax validation across all 43 modules
npm test               # Offline regression suite (36 fixture tests)
npm run test:peers     # Strict host peer contract test (requires AGY_PEER_ROOT)
npm run verify:peers   # Host contract verification against real peers

To run peer contract tests, export the DSH runtime dependency path:

$env:AGY_PEER_ROOT = 'C:\path\to\dsh\node_modules'
npm run test:peers

---

Security

• No Hardcoded Secrets: The repository contains no Google Client IDs or Client Secrets. Values are resolved dynamically at runtime from local application resources.
• Storage Isolation: Credentials are saved to agy-next-oauth.json under the DSH home directory. The official Antigravity app database is never read or modified.
• Tombstone Cleanup: Signing out writes an empty book with loggedOut: true to prevent automatic re-import from legacy configurations.

---

License

MIT © Kizaki