gemini

Execute Gemini CLI commands with support for multiple models and flexible prompt input. Integrates Google's Gemini AI models into Claude Code workflows.

• 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

Mandatory: Run via uv with fixed timeout 7200000ms (foreground):

```bash

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

```

Optional (direct execution or using Python):

```bash

~/.claude/skills/gemini/scripts/gemini.py "" [working_dir]

# or

python3 ~/.claude/skills/gemini/scripts/gemini.py "" [working_dir]

```

• GEMINI_MODEL: Configure model (default: gemini-3-pro-preview)

- Example: export GEMINI_MODEL=gemini-3

• 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

Plain text output from Gemini:

```text

Model response text here...

```

Error format (stderr):

```text

ERROR: Error message

```

Invocation Pattern

When calling via Bash tool, always include the timeout parameter:

```yaml

Bash tool parameters:

• command: uv run ~/.claude/skills/gemini/scripts/gemini.py ""
• timeout: 7200000
• description:

```

Alternatives:

```yaml

# Direct execution (simplest)

• command: ~/.claude/skills/gemini/scripts/gemini.py ""

# Using python3

• command: python3 ~/.claude/skills/gemini/scripts/gemini.py ""

```

Examples

Basic query:

```bash

uv run ~/.claude/skills/gemini/scripts/gemini.py "explain quantum computing"

# timeout: 7200000

```

Code analysis:

```bash

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

# timeout: 7200000

```

With specific working directory:

```bash

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

# timeout: 7200000

```

Using python3 directly (alternative):

```bash

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

```

• 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