This repository contains the Gemini CLI, a command-line AI workflow tool that connects to your tools, understands your code and accelerates your workflows.

With the Gemini CLI you can:

• Query and edit large codebases in and beyond Gemini's 1M token context window.
• Generate new apps from PDFs or sketches, using Gemini's multimodal capabilities.
• Automate operational tasks, like querying pull requests or handling complex rebases.
• Integrate with GitHub: Use the Gemini CLI GitHub Action for automated PR reviews, issue triage, and on-demand AI assistance directly in your repositories.
• Use tools and MCP servers to connect new capabilities, including media generation with Imagen, Veo or Lyria
• Ground your queries with the Google Search tool, built into Gemini.

You have two options to install Gemini CLI.

1. Prerequisites: Ensure you have Node.js version 20 or higher installed.

2. Run the CLI: Execute the following command in your terminal:

   npx https://github.com/google-gemini/gemini-cli

   Or install it with:

   npm install -g @google/gemini-cli

   Then, run the CLI from anywhere:

   gemini

1. Prerequisites: Ensure you have Homebrew installed.

2. Install the CLI: Execute the following command in your terminal:

   brew install gemini-cli

   Then, run the CLI from anywhere:

   gemini

3. Pick a color theme
4. Authenticate: When prompted, sign in with your personal Google account. This will grant you up to 60 model requests per minute and 1,000 model requests per day using Gemini.

You are now ready to use the Gemini CLI!

The Gemini API provides a free tier with 100 requests per day using Gemini 2.5 Pro, control over which model you use, and access to higher rate limits (with a paid plan):

1. Generate a key from Google AI Studio.

2. Set it as an environment variable in your terminal. Replace YOUR_API_KEY with your generated key.

   export GEMINI_API_KEY="YOUR_API_KEY"

3. (Optionally) Upgrade your Gemini API project to a paid plan on the API key page (will automatically unlock Tier 1 rate limits)

The Vertex AI API provides a free tier using express mode for Gemini 2.5 Pro, control over which model you use, and access to higher rate limits with a billing account:

1. Generate a key from Google Cloud.

2. Set it as an environment variable in your terminal. Replace YOUR_API_KEY with your generated key and set GOOGLE_GENAI_USE_VERTEXAI to true

   export GOOGLE_API_KEY="YOUR_API_KEY"
   export GOOGLE_GENAI_USE_VERTEXAI=true

3. (Optionally) Add a billing account on your project to get access to higher usage limits

For other authentication methods, including Google Workspace accounts, see the authentication guide.

Once the CLI is running, you can start interacting with Gemini from your shell.

You can start a project from a new directory:

Or work with an existing project:

• Learn how to contribute to or build from the source.
• Explore the available CLI Commands.
• If you encounter any issues, review the troubleshooting guide.
• For more comprehensive documentation, see the full documentation.
• Take a look at some popular tasks for more inspiration.
• Check out our Official Roadmap

Head over to the troubleshooting guide if you're having issues.

Integrate Gemini CLI directly into your GitHub workflows with the Gemini CLI GitHub Action. Key features include:

• Pull Request Reviews: Automatically review pull requests when they're opened.
• Issue Triage: Automatically triage and label GitHub issues.
• On-demand Collaboration: Mention @gemini-cli in issues and pull requests for assistance and task delegation.
• Custom Workflows: Set up your own scheduled tasks and event-driven automations.

Start by cding into an existing or newly-cloned repository and running gemini.