@dsh-external/dsh-subagent-antigravity

Usage

The model calls the tools automatically when you ask for it; you can also prompt it explicitly:

Surface	Name	What it does
new task	antigravity	delegate a self-contained task to agy (fresh conversation); returns a task key
follow-up	antigravity_followup	continue a previous agy conversation via its task key — full context carries over
list	antigravity_tasks	list running tasks + recent finished tasks; task keys survive DSH restarts
cancel	antigravity_cancel	stop a running task by its task key (agy process tree terminated)
login	antigravity_login	pop the interactive agy login window (also opens automatically on auth failures)

Example prompts:

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

"用 antigravity 优化这个项目的页面" (in a Chinese session)

Image analysis

agy's model is multimodal — put an image path in the prompt and it will describe or analyze the image:

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

"用 antigravity 识别这张图片：C:\projects\screenshots\ui.png"

Images inside the session workspace work directly; images elsewhere need the directory in the tool's dirs parameter (or the addDirs config).

• Tasks targeting files outside the session workspace need the target directory: the tool takes a dirs parameter (the model passes it when you give it the path).
• Long tasks: the model uses background: true for long jobs — it keeps you posted on live progress and reports the final result when done.
• Continue a task: tell the model to continue using the task key from a previous call.
• Find a task again: antigravity_tasks lists running and recent finished tasks — task keys are recorded in ~/.dsh/agy-conversations.json and survive DSH restarts, so a key can always be recovered for follow-up.
• Stop a task: antigravity_cancel with the running task's key stops it (also possible via job_kill for background jobs).

---

Configuration

All fields are optional; sane defaults are shown. Configure through the plugin's settings section (e.g. $DSH_HOME/settings.yaml):

dsh-subagent-antigravity:
  model: gemini-3.1-pro-high   # agy models; empty = agy default
  effort: high                 # low | medium | high
  printTimeoutMs: 300000       # foreground ceiling (5 min)
  backgroundTimeoutMs: 3600000 # background ceiling (1 h)
  skipPermissions: true        # auto-approve agy tool calls (headless needs it)
  addDirs: []                  # absolute dirs added to the agy workspace (--add-dir)
  proxy: ""                    # proxy URL; falls back to AGY_PROXY, then ~/.dsh/agy-proxy.txt

Field	Default	Meaning
providerName	antigravity	registry name on ctx.subagents
toolName	antigravity	new-task tool name
followupToolName	antigravity_followup	follow-up tool name
loginToolName	antigravity_login	login-window tool name
tasksToolName	antigravity_tasks	tasks-listing tool name
cancelToolName	antigravity_cancel	cancel-running-task tool name
command	agy	executable (PATH name or absolute path)
model	''	--model (see agy models); empty = agy default
effort	''	--effort low|medium|high; empty = omit
agent	''	--agent ; empty = omit
printTimeoutMs	300000	foreground run ceiling (--print-timeout)
backgroundTimeoutMs	3600000	background run ceiling (1 h)
watchdogMarginMs	60000	force-kill margin after the ceiling if agy hangs
skipPermissions	true	--dangerously-skip-permissions (auto-approve agy tool calls)
sandbox	false	--sandbox (agy terminal-sandbox restrictions)
avoidBrowser	true	append a note telling agy NOT to use headless browser tools (they can hang on some machines)
avoidLargeReads	true	append a note telling agy to inspect files > 1 MB via grep/sed instead of its read tool (4 MB cap)
outputFormat	json	wire format (json or text); background prefers stream-json automatically
extraArgs	[]	raw extra argv appended after generated flags
cwd	''	working-directory override; empty = the session workspace
addDirs	[]	absolute dirs added to the agy workspace (--add-dir) — required for targets outside the session workspace
env	{}	environment overlay merged after the harness credential scrub
proxy	''	proxy URL; falls back to AGY_PROXY env, then ~/.dsh/agy-proxy.txt (re-read per call)
registryPath	''	follow-up registry file; empty = ~/.dsh/agy-conversations.json
disposeGraceMs	5000	tree-termination grace (SIGTERM → SIGKILL)
autoLoginWindow	true	on auth failure, pop the interactive login window automatically
loginWindowMinimized	true	launch the login window minimized (taskbar icon only)

---