Commands Reference

Complete reference for all Gemini CLI commands, flags, and options. Master every feature of this powerful AI terminal tool.

Basic Usage

# Basic syntax
gemini [options] "your prompt here"

# Examples
gemini "Hello, world!"
gemini --help
gemini --version

File Operations

Chat and Interaction

# 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"

File Operations

# 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"

Model Selection

# 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

Configuration Commands

Configuration Management

# 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

Authentication Commands

# 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

Advanced Options

Memory and Context

# 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

Model and Provider Options

# 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"

Utility Commands

Statistics and Monitoring

# 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

Tools and Extensions

# 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

Command Line Options

📚 Global Options

--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

Output Formats

# 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

Environment Variables

# 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"

Troubleshooting Commands

# 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

💡 Pro Tips

  • Use gemini --help [command] for detailed help on specific commands
  • Combine multiple flags: gemini --stream --verbose --file app.js "review code"
  • Use shell aliases for frequently used commands
  • Set up environment variables for consistent configuration
  • Explore gemini completion for shell auto-completion