dsh-subagent-gemini

Usage

The model calls it like any other delegation tool:

{
  "name": "subagent_gemini",
  "arguments": {
    "description": "Fix login timeout",
    "prompt": "In the workspace, find the login request timeout and raise it from 5s to 15s, run the related tests, and reply only with what you changed and the test result."
  }
}

• description — 3–5 word task name shown in the subagent list;
• prompt — a self-contained task; the child cannot see the parent conversation, so include paths, constraints and acceptance criteria.

When the run finishes the parent receives a completion notice with Gemini's final answer or a safe failure diagnostic. The child's tool traffic and reasoning stay out of the parent session.

Configuration

Override the subagent-gemini entry's config in a profile patch:

Field	Default	Meaning
providerName	gemini	Name registered on ctx.subagents; must be unique in one profile
command	empty (auto-detect)	Path to the gemini executable; empty searches PATH, then ~/.local/bin, /opt/homebrew/bin, /usr/local/bin, …
args	['--acp', '--skip-trust']	CLI arguments; --acp is always kept, --skip-trust is present by default
model	empty (CLI default)	Fixed model id such as gemini-2.5-flash; becomes one --model argument
permission	allow	Auto-answer for child permission requests: allow approves (edits/shell), reject declines (read-only)
env	{}	Extra environment variables layered over the credential-scrubbed parent environment
disposeEofGraceMs	6000	Time the child gets to flush after stdin EOF before escalation
disposeGraceMs	3000	Failure-observation and SIGTERM→SIGKILL escalation grace

Example — fixed model, read-only child:

- id: subagent-gemini
  config:
    model: gemini-2.5-flash
    permission: reject