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

dsh-subagent-gemini

インストール

ドキュメント

Usage

Configuration