mcpField
G
gemini-cli

gemini-cli

github.com/x-zero-lAgent workflows2229 installsUpdated 37w ago
Repository

About gemini-cli

A skill for using Google’s `gemini` CLI as a local second opinion, for tasks such as large-context analysis, brainstorming, and structured edit suggestions. It runs the CLI directly and does not use MCP.

Key features

  1. 01Query Gemini from the CLI
  2. 02Analyze large files with `@path` references
  3. 03Brainstorm with named methodologies
  4. 04Generate structured OLD/NEW edit blocks
  5. 05Fetch chunked responses

Use cases

  1. 01Summarizing large files or directories
  2. 02Getting a second opinion on a problem
  3. 03Generating deterministic code edit suggestions

MCP support

This skill does not use MCP; it invokes the local `gemini` CLI directly.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/x-zero-l/agent-skills --skill gemini-cli

After installing, type/gemini-cliin Claude Code to confirm it loaded.

Bundled filesscripts/gemini-tool.mjs

Details

From the project README

Gemini CLI Skill

Use Google’s gemini CLI as an external “second brain” when you need a very large context window, a second opinion, or safe sandbox execution. This skill does not use MCP; it runs the local CLI directly.

When To Use

Use this skill when the user asks to:

  • “Ask Gemini” / “Use Gemini”
  • Analyze or summarize large files or directories (especially with @path references)
  • Brainstorm options with a specific framework (SCAMPER, design thinking, etc.)
  • Generate structured edit suggestions (“change mode”) that can be applied deterministically

Prerequisites

  • gemini CLI is installed and configured (e.g. gemini --version works)
  • You are allowed to run local shell commands in this environment
  • For sandbox execution, Gemini CLI supports -s/--sandbox (see gemini --help)

Core Commands

One-shot query (plain)
gemini "Explain what this code does: @src/main.ts"
Choose a model
gemini -m gemini-3-pro-preview "..."
gemini -m gemini-3-flash-preview "..."
Sandbox mode
gemini -s "Safely test @scripts/example.py and explain the results."

Helper Script (Recommended)

This skill ships with a dependency-free wrapper that mirrors the core behavior of gemini-mcp-tool without MCP:

skills/gemini-cli/scripts/gemini-tool.mjs

Important: Gemini CLI can only read files under its current “project directory” (typically the process working directory). Run the wrapper from the repo you want Gemini to read, or pass --cwd.

node skills/gemini-cli/scripts/gemini-tool.mjs help
Ask Gemini (wrapper)
node skills/gemini-cli/scripts/gemini-tool.mjs ask --prompt "Summarize @. in 5 bullets."
node skills/gemini-cli/scripts/gemini-tool.mjs ask --cwd /path/to/project --prompt "Summarize @. in 5 bullets."
node skills/gemini-cli/scripts/gemini-tool.mjs ask --prompt "..." --model gemini-3-pro-preview
node skills/gemini-cli/scripts/gemini-tool.mjs ask --prompt "..." --sandbox
Brainstorm (wrapper)
node skills/gemini-cli/scripts/gemini-tool.mjs brainstorm --prompt "How should we design onboarding?" --methodology scamper --ideaCount 12
Change Mode (structured edits + chunk caching)

Use change mode when you want Gemini to output deterministic OLD/NEW blocks that can be applied by exact string matching.

node skills/gemini-cli/scripts/gemini-tool.mjs ask --changeMode --prompt "In @src/foo.ts, rename Foo to Bar and update call sites."

If the response is chunked, the output includes a cacheKey. Fetch the next chunk:

node skills/gemini-cli/scripts/gemini-tool.mjs fetch-chunk --cacheKey <key> --chunkIndex 2

Safety Rules

  • Never execute destructive commands from Gemini output without explicit user approval.
  • In change mode, the OLD block must match the file content exactly; otherwise, do not apply the edit.
  • Prefer read-only analysis unless the user explicitly requests changes.

Comments

Markdown supported