google-gemini/gemini-cli 封面
AI Skills
aiai-agentscli

google-gemini/gemini-cli

An open-source AI agent that brings the power of Gemini directly into your terminal.

10.9万语言：TypeScript来源：GitHub收录于 2026年10月27日
访问项目主页 → ← 返回首页

站内导读

中文 Gemini CLI 是开源终端 AI Agent，把 Gemini 模型接入命令行。它可查询和编辑大型代码库，用 PDF、图片或草图生成应用，并以自然语言调试。支持 MCP 服务器扩展能力，也能在脚本中非交互运行。提供 Google 登录、API Key、Vertex AI 三种认证。注意：2026 年 6 月 18 日起免费层与 Google One 用户已迁移至 Antigravity CLI，且未针对 Gemini 4 Argon 优化。

README · 详细文档

来源 · 查看原文

[!NOTE] 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

0 1 2 3 4

[!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
# Using npx (no installation required)
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)
# Create and activate a new environment
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env

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

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.

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.

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
# Set your Google Cloud Project
export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
gemini

Option 2: Gemini API Key

✨ Best for: Developers who need specific model control or paid tier access

Benefits:

  • Model selection: Choose specific Gemini models
  • Usage-based billing: Upgrade for higher limits when needed
# Get your key from https://aistudio.google.com/apikey
export GEMINI_API_KEY="YOUR_API_KEY"
gemini

Option 3: Vertex AI

✨ Best for: Enterprise teams and production workloads

Benefits:

  • Enterprise features: Advanced security and compliance
  • Scalable: Higher rate limits with billing account
  • Integration: Works with existing Google Cloud infrastructure
# Get your key from Google Cloud Console
export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini

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

🚀 Getting Started

[!NOTE] Gemini CLI is not optimized for the latest Gemini models. For the best coding experience with Gemini models use Antigravity CLI

Basic Usage

Start in current directory
gemini
Include multiple directories
gemini --include-directories ../lib,../docs
Use specific model
gemini -m gemini-2.5-flash
Non-interactive mode for scripts

Get a simple text response:

gemini -p "Explain the architecture of this codebase"

For more advanced scripting, including how to parse JSON and handle errors, use the --output-format json flag to get structured output:

gemini -p "Explain the architecture of this codebase" --output-format json

For real-time event streaming (useful for monitoring long-running operations), use --output-format stream-json to get newline-delimited JSON events:

gemini -p "Run tests and deploy" --output-format stream-json

Quick Examples

Start a new project
cd new-project/
gemini
> Write me a Discord bot that answers questions using a FAQ.md file I will provide
Analyze existing code
git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all of the changes that went in yesterday

📚 Documentation

Getting Started

and running quickly.

Detailed auth configuration.

Settings and customization.

Productivity tips.

Core Features

All slash commands (/help, /chat, etc).

Create your own reusable commands.

Provide persistent context to Gemini CLI.

and resume conversations.

Optimize token usage.

Tools & Extensions

- File System Operations - Shell Commands - Web Fetch & Search

Extend with custom tools.

Build and share your own commands.

Advanced Topics

Use Gemini CLI in automated workflows.

Code companion.

execution environments.

Control execution policies by folder.

and manage in a corporate environment.

Usage tracking.

Built-in tools overview.

Local development tooling.

Troubleshooting & Support

Common issues and solutions.

questions.

  • Use /bug command to report issues directly from the CLI.

Using MCP Servers

Configure MCP servers in ~/.gemini/settings.json to extend Gemini CLI with custom tools:

> @github List my open pull requests
> @slack Send a summary of today's commits to #dev channel
> @database Run a query to find inactive users

See the MCP Server Integration guide for setup instructions.

🤝 Contributing

We welcome contributions! Gemini CLI is fully open source (Apache 2.0), and we encourage the community to:

  • Report bugs and suggest features.
  • Improve documentation.
  • Submit code improvements.
  • Share your MCP servers and extensions.

See our Contributing Guide for development setup, coding standards, and how to submit pull requests.

Check our Official Roadmap for planned features and priorities.

📖 Resources

Learn the basics.

  • Official Roadmap - See what's coming next.
  • Changelog - See recent

notable updates.

registry.

Report bugs or request features.

Security updates.

Uninstall

See the Uninstall Guide for removal instructions.

📄 Legal

  • License: Apache License 2.0
  • Terms of Service:

Terms & Privacy

  • Security: Security Policy

<p align="left"> <a href="https://www.star-history.com/google-gemini/gemini-cli"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/badge?repo=google-gemini/gemini-cli&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/badge?repo=google-gemini/gemini-cli" /> <img alt="Star History Rank" src="https://api.star-history.com/badge?repo=google-gemini/gemini-cli" /> </picture> </a> </p>

<p align="center"> Built with ❤️ by Google and the open source community </p>

同类项目 · AI Skills

← 返回列表 访问项目主页 →