From gemini-plugin
Executes Google Gemini CLI for code analysis, review, and validation in headless mode for CI/CD pipelines and automation scripts. Configures models, JSON outputs, sandbox modes, and manages sessions.
npx claudepluginhub creator-hian/claude-code-plugins --plugin gemini-pluginThis skill uses the workspace's default tool permissions.
| Environment | Command Format |
Invokes OpenAI Codex and Google Gemini CLIs via Bash for second opinions, code reviews, and alternative analysis. Useful when users request external AI verification or explicitly say 'ask codex' or 'ask gemini'.
Use when the user asks to run Gemini CLI (gemini, gemini resume) or references Google Gemini for code analysis, refactoring, or automated editing
Delegates tasks to Gemini CLI for large-context analysis like broad codebase reviews or long-document processing. Activates on explicit requests such as 'use gemini' or 'delegate to gemini'.
Share bugs, ideas, or general feedback.
| Environment | Command Format |
|---|---|
| Interactive terminal | gemini (enters interactive mode) |
| Claude Code / CI | gemini -p "prompt" (headless mode) |
| Scripting with JSON | gemini -p "prompt" --output-format json |
| Stdin input | echo "prompt" | gemini or cat file | gemini -p "analyze" |
Non-TTY environments (Claude Code, CI pipelines) require -p flag or stdin input.
# Basic review
gemini -p "Review this code for bugs"
# With JSON output for parsing
gemini -p "Analyze this code" --output-format json
# With specific model and directories
gemini -m gemini-3-flash-preview --include-directories ./src,./lib -p "Code analysis"
# Stdin input with prompt
cat src/auth.py | gemini -p "Review for security issues"
result=$(gemini -p "Query" --output-format json)
response=$(echo "$result" | jq -r '.response')
Note: Model names change as Google releases new versions. Run
gemini --helpor check Gemini API Models for the current list.
| Model | Description | Best For |
|---|---|---|
gemini-3-flash-preview | Fast and efficient (DEFAULT) | Standard reviews, batch operations, general use |
gemini-3.1-pro-preview | Latest flagship model | Complex architecture analysis, security audits |
| Format | Description | Use Case |
|---|---|---|
| (default) | Human-readable text | Terminal output |
json | Structured with stats | Script parsing, automation |
stream-json | JSONL events | Real-time monitoring |
Full schema: See Options Reference
Key fields: response (string), stats (object), error (optional object)
| Option | Alias | Description |
|---|---|---|
--prompt | -p | Run in headless mode with prompt |
--model | -m | Model selection |
--output-format | Output format (json, stream-json) | |
--include-directories | Additional context directories (comma-separated) | |
--yolo | -y | Auto-approve all actions |
--sandbox | -s | Sandbox mode (restrictive) |
--approval-mode | Set approval mode (auto_edit) |
Full examples: See Examples for detailed patterns
# Code review with output
cat src/auth.py | gemini -p "Review for security issues" > review.txt
# JSON output with jq parsing
result=$(gemini -p "Query" --output-format json)
echo "$result" | jq -r '.response'
# Cross-directory analysis
gemini --include-directories ./backend,./frontend -p "Review API integration"
| Task Type | Recommended Timeout | Claude Code Tool |
|---|---|---|
| Quick checks | 2 minutes | timeout: 120000 |
| Standard review | 5 minutes | timeout: 300000 |
| Deep analysis | 10 minutes | timeout: 600000 |
Recommendation: Use timeout: 600000 for complex analysis with gemini-3.1-pro-preview.
Detailed error handling patterns: See Examples
| Error | Cause | Solution |
|---|---|---|
| No output | Missing -p flag | Use gemini -p "prompt" |
| Empty response | No stdin/prompt | Provide via -p or stdin |
Exit code 1 | General error | Check JSON .error field |
| Context too large | Too many files | Use specific paths |
| Permission denied | Sandbox restrictions | Use --yolo carefully |
-p flag in Claude Code and CI environments--output-format json for script parsingjq for reliable extraction.error in JSON response for error handling--include-directories for multi-directory contextgemini-3-flash-preview for most tasks, gemini-3.1-pro-preview only for complex architecture/securitytimeout: 600000)