Complete reference for all Gemini CLI commands, flags, and options. Master every feature of this powerful AI terminal tool.
# Basic syntax
gemini [options] "your prompt here"
# Examples
gemini "Hello, world!"
gemini --help
gemini --version
# Interactive chat mode
gemini chat
gemini --interactive
# Single query
gemini "your question here"
# Streaming responses
gemini --stream "explain quantum computing"
# Set response format
gemini --format markdown "create a README"
# Analyze single file
gemini --file path/to/file.js "review this code"
# Multiple files
gemini --file "src/*.ts" "check for type errors"
# Include file patterns
gemini --include "**/*.py" "find potential bugs"
# Exclude patterns
gemini --exclude "node_modules,*.log" "analyze project"
# Process images
gemini --image screenshot.png "describe this UI"
# Handle videos
gemini --video demo.mp4 "summarize this presentation"
# List available models
gemini models list
gemini models
# Use specific model
gemini --model gemini-2.5-pro "your prompt"
gemini -m gemini-1.5-flash "quick question"
# Set default model
gemini config set model gemini-2.5-pro
# Model capabilities
gemini models info gemini-2.5-pro
gemini models capabilities
# View current configuration
gemini config list
gemini config show
# Set configuration values
gemini config set key value
gemini config set model gemini-2.5-pro
gemini config set max-tokens 100000
# Reset configuration
gemini config reset
gemini config reset key
# Export/import configuration
gemini config export > config.json
gemini config import config.json
# Login with Google account
gemini auth login
gemini auth signin
# Check authentication status
gemini auth status
gemini auth whoami
# Logout
gemini auth logout
gemini auth signout
# Refresh tokens
gemini auth refresh
# Set API key directly
gemini auth set-key YOUR_API_KEY
# View conversation memory
gemini memory show
gemini memory list
# Clear memory
gemini memory clear
gemini memory reset
# Save context
gemini memory save "context name"
# Load context
gemini memory load "context name"
# Set custom instructions
gemini memory set-instructions "You are a senior developer..."
# Show current context size
gemini memory usage
# List available models
gemini models list
gemini models available
# Select specific model
gemini --model gemini-2.5-pro "your query"
gemini --model gemini-1.5-flash "quick question"
# Model parameters
gemini --temperature 0.7 "creative writing task"
gemini --top-p 0.9 "generate code"
gemini --max-tokens 1000 "brief summary"
# Safety settings
gemini --safety-level strict "review content"
gemini --safety-level relaxed "casual conversation"
# Usage statistics
gemini stats show
gemini stats today
gemini stats --period 7d
# Token usage
gemini stats tokens
gemini stats usage
# Rate limits
gemini stats limits
gemini stats quota
# Performance metrics
gemini stats performance
gemini stats latency
# List available tools
gemini tools list
gemini tools available
# Enable/disable tools
gemini tools enable web-search
gemini tools disable calculator
# Custom tools
gemini tools install custom-tool
gemini tools uninstall custom-tool
# Tool configuration
gemini tools config web-search --api-key KEY
gemini tools reset calculator
--help, -h
Show help information
--version, -v
Display version number
--verbose
Enable verbose output
--quiet, -q
Suppress non-essential output
--config
Use custom config file
--no-color
Disable colored output
# Markdown output (default)
gemini --format markdown "create documentation"
# Plain text
gemini --format text "simple response"
# JSON output
gemini --format json "structured data"
# HTML output
gemini --format html "formatted content"
# Code-only output
gemini --format code "generate function"
# Save to file
gemini "create README" --output README.md
gemini "generate docs" --output docs/ --format html
# Authentication
export GEMINI_API_KEY="your-api-key"
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"
# Configuration
export GEMINI_MODEL="gemini-2.5-pro"
export GEMINI_MAX_TOKENS="100000"
export GEMINI_TEMPERATURE="0.7"
# Output settings
export GEMINI_OUTPUT_FORMAT="markdown"
export GEMINI_NO_COLOR="true"
export GEMINI_QUIET="true"
# Development
export GEMINI_DEBUG="true"
export GEMINI_LOG_LEVEL="debug"
# Diagnose issues
gemini doctor
gemini health check
# Debug mode
gemini --debug "test query"
export GEMINI_DEBUG=true && gemini "test"
# Network diagnostics
gemini test connection
gemini ping
# Clear cache
gemini cache clear
gemini cache rebuild
# Reset everything
gemini reset --all
gemini reset --config --auth --cache
gemini --help [command]
for detailed help on specific commandsgemini --stream --verbose --file app.js "review code"
gemini completion
for shell auto-completion