# Gemini CLI Runtime > Internal helper contract for calling the gemini-companion runtime from Claude Code Use when this capability is needed. - Skill: `tomevault-io/gemini-cli-runtime-2` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/gemini-cli-runtime-2` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/gemini-cli-runtime-2/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/gemini-cli-runtime-2 --- # Gemini Runtime Use this skill only inside the `gemini:gemini-delegate` subagent. Primary helper: - `node "${CLAUDE_PLUGIN_ROOT}/scripts/gemini-companion.mjs" task ""` Execution rules: - The delegate subagent is a forwarder, not an orchestrator. Its only job is to invoke `task` once and return that stdout unchanged. - Prefer the helper over hand-rolled `git`, direct Gemini CLI strings, or any other Bash activity. - Do not call `setup`, `review`, `search`, `analyze`, `status`, `result`, or `cancel` from `gemini:gemini-delegate`. - Use `task` for every delegated request, including diagnosis, planning, research, and explicit fix requests. - You may use the `gemini-prompting` skill to rewrite the user's request into a tighter Gemini prompt before the single `task` call. - That prompt drafting is the only Claude-side work allowed. Do not inspect the repo, solve the task yourself, or add independent analysis outside the forwarded prompt text. - Leave model unset by default. Add `--model` only when the user explicitly asks for one. Command selection: - Use exactly one `task` invocation per delegate handoff. - If the forwarded request includes `--background` or `--wait`, treat that as Claude-side execution control only. Strip it before calling `task`, and do not treat it as part of the natural-language task text. - If the forwarded request includes `--model`, pass it through to `task`. - If the forwarded request includes `--resume`, strip that token from the task text and add `--resume-last`. - If the forwarded request includes `--fresh`, strip that token from the task text and do not add `--resume-last`. - `--resume`: always use `task --resume-last`, even if the request text is ambiguous. - `--fresh`: always use a fresh `task` run, even if the request sounds like a follow-up. Parameter mappings: - `--model `: passed through to `gemini-companion.mjs task --model `. Preserves the user's model choice without modification. - `--resume-last`: appended to the `task` command when the user requests continuation of previous work. - `--background`: controls whether the Bash call runs in the background. Not passed to `task`. - `--wait`: controls whether to wait for background completion. Not passed to `task`. Safety rules: - Preserve the user's task text as-is apart from stripping routing flags. - Do not inspect the repository, read files, grep, monitor progress, poll status, fetch results, cancel jobs, summarize output, or do any follow-up work of your own. - Return the stdout of the `task` command exactly as-is. - If the Bash call fails or Gemini cannot be invoked, return nothing. --- > Source: [bsmi021/ai-plugins-cc](https://github.com/bsmi021/ai-plugins-cc) — distributed by [TomeVault](https://tomevault.io).