Gemini CLI Commands: The Ultimate Menu

# Method 1: Get started immediately (without installation)
npx https://github.com/google-gemini/gemini-cli

# Method 2: Install globally (my recommendation)
npm install -g @google/gemini-cli

# Method 3: Homebrew (for Mac/Linux fans)
brew install gemini-cli

# Option 1: Google OAuth (free, recommended)
gemini  # Opens browser for login

# Option 2: API key (for automation)
export GEMINI_API_KEY="your-key-from-aistudio.google.com"
gemini

# Option 3: Vertex AI (for enterprises)
export GOOGLE_API_KEY="enterprise-key"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini

# Simple start in current directory
gemini

# With specific directories
gemini --include-directories ../lib,../docs

# With specific model (Flash is faster, Pro is smarter)
gemini -m gemini-2.5-flash

# With Gemini 3 Pro (if available)
gemini -m gemini-3-pro-preview

# With automatic tool approval (YOLO mode)
gemini --yolo

# Quick question without session
gemini -p "Explain the architecture of this codebase"

# Analyze file
gemini -p "Find bugs in this file @./src/main.js"

# With Unix pipes
echo "Write a unit test for function add(a,b)" | gemini

# Analyze git diff
git diff | gemini -p "Write a commit message for these changes"

# Analyze single file
"Explain this function to me @./src/utils.js"

# Include entire directory
"Refactor the API @./api/"

# Multiple files at once
"Find similarities between @./old.js and @./new.js"

# With wildcards (experimental)
"Check all tests @./tests/*.spec.js"

# Single command
!git status

# Switch to shell mode
!
# Now you're in a persistent shell
# Type 'exit' to leave

# Pipe output directly to Gemini
!npm test
"Explain these errors and suggest fixes"

# 1. Update Gemini CLI to version 0.16+
npm update -g @google/gemini-cli

# 2. Enable preview features
/settings
# → Set "Preview features" to true

# 3. Select model
/model
# → Select "Pro" - this will use Gemini 3 Pro

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token"
      },
      "trust": false,
      "includeTools": ["create_repository", "search_repositories"],
      "excludeTools": ["delete_repository"]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/db"
      },
      "trust": true
    }
  }
}

# Use GitHub integration
"Create a new repository for my React project"
# Gemini automatically uses the GitHub MCP server

# Database queries
"Show me all users who registered this week"
# Executes SQL and shows results

# Manage MCP servers
/mcp list              # Lists all servers and tools
/mcp desc              # Shows tool descriptions
/mcp schema            # JSON schema for developers
/mcp auth github       # Authenticates with MCP server
/mcp refresh           # Reloads connections

# Project-specific: .gemini/commands/test-all.toml
# Global: ~/.gemini/commands/test-all.toml

# Only "prompt" is required
prompt = """
Run the following tests sequentially and give me a summary:

1. npm test
2. npm run lint
3. npm run typecheck
4. npm run test:e2e

Show only errors and warnings, no successful tests.

Arguments: {{args}}
Git Status: !{git status}
Config file: @{package.json}
"""

# Optional fields:
# description = "Runs complete test suite"
# model = "gemini-2.5-flash"

# Compress context regularly
/compress

# Only load relevant directories
gemini --include-directories ./src --exclude node_modules,dist

# Flash model for simple tasks
gemini -m gemini-2.5-flash

# Disable history for large sessions
gemini --no-history

# Checkpoints for intermediate states
/chat save checkpoint-1
# Jump back on problems
/restore checkpoint-1

# Verbose mode for details
gemini -d

# System information
/stats

# MCP debug
gemini --mcp-debug

# Check tool schemas
/tools schema

# Complete reset
rm -rf ~/.gemini/cache
gemini