gemini-cli-runtime

name	gemini-cli-runtime
description	Internal contract for calling gemini-companion runtime from Claude Code
user-invocable	false

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 Bash call to gemini-companion.mjs task. Return stdout verbatim — no commentary.
• Do NOT call review, challenge, status, result, or cancel from consult.
• May use gemini-prompting skill 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 --write unless user explicitly asks for read-only.
• Do not add --background — consult runs synchronously.
• Do not interpret or summarize Gemini output — return it verbatim.