AGY_DSH_Plugin (agy-dsh-plugin)

Google Antigravity CLI (agy acp) integration plugin for DeepSeek Harness (DSH) (@deepseek-ai/dsh >= 0.2.2-rc.1).

How It Works

• 100% Official Auth & ToS-Safe: Delegates all authentication and model traffic directly to the unmodified agy binary (agy acp --stdio --process-per-session) and its native OS keyring (agy acp --login). No credential scraping, no binary patching, no User-Agent spoofing.
• AGY Engine + DSH Tools (MCP Bridge): When using Antigravity models in DSH, agy acp acts as the model engine while DSH remains the primary harness—executing tools, subagents, approvals, and plugins through an isolated loopback MCP server (127.0.0.1:0 with per-session Bearer auth and optional isolated --gemini-dir).
• Running AGY Natively: If you want to run agy with its own built-in tools outside the DSH toolset, run agy directly in a terminal hosted inside DSH (or any local terminal).
• Incremental Sync & Hot-Swap: Uses ACP session/load and SHA-256 prefix hashing (history-sync) so you can switch between deepseek and antigravity in the same DSH session without losing context or blowing up prompt cache.

Quick Start

1. Authenticate with the official Antigravity CLI:

   agy acp --login
   

2. Install or clone the plugin. Prebuilt artifacts are already included in lib/ for immediate use, or you can rebuild from source at any time:

   npm install
   npm run build
   

3. Install/link into DSH as a Cordis plugin (agy-dsh-plugin) and select provider antigravity.

Configuration Options

Option	Default	Description
agyExecutable	'agy'	Path or command name for the Antigravity CLI (agy).
mcpSchemaMode	'compact'	'compact', 'compact-router', or 'full' for MCP schema size optimization.
isolateBridgeGeminiDir	true	Uses an isolated --gemini-dir to avoid duplicating global ~/.gemini MCP servers alongside DSH tools.
useAgySandbox	true	Passes --sandbox to agy acp to restrict commands outside the workspace.
enableThinking	true	Streams agent_thought_chunk reasoning blocks to the DSH UI.
defaultModel	'gemini-2.5-pro'	Default Antigravity model ID when the session does not specify one.
modelsCacheTtlSec	21600	Disk cache TTL (seconds) for the agy models catalog (60–604800).
idleTimeoutSec	0	Idle seconds after a turn finishes before closing agy acp (0 = close immediately after each turn and resume via session/load).
toolTimeoutSec	300	Maximum wait time (seconds) for a tool execution (10–3600).
extraSystemInstructions	''	Additional user instructions appended to the session.

Development & Tests

npm run typecheck
npm run build
npm test

License

MIT