Introduction

When performing agent tasks in DSH, a common requirement is to invoke an existing local command-line coding agent instead of manually opening a terminal, copying results, and pasting them back into the session every time. Below is an introduction to @dsh-external/dsh-subagent-antigravity: it integrates the Google Antigravity CLI (agy) as a DSH subagent. It does not require a Gemini API key and uses the existing Antigravity login.

DSH’s plugin mechanism emphasizes “everything is a plugin”. This entry comes from the community directory, which is an independent site with no official affiliation with DeepSeek / Huanfang.

What is this

@dsh-external/dsh-subagent-antigravity is a DSH plugin maintained by ZEM17 under the MIT license. Its purpose is to allow the model in a DSH session to delegate self-contained tasks to the local agy for execution and bring the results back to the current session.

It does not require a Gemini API key. agy authenticates via Antigravity login, while the plugin itself is responsible for task initiation, subsequent dialogue, task listing, cancellation, and the login window.

Core Features

Tool/Capability Description
antigravity Initiates a new self-contained task and returns a task key
antigravity_followup Continues the same session using the task key returned from the previous call
antigravity_tasks Lists running and recently finished tasks; task keys are recorded in ~/.dsh/agy-conversations.json and can be recovered across DSH restarts
antigravity_cancel Cancels a task based on the task key of a running task
antigravity_login Opens the interactive agy login window; automatically opens on authentication failure
Image Analysis Provide the image path in the prompt, e.g., C:\projects\design\mockup.png
Long Tasks Allows the model to use background: true to keep progress visible and integrate with DSH job controls (e.g., job_output / job_kill)
Optional Configuration Supports model, effort, timeout, permissions, sandbox, proxy, workspace directory, environment variables, and extra arguments

Installation and Enablement

  1. Install agy. On Windows, you can use:
irm https://antigravity.google/cli/install.ps1 | iex

The plugin searches for the executable in the order of PATH, AGY_BIN, %LOCALAPPDATA%\agy\bin, ~/.local/bin, ~/.gemini/bin, ~/go/bin.

  1. Log in to agy once:
agy

Complete the sign-in. If you encounter authentication required later, the plugin will automatically open the login window, or you can call antigravity_login.

  1. Prepare DeepSeek Harness, and use the standard web profile. This profile comes with dsh-subagent, dsh-subprocess, dsh-tools, and dsh-jobs.

  2. Install the plugin:

dsh plugin --profile web add github:ZEM17/dsh-subagent-agy

No need to restart DSH after installation. The model in the session can use the antigravity tool mentioned above.

Typical Usage

When initiating a task, you can directly describe the target path and expected results:

Use agy to rewrite the README of D:\projects\my-project and list the changes.

Use antigravity to optimize this project’s pages

Image analysis involves putting the image path in the prompt:

Use agy to describe this image: C:\projects\design\mockup.png

Use antigravity to identify this image: C:\projects\screenshots\ui.png

If the image is not in the current session workspace, you need to put the directory in the dirs parameter of the tool or write it to the addDirs configuration.

Long tasks can be requested like this:

  • For time-consuming tasks, let the model use background: true and keep progress visible.
  • When you need to continue, tell the model to use the task key returned in the last call.
  • When you need to retrieve a task, let the model use antigravity_tasks to list running and recently finished tasks.
  • When you need to stop, let the model use antigravity_cancel and pass the task key of a running task.

Optional Configuration

The following configuration items are optional. They can be placed in the plugin settings, for example $DSH_HOME/settings.yaml:

dsh-subagent-antigravity:
  model: gemini-3.1-pro-high
  effort: high
  printTimeoutMs: 300000
  backgroundTimeoutMs: 3600000
  skipPermissions: true
  sandbox: false
  addDirs: []
  proxy: ""
  env: {}
  extraArgs: []

Common field meanings:

Field Default Example Description
model '' The model identifier passed to agy; leaving it empty uses agy’s default model, which can be viewed via agy models
effort '' Optional low, medium, high; leaving it empty means not passing it
printTimeoutMs 300000 The upper limit for foreground execution, in milliseconds
backgroundTimeoutMs 3600000 The upper limit for background execution, in milliseconds
skipPermissions true Automatically approve agy tool calls
sandbox false Controls sandbox-related restrictions for agy
addDirs [] Absolute directories added to the agy workspace; needed when the target is outside the workspace
proxy "" Proxy URL; falls back to AGY_PROXY environment variable, then to ~/.dsh/agy-proxy.txt
env {} Environment variable overrides
extraArgs [] Raw arguments appended after the generated parameters

Notes and Troubleshooting

  • The plugin runs with the permissions of the current DSH process. It is recommended to check the source code and license before installing; this plugin’s license is MIT.
  • skipPermissions is true by default, which automatically approves agy tool calls. Before using it, ensure you trust the target directory of the task, the file scope, and your agy login status.
  • When the task target is outside the session workspace, you need to put the target directory in the dirs parameter or the addDirs configuration.
  • Encounter authentication required: Complete the sign-in in the popup login window, or call antigravity_login, then retry.
  • Encounter User location is not supported: Set the proxy configuration, or write to ~/.dsh/agy-proxy.txt.
  • Encounter timeout waiting for response: Increase printTimeoutMs / backgroundTimeoutMs, or switch to using background: true.

Links

  • Community Directory Page: https://www.skillhub.cn/plugins/ZEM17/dsh-subagent-agy
  • GitHub Repository: https://github.com/ZEM17/dsh-subagent-agy