Skip to main content
Gemini CLI Hero Light

​
Welcome to Gemini CLI

Gemini CLI is an open-source AI agent that brings the power of Gemini directly into your terminal. It provides lightweight access to Gemini, giving you the most direct path from your prompt to our model.

Quick Start

Get up and running with Gemini CLI in minutes

Installation

Install Gemini CLI using npm, Homebrew, or other methods

Authentication

Set up OAuth, API key, or Vertex AI authentication

Commands Reference

Explore all available commands and features

​
Why Gemini CLI?

Gemini CLI is designed for developers who live in the command line and want powerful AI capabilities at their fingertips.

Free Tier

60 requests/min and 1,000 requests/day with personal Google account

Powerful Models

Access to Gemini 3 models with improved reasoning and 1M token context window

Built-in Tools

Google Search grounding, file operations, shell commands, and web fetching

Extensible

MCP (Model Context Protocol) support for custom integrations

Terminal-First

Designed for developers who live in the command line

Open Source

Apache 2.0 licensed and community-driven

​
Key Features

​
Code Understanding & Generation

  • Query and edit large codebases with intelligent context awareness
  • Generate new apps from PDFs, images, or sketches using multimodal capabilities
  • Debug issues and troubleshoot with natural language

​
Automation & Integration

  • Automate operational tasks like querying pull requests or handling complex rebases
  • Use MCP servers to connect new capabilities, including media generation with Imagen, Veo or Lyria
  • Run non-interactively in scripts for workflow automation

​
Advanced Capabilities

  • Ground your queries with built-in Google Search for real-time information
  • Conversation checkpointing to save and resume complex sessions
  • Custom context files (GEMINI.md) to tailor behavior for your projects

​
Quick Example

Get started with Gemini CLI in seconds: 
# Install globally
npm install -g @google/gemini-cli

# Start Gemini CLI
gemini

# Or run instantly without installation
npx @google/gemini-cli
New to Gemini CLI? Check out our Quick Start Guide to get up and running in minutes.

​
Authentication Options

Choose the authentication method that best fits your needs:

Login with Google

Best for: Individual developersFree tier with 60 requests/min and 1,000 requests/day. No API key management required.

Gemini API Key

Best for: Specific model control1000 requests/day with Gemini 3. Choose specific models and upgrade for higher limits.

Vertex AI

Best for: Enterprise teamsAdvanced security, compliance, and scalable rate limits with billing account.
Learn more about authentication options in our Authentication Guide.

​
What You Can Build

# Analyze a repository
cd my-project
gemini
> Give me a summary of all of the changes that went in yesterday

​
Community & Support

Gemini CLI is fully open source (Apache 2.0), and we encourage the community to:
  • Report bugs and suggest features on GitHub Issues
  • Improve documentation and submit code improvements
  • Share your MCP servers and extensions
  • Join discussions and get help from the community
Use the /bug command directly from the CLI to report issues.

​
Next Steps

Install Gemini CLI

Choose from npm, Homebrew, MacPorts, or Anaconda installation methods

Set Up Authentication

Configure OAuth, API key, or Vertex AI authentication

Quick Start Guide

Get to your first working command in minutes

View Examples

See real-world examples of what you can build

Build docs developers (and LLMs) love

Get started for freeTalk to us