Gemini CLI

# Install via npm
npm install -g @anthropic-ai/gemini-cli

# Or via Homebrew
brew install gemini-cli

export GOOGLE_API_KEY=your-api-key
# or
export GEMINI_API_KEY=your-api-key

# Manager delegation (default — manager reasons + calls gemini as subagent tool)
praisonai "Analyze this codebase" --external-agent gemini

# Direct proxy (escape hatch — no manager, passes prompt straight to gemini)
praisonai "Analyze this codebase" --external-agent gemini --external-agent-direct

# With verbose output
praisonai "Refactor this module" --external-agent gemini --verbose

# Simple question
praisonai "What files are in this directory?" --external-agent gemini

# Code analysis
praisonai "Analyze the code quality" --external-agent gemini

# Use specific model
gemini -m gemini-2.5-pro "Explain this code"

# Use flash model for faster responses
gemini -m gemini-2.5-flash "Quick summary of changes"

# Auto-approve all actions
gemini -y "Refactor and fix all linting errors"

# Or using approval-mode
gemini --approval-mode yolo "Update all dependencies"

# Get structured JSON output
gemini -o json "List all functions in main.py"

# Stream JSON for real-time updates
gemini -o stream-json "Analyze codebase"

# Include multiple directories
gemini --include-directories ../shared,../common "Find all API endpoints"

# Resume latest session
gemini -r latest

# Resume specific session
gemini -r 5

# List available sessions
gemini --list-sessions

from praisonai.integrations import GeminiCLIIntegration

# Create integration
gemini = GeminiCLIIntegration(
    workspace="/path/to/project",
    output_format="json",
    model="gemini-2.5-pro"
)

# Execute a task
result = await gemini.execute("Analyze this codebase")
print(result)

# Execute with stats
result, stats = await gemini.execute_with_stats("Explain the architecture")
print(f"Result: {result}")
print(f"Stats: {stats}")

# Stream output
async for event in gemini.stream("Add error handling"):
    print(event)

gemini -o text "Say hello"
# Output: Hello! How can I help you today?

gemini -o json "Say hello"

{
  "session_id": "abc123",
  "response": "Hello! How can I help you today?",
  "stats": {
    "models": {
      "gemini-2.5-pro": {
        "tokens": {
          "prompt": 100,
          "candidates": 10,
          "total": 110
        }
      }
    }
  }
}

gemini -o stream-json "Analyze code"