Repolode
Submit
google-gemini

google-gemini/gemini-cli

An open-source AI agent from Google that brings Gemini into your terminal to query, edit, and automate code.

Open-source alternative to:Claude CodeGitHub Copilot CLI

View on GitHubWebsite
Stars
107,463
Forks
14,746
Open issues
751
Last commit
11 hours ago

What is it?

Gemini CLI is a terminal-based AI agent built on Gemini models. You run it in a project directory and send natural-language prompts to query a codebase, generate or edit files, debug problems, and automate operational tasks such as reviewing pull requests or handling rebases.

It supports several authentication paths: signing in with a Google account, using a Gemini API key, or connecting through Vertex AI for enterprise deployments. Built-in tools cover file system operations, shell commands, and web fetch and search. Additional capabilities can be added through MCP servers, which connect services such as GitHub, Slack, or databases, and through custom commands and extensions.

For scripting, a non-interactive mode accepts a prompt with -p and can return plain text, JSON, or newline-delimited JSON event streams. The project is distributed through npm and Homebrew, with preview, stable, and nightly release channels.

Key features

  • 01Query and edit large codebases using natural language
  • 02Generate apps from PDFs, images, or sketches with multimodal input
  • 03Extend capabilities through MCP servers and custom commands
  • 04Run non-interactively in scripts with text, JSON, or streaming output
  • 05Authenticate with a Google account, Gemini API key, or Vertex AI

Use cases

  • Exploring and summarizing an unfamiliar codebase from the terminal
  • Debugging issues by describing symptoms in plain language
  • Automating routine repository tasks such as reviewing pull requests
  • Running scripted workflows that call Gemini and parse JSON output

Quick start

  1. 1

    Run instantly with npx (no install needed)

    npx @google/gemini-cli
  2. 2

    Or install globally with npm

    npm install -g @google/gemini-cli
  3. 3

    Start the CLI in your project directory and sign in with Google or set an API key

    gemini

Things to know

  • The README says Gemini CLI was replaced by Antigravity CLI on June 18th, 2026 for unpaid tier and Google One users.
  • It is not optimized for the latest Gemini models, such as Gemini 4 Argon.

Topics

#ai-agent#cli#gemini#terminal#mcp#coding-assistant#llm#ai#ai-agents#gemini-api

FAQ

What is gemini-cli?
An open-source AI agent from Google that brings Gemini into your terminal to query, edit, and automate code. Gemini CLI is a terminal-based AI agent built on Gemini models. You run it in a project directory and send natural-language prompts to query a codebase, generate or edit files, debug problems, and automate operational tasks such as reviewing pull requests or handling rebases.
Is gemini-cli free to use? What license does it have?
gemini-cli is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is gemini-cli still maintained?
Actively maintained. The last commit to gemini-cli was on Oct 20, 2026.
What can I use gemini-cli for?
Exploring and summarizing an unfamiliar codebase from the terminal Debugging issues by describing symptoms in plain language Automating routine repository tasks such as reviewing pull requests Running scripted workflows that call Gemini and parse JSON output
How do I install gemini-cli?
Run instantly with npx (no install needed): npx @google/gemini-cli Or install globally with npm: npm install -g @google/gemini-cli Start the CLI in your project directory and sign in with Google or set an API key: gemini
Where can I get gemini-cli?
The source code and installation instructions are on GitHub: https://github.com/google-gemini/gemini-cli

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects