Home > Software > Development > AI > Gemini CLI

Gemini CLI logo

Details

Package ID
gemini-cli
Version
0.27.2
Downloads
3256
Website
https://github.com/google-gemini/gemini-cli

Summary

Gemini CLI is a command-line AI workflow tool that connects to your tools, understands your code, and accelerates your workflows. Gemini CLI brings the capabilities of Gemini models to your terminal in an interactive Read-Eval-Print Loop (REPL) environment.

Description

Gemini CLI

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

Quickstart

Install Gemini CLI using Chocolatey by running:

choco install gemini-cli

Common Configuration steps

  1. Pick a color theme

  2. 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!

Use a Gemini API key:

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)

Use a Vertex AI API key:

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.

Comments

Loading comments...