Gemini CLI Integration

Overview

When to Use

• Complex reasoning tasks requiring advanced AI capabilities
• Code generation and analysis with Gemini models
• Tasks requiring Google's latest AI technology
• Alternative perspective on code problems

Usage

uv run ~/.claude/skills/gemini/scripts/gemini.py "<prompt>" [working_dir]

~/.claude/skills/gemini/scripts/gemini.py "<prompt>" [working_dir]
# or
python3 ~/.claude/skills/gemini/scripts/gemini.py "<prompt>" [working_dir]

Environment Variables

• GEMINI_MODEL: Configure model (default:

  gemini-3-pro-preview

  )
  • Example:

    export GEMINI_MODEL=gemini-3

Timeout Control

• Fixed: 7200000 milliseconds (2 hours), immutable
• Bash tool: Always set

  timeout: 7200000

  for double protection

Parameters

• prompt

  (required): Task prompt or question

• working_dir

  (optional): Working directory (default: current directory)

Return Format

Model response text here...

ERROR: Error message

Invocation Pattern

Bash tool parameters:
- command: uv run ~/.claude/skills/gemini/scripts/gemini.py "<prompt>"
- timeout: 7200000
- description: <brief description of the task>

# Direct execution (simplest)
- command: ~/.claude/skills/gemini/scripts/gemini.py "<prompt>"

# Using python3
- command: python3 ~/.claude/skills/gemini/scripts/gemini.py "<prompt>"

Examples

uv run ~/.claude/skills/gemini/scripts/gemini.py "explain quantum computing"
# timeout: 7200000

uv run ~/.claude/skills/gemini/scripts/gemini.py "review this code for security issues: $(cat app.py)"
# timeout: 7200000

uv run ~/.claude/skills/gemini/scripts/gemini.py "analyze project structure" "/path/to/project"
# timeout: 7200000

python3 ~/.claude/skills/gemini/scripts/gemini.py "your prompt here"

Notes

• Recommended: Use

  uv run

  for automatic Python environment management (requires uv installed)
• Alternative: Direct execution

  ./gemini.py

  (uses system Python via shebang)
• Python implementation using standard library (zero dependencies)
• Cross-platform compatible (Windows/macOS/Linux)
• PEP 723 compliant (inline script metadata)
• Requires Gemini CLI installed and authenticated
• Supports all Gemini model variants (configure via

  GEMINI_MODEL

  environment variable)
• Output is streamed directly from Gemini CLI