gemini-cli

Delegates large-codebase analysis to Gemini CLI in non-interactive mode via subagents.

15|1|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/fprochazka/claude-code-plugins --skill gemini-cli-fprochazka
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gemini-cli
Source: https://github.com/fprochazka/claude-code-plugins/tree/main/plugins/gemini-cli/skills/gemini-cli
Command: npx skills add https://github.com/fprochazka/claude-code-plugins --skill gemini-cli-fprochazka

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Claude's context window cannot hold very large codebases, making deep multi-file analysis, security audits, and architecture reviews impractical. This Skill routes those tasks to Gemini CLI, which offers a 1M token context window, and structures the delegation through subagents for iteration and verification. ## Core Features & Use Cases - Non-interactive Gemini queries: Run one-shot prompts with model selection (pro, flash, flash-lite aliases or full model IDs), output formats (text, JSON, stream-json), and directory scoping via --include-directories. - Subagent delegation pattern: Always dispatch Gemini work through the Task tool so the subagent can retry, request evidence from Gemini, and verify findings before summarizing. - Prompt pattern library: A references file provides ready-made templates for architecture reviews, security audits, performance analysis, migration assessments, and second-opinion critiques. - Use Case: You need a security audit of a 500k-token monorepo. Delegate to a subagent that runs Gemini with the security audit prompt template, collects evidence-backed findings, and returns a verified bullet-point summary. ## Quick Start Ask the agent to use the gemini-cli skill through a subagent to analyze your project directory for security vulnerabilities and summarize the verified findings.

Frequently Asked Questions about gemini-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze a large codebase that exceeds Claude's context window?▼

Delegate the analysis to a subagent that runs Gemini CLI in non-interactive mode, which supports a 1M token context window. Use --include-directories to scope the relevant paths and have the subagent verify findings before summarizing.

How to run Gemini CLI in non-interactive headless mode?▼

Pass the prompt as a positional argument, for example gemini "Explain this codebase architecture", or use a heredoc for multi-line prompts. Add -m to pick a model alias like pro or flash, and -o json for structured output.

When should I use Gemini instead of Claude for code analysis?▼

Use Gemini for massive codebase reviews over 100k tokens, multi-file architecture analysis, and cross-validating critical results. Use Claude for quick code questions, small file analysis, interactive coding, and tasks requiring file edits.

Why are Gemini tools not running in headless mode?▼

Non-interactive mode excludes shell, edit, write_file, and web_fetch tools by default. Override specific restrictions with the --allowed-tools flag, or use --approval-mode auto_edit to allow everything except shell.

Which Gemini model should I choose for deep reasoning tasks?▼

Use the pro alias, which resolves to gemini-3-pro-preview, for deep reasoning. For fast agentic coding use flash, and fall back to Gemini 2.5 GA models like gemini-2.5-pro when preview models are unavailable.