Gemini CLI Skill

gemini -p "" --yolo

When to Use

• Get a Google Gemini perspective on any question
• Free-tier AI consultation (no API key costs)
• Code review from Gemini's model
• Brainstorming and analysis tasks
• Cross-validation of Claude's own responses
• Large files or codebases that benefit from Gemini's context window
• Sandbox execution (run/test code via Gemini)

Response Times

• Simple Q&A / news query: ~2 minutes
• Codebase or large-file review: ~5–10 minutes

Usage

Ask a question

node .claude/skills/omega-gemini-cli/scripts/ask-gemini.mjs "What is the best caching strategy for a Node.js API?"

Specify model (short or long flag)

node .claude/skills/omega-gemini-cli/scripts/ask-gemini.mjs "Explain async/await" --model gemini-2.5-flash
node .claude/skills/omega-gemini-cli/scripts/ask-gemini.mjs "Explain async/await" -m gemini-2.5-flash

JSON output

node .claude/skills/omega-gemini-cli/scripts/ask-gemini.mjs "List 5 design patterns" --json
# Returns: {"response":"..."} on success, {"error":"...","raw":"..."} on parse failure

Code sandbox (short or long flag)

node .claude/skills/omega-gemini-cli/scripts/ask-gemini.mjs "Write and run a fibonacci function" --sandbox
node .claude/skills/omega-gemini-cli/scripts/ask-gemini.mjs "Write and run a fibonacci function" -s

Stdin usage

echo "Explain recursion" | node .claude/skills/omega-gemini-cli/scripts/ask-gemini.mjs

File review (embed content in prompt)

node .claude/skills/omega-gemini-cli/scripts/ask-gemini.mjs "Review this code: $(cat src/auth.ts)"

Availability Check

node .claude/skills/omega-gemini-cli/scripts/verify-setup.mjs
# Exit 0 = available (Node 18+ and Gemini CLI found)
# Exit 1 = not installed or too old

Scripts

ask-gemini.mjs

parse-args.mjs

verify-setup.mjs

format-output.mjs

Flags

--model MODEL

-m

--json

{"response":"..."}

--sandbox

-s

Models (2026)

gemini-3-pro-preview

gemini-3-flash-preview

gemini-2.5-pro

gemini-2.5-flash

gemini-2.5-flash-lite

Exit Codes

Slash Commands (when installed in a project with .claude/commands/)

/analyze

/sandbox

/omega-gemini

/brainstorm

/omega-gemini-setup

Anti-Patterns & Iron Laws

1. ALWAYS use verify-setup.mjs before first use
2. NEVER pass prompt as positional arg to raw gemini CLI — use ask-gemini.mjs wrapper
3. ALWAYS validate model parameter (wrapper validates via regex

   ^[a-zA-Z0-9._-]+$

   on Windows)
4. NEVER assume gemini is on PATH — wrapper handles npx

   @google/gemini-cli

   fallback automatically
5. ALWAYS handle exit code 1 and 9009 gracefully
6. ALWAYS set user expectations about response time before running (2–10 minutes typical)

Integration Notes

• Auth: One-time Google OAuth via

  gemini

  interactive session (run

  gemini

  once to sign in)
• Rate limits: Governed by Gemini API quotas (generous for personal use on free tier)
• Platform: Full cross-platform; Windows uses

  shell: true

  with model validation; non-Windows uses array args (no shell)
• npx fallback: On PATH miss, automatically retries with

  npx -y @google/gemini-cli

• No timeout flag: Unlike other omega wrappers, gemini wrapper has no --timeout-ms
• Stdin delivery: Prompt always sent via stdin to avoid shell argument length limits (8191-char cmd.exe limit on Windows, ARG_MAX on Linux/macOS)
• JSON envelope:

  --json

  wraps output as

  {"response":"..."}

  on success or

  {"error":"...","raw":"..."}

  on failure

Requirements

• Node.js 18+ to run the scripts
• Google Gemini CLI (

  npm install -g @google/gemini-cli

  ) with one-time Google sign-in

Memory Protocol

.claude/context/memory/learnings.md

pnpm search:code