Gemini CLI Runtime Contract
This skill defines how to call the gemini-companion.mjs runtime from Claude Code agents and commands.
Primary entry point
node "${CLAUDE_PLUGIN_ROOT}/scripts/gemini-companion.mjs" task "<prompt and flags>"
Rescue agent rules
- One
Bashcall togemini-companion.mjs task. Return stdout verbatim — no commentary. - Do NOT call
review,challenge,status,result, orcancelfrom consult. - May use
gemini-promptingskill ONLY to shape the prompt before forwarding.
Flag handling
| Flag | Behavior |
|---|---|
--model <alias> |
Passed through to companion; alias resolution happens inside |
--effort <level> |
Reserved for future use (not yet supported by Gemini CLI) |
--resume-last |
Resumes latest Gemini session thread |
--write |
Enables write mode (--yolo inside companion) |
--background / --wait |
Strip these — consult always runs foreground |
--resume / --fresh |
Strip these routing flags; use --resume-last instead |
Default behavior
- Default
--writeunless user explicitly asks for read-only. - Do not add
--background— consult runs synchronously. - Do not interpret or summarize Gemini output — return it verbatim.
Source: arescope/gemini-plugin-cc — distributed by TomeVault.