Gemini CLI is an open-source AI agent that integrates Gemini capabilities into the terminal, allowing for various operations including code generation and automation. It supports multiple installation methods and offers features like GitHub integration and customizable commands.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
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 users direct interaction with the model.
How it works
Gemini CLI allows users to perform tasks such as querying and editing codebases, generating applications from various inputs, and automating operational tasks. It integrates with GitHub for automated code reviews and issue triage, and supports custom integrations through MCP (Model Context Protocol).
Getting started
Installation
Users can install Gemini CLI using several methods:
Run instantly with npx
npx @google/gemini-cli
Install globally with npm
npm install -g @google/gemini-cli
Install globally with Homebrew (macOS/Linux)
brew install gemini-cli
Install globally with MacPorts (macOS)
sudo port install gemini-cli
Install with Anaconda (for restricted environments)
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
npm install -g @google/gemini-cli
Basic Usage
To start using Gemini CLI in the current directory:
gemini
To include multiple directories:
gemini --include-directories ../lib,../docs
To specify a model:
gemini -m gemini-2.5-flash
Recent releases
- v0.52.0-nightly.20260710.ga4c91ce19 (2026-07-10): Fixes and refactoring.
- v0.51.0-preview.0 (2026-07-08): Changelog update and test fixes.
- v0.50.0 (2026-07-08): Fixes related to npm and CI.
- v0.51.0-nightly.20260707.g15a9429b6 (2026-07-07): Fix for macOS sandbox.
- v0.51.0-nightly.20260706.gf7af4e518 (2026-07-06): Changes in nightly release.
Traction
- Stars: 105926
- Forks: 14246
- Open issues: 1375
Caveats
- License: Apache-2.0
- Open issues: 1375
- Age: Created on 2025-04-17






