G
google-gemini/gemini-cli
An open-source AI agent that brings the power of Gemini directly into your terminal.
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
Client config (built from the install command this repo gives)
{
"mcpServers": {
"google-gemini-gemini-cli": {
"command": "npx",
"args": ["@google/gemini-cli"]
}
}
}Parsed from the README we fetched on 2026-10-26; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"google-gemini-gemini-cli": {
"command": "npx",
"args": ["@google/gemini-cli"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio google-gemini-gemini-cli -- npx @google/gemini-cli
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Star count
- 108,818 ★ · google-gemini/gemini-cli · read from the GitHub search API · (checked 2026-11-13 20:00:50)
- Source
- read directly from its GitHub page · type: MCP server
- Harvest history
- first seen 2026-10-26 · last seen 2026-11-14 · seen 21× · listed by 1 sources
- Install
npx @google/gemini-cli
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx @google/gemini-cli. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We have no tags recorded for it yet.
Who maintains it?
repository
google-gemini/gemini-cli；first catalogued 2026-10-26；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.> [!NOTE]
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
> Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity
> CLI on June 18th, 2026. To learn more, see our
> blog post.
> Gemini CLI has not been optimized for Gemini 4 Argon. To use Gemini 4
> Argon, please use Antigravity.
# Gemini CLI
> [!NOTE]
> Gemini CLI is not optimized for the latest Gemini models. For the best coding
> experience with Gemini models use
> Antigravity 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.
Learn all about Gemini CLI in our documentation.
## 📦 Installation
See
Gemini CLI installation, execution, and releases
for recommended system specifications and a detailed installation guide.
### Quick Install
#### Run instantly with npx
bash
# Using npx (no installation required)
npx @google/gemini-cli
#### Install globally with npm
bash
npm install -g @google/gemini-cli
#### Install globally with Homebrew (macOS/Linux)
bash
brew install gemini-cli
#### Install globally with MacPorts (macOS)
bash
sudo port install gemini-cli
#### Install with Anaconda (for restricted environments)
bash
# Create and activate a new environment
conda create -y -n geminienv -c conda-forge nodejs
conda activate geminienv
# Install Gemini CLI globally via npm (inside the environment)
npm install -g @google/gemini-cli
## Release Channels
See Releases for more details.
### Preview
New preview releases will be published each week at UTC 23:59 on Tuesdays. These
releases will not have been fully vetted and may contain regressions or other
outstanding issues. Please help us test and install with preview tag.
bash
npm install -g @google/gemini-cli@preview
### Stable
New stable releases will be published each week at UTC 20:00 on Tuesdays, this
will be the full promotion of last week's preview release + any bug fixes
and validations. Use latest tag.
bash
npm install -g @google/gemini-cli@latest
### Nightly
New releases will be published each day at UTC 00:00. This will be all changes
from the main branch as represented at time of release. It should be assumed
there are pending validations and issues. Use nightly tag.
bash
npm install -g @google/gemini-cli@nightly
## 📋 Key Features
### Code Understanding & Generation
Query and edit large codebases
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
## 🔐 Authentication Options
Choose the authentication method that best fits your needs:
### Option 1: Sign in with Google (OAuth login using your Google Account)
#### When using a paid Code Assist License from your organization, remember to set the Google Cloud Project
bash
# Set your Google Cloud Project
export GOOGLECLOUDPROJECT="YOURPROJECTID"
gemini
### Option 2: Gemini API Key
✨ Best for: Developers who need specific model control or paid tier access
> CLI on June 18th, 2026. To learn more, see our
> blog post.
> Gemini CLI has not been optimized for Gemini 4 Argon. To use Gemini 4
> Argon, please use Antigravity.
# Gemini CLI
> [!NOTE]
> Gemini CLI is not optimized for the latest Gemini models. For the best coding
> experience with Gemini models use
> Antigravity 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.
Learn all about Gemini CLI in our documentation.
## 📦 Installation
See
Gemini CLI installation, execution, and releases
for recommended system specifications and a detailed installation guide.
### Quick Install
#### Run instantly with npx
bash
# Using npx (no installation required)
npx @google/gemini-cli
#### Install globally with npm
bash
npm install -g @google/gemini-cli
#### Install globally with Homebrew (macOS/Linux)
bash
brew install gemini-cli
#### Install globally with MacPorts (macOS)
bash
sudo port install gemini-cli
#### Install with Anaconda (for restricted environments)
bash
# Create and activate a new environment
conda create -y -n geminienv -c conda-forge nodejs
conda activate geminienv
# Install Gemini CLI globally via npm (inside the environment)
npm install -g @google/gemini-cli
## Release Channels
See Releases for more details.
### Preview
New preview releases will be published each week at UTC 23:59 on Tuesdays. These
releases will not have been fully vetted and may contain regressions or other
outstanding issues. Please help us test and install with preview tag.
bash
npm install -g @google/gemini-cli@preview
### Stable
New stable releases will be published each week at UTC 20:00 on Tuesdays, this
will be the full promotion of last week's preview release + any bug fixes
and validations. Use latest tag.
bash
npm install -g @google/gemini-cli@latest
### Nightly
New releases will be published each day at UTC 00:00. This will be all changes
from the main branch as represented at time of release. It should be assumed
there are pending validations and issues. Use nightly tag.
bash
npm install -g @google/gemini-cli@nightly
## 📋 Key Features
### Code Understanding & Generation
Query and edit large codebases
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
## 🔐 Authentication Options
Choose the authentication method that best fits your needs:
### Option 1: Sign in with Google (OAuth login using your Google Account)
#### When using a paid Code Assist License from your organization, remember to set the Google Cloud Project
bash
# Set your Google Cloud Project
export GOOGLECLOUDPROJECT="YOURPROJECTID"
gemini
### Option 2: Gemini API Key
✨ Best for: Developers who need specific model control or paid tier access
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/google-gemini-gemini-cli/)
- Source
- github · https://github.com/google-gemini/gemini-cli
- Traction
- 108,818 ★
- added
- today