dsh-tool-antigravity
English | 中文
High-performance, streamlined Antigravity capability bundle plugin for DeepSeek Harness (DSH).
Provides private Google OAuth 2.0 PKCE authentication, multi-model LLM routing (google-antigravity), session-persistent image generation and editing (generate_image, list_images), and an interactive Web settings panel with live quota visualization.
Highlights in v0.2.1 (Stability & Connection Keep-Alive)
- Pre-stream Idempotent Network Retry: Automatically retries transient network interruptions (e.g. connection resets, timeouts, or
502/503/504 errors) once prior to first byte emission (500ms backoff), while preserving strict fail-closed guarantees once generation starts to prevent duplicate billing.
- TCP Socket Keep-Alive & NoDelay: Configures 15-second TCP keepalive probes and
noDelay on raw HTTP/1.1 TLS and proxy sockets, preventing local proxies (Clash, Surge, V2Ray) and NAT routers from dropping idle connections during model reasoning pauses.
- Relaxed Stream Timeouts: Extended stream idle timeout to 120s and total timeout to 600s (10 min), comfortably accommodating extended thinking models like Gemini 3.8 Flash, Gemini 2.5 Pro, and Claude reasoning models.
- Unified Credential Storage: Consolidated the single-account credential storage under
dsh-tool-antigravity/auth.json.
- Hardened Proxy Configuration: Auto-normalizes proxy URLs without scheme prefix, adds
HTTP_PROXY fallback, and retains low-level system error causes for streamlined diagnosis.
Highlights in v0.2.0
- Streamlined Two-Pillar Scope: Completely eliminated search and video modules for minimal footprint, memory safety, and zero bloat.
- Windows Browser Opener Fix: Resolved
cmd.exe ampersand truncation (&response_type=code) using windowsVerbatimArguments: true, ensuring smooth 1-click Google OAuth flow on Windows.
- Robust Host RPC Integration: Lifecycle-managed loopback Fetch handler for
/api/dsh-tool-antigravity/* endpoints with fail-closed security.
- 100% Verified Quality: 28 test suites, 268 automated tests covering transports, lifecycle, gates, quota, and client UI with strict TypeScript checks.
Features
1. High-Performance Core Architecture
- TLS Connection Pooling & Session Resumption: Built-in HTTP/1.1 Keep-Alive socket pool and TLS session resumption against Google endpoints, eliminating repeated TLS handshake roundtrips and significantly reducing Time-To-First-Token (TTFT).
- Sliding-Window Buffer SSE Parser: High-throughput binary chunking directly locates newline separators on raw Buffers, bypassing heavy string concatenations and drastically reducing V8 heap allocations and GC spikes during long reasoning chains.
- Granular Thinking Budgets: Fine-grained reasoning effort configuration (
low, medium, high) across Gemini and Claude models with graceful fallbacks.
- Pre-flight Idempotent Retry: Automatically retries transient network interruptions (e.g. TLS RST / 502 / 503) once prior to first byte emission.
- Windows File Lock Recovery: Active PID probing (
process.kill(pid, 0)) detects stale locks from crashed processes and immediately frees them, preventing 30-second hang timeouts.
- Stale-While-Revalidate (SWR) Quota Resilience: Robust quota normalization supporting 5h and weekly windows; retains and displays last-known valid quota with smooth shimmer animations during transient network disruptions.
2. Supported Models (google-antigravity)
| Model Identifier | Display Name | Capabilities | Thinking Budget |
|---|
antigravity-gemini-3.8-flash | Gemini 3.8 Flash | Text, Vision, Tools | Low / Medium / High |
antigravity-gemini-3.7-flash | Gemini 3.7 Flash | Text, Vision, Tools | Low / Medium / High |
antigravity-gemini-3.6-flash | Gemini 3.6 Flash | Text, Vision, Tools | Default |
antigravity-gemini-3.1-pro | Gemini 3.1 Pro | Text, Vision, Tools | Low / High |
claude-sonnet-4-6-thinking | Claude Sonnet 4.6 | Text, Vision, Tools | Dynamic Reasoning |
claude-opus-4-6-thinking | Claude Opus 4.6 | Text, Vision, Tools | Dynamic Reasoning |
gpt-oss-120b-medium | GPT-OSS 120B | Text, Tools | Fixed Effort |
3. Image Generation & Multi-Turn Editing
generate_image: Prompt-based image creation and iterative image-to-image editing using session references.list_images: Inspect and retrieve generated image attachments within the current session.- Fully integrated with DSH
AttachmentStore and FileSystem with TOCTOU path escape protection without polluting chat context with raw base64 payloads.
Installation
Via DSH Plugin CLI (Recommended)
# Add directly to your active DSH web profile
dsh plugin --profile web add dsh-tool-antigravity
Via npm / pnpm
# Using npm
npm install dsh-tool-antigravity
# Using pnpm
pnpm add dsh-tool-antigravity
Cordis Plugin Configuration
Add the plugin entries to your cordis.patch.yml or DSH config file:
- id: antigravity-auth
name: 'dsh-tool-antigravity'
- id: antigravity-image
name: 'dsh-tool-antigravity/image'
Usage & Commands
Slash Commands
Manage authentication directly from the DSH terminal / chat prompt:
/antigravity-auth login: Initiates Google OAuth 2.0 PKCE login and launches your default browser./antigravity-auth status: Check current authentication state, masked email, and project id./antigravity-auth logout: Discard credentials and revoke tokens./antigravity-auth cancel: Abort an ongoing login attempt.
UI Settings & Dashboard
Once loaded in the DSH Web client:
- Antigravity Auth Settings Card: View live login status, account identifier, and toggle capabilities.
- Quota Visualizer: Real-time remaining quota percentages and countdowns for 5-hour and weekly reset windows.
- Image Generation Card: Configure default image models and batch size.
Security & Invariants
- Credential Isolation: Access and refresh tokens are strictly held in host-side secure stores and are never forwarded to the frontend UI, logs, or command done events.
- Strict Loopback Guard: Account RPC endpoints fail-closed (
loopback-required) unless the web service is explicitly bound to 127.0.0.1.
- Immutable Wire Identity: Emits verified AGY CLI headers (
antigravity/cli/1.1.24) and attribution metadata.
- Media Path Containment: All file references are verified against directory traversal and symlink escapes.
Disclaimer
This project is an unofficial, community-driven capability bundle intended strictly for personal research, educational purposes, and independent development. Please adhere to relevant platform Terms of Service.
License
MIT © dsh-tool-antigravity contributors
