gemini-cli
google-gemini/gemini-cli · Updated
An open-source AI agent that brings the power of Gemini directly into your terminal.
google-gemini/gemini-cli is a TypeScript repository in the AI Agents category with 108,591 stars and 14,859 forks on GitHub, released under the Apache-2.0 license, last updated today.
How to install gemini-cli in your AI client
Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.
How to install gemini-cli in Claude CodeAnthropic's agentic CLI
Clone & open
bashgit clone https://github.com/google-gemini/gemini-cli.git cd gemini-cli claudeLet Claude read it
Ask “/init” to generate a CLAUDE.md, then have Claude explain, run, or extend the codebase. It reads files on demand.
How to install gemini-cli in Claude DesktopDesktop app (MCP config)
Clone the repository
bashgit clone https://github.com/google-gemini/gemini-cli.gitOpen in your AI editor
Open the folder in your assistant and ask it to index the codebase, then reference files in chat.
How to install gemini-cli in CursorAI-first code editor
Clone & open in Cursor
bashgit clone https://github.com/google-gemini/gemini-cli.gitIndex & chat
Open the folder — Cursor indexes it automatically. Use @Codebase in chat to ask about it or scaffold from it.
How to install gemini-cli in Codex CLIOpenAI coding agent
Clone
bashgit clone https://github.com/google-gemini/gemini-cli.gitPoint Codex at it
Run codex in the repo root; add setup notes to AGENTS.md so the agent knows how to build & test.
How to install gemini-cli in WindsurfCodeium's agentic IDE
Clone & open
bashgit clone https://github.com/google-gemini/gemini-cli.gitUse Cascade
Windsurf indexes the workspace; ask Cascade to explain or reuse modules from the repo.
How to install gemini-cli in ClineVS Code autonomous agent
Clone the repository
bashgit clone https://github.com/google-gemini/gemini-cli.gitOpen in your AI editor
Open the folder in your assistant and ask it to index the codebase, then reference files in chat.
How to install gemini-cli in VS CodeCopilot / MCP support
Clone the repository
bashgit clone https://github.com/google-gemini/gemini-cli.gitOpen in your AI editor
Open the folder in your assistant and ask it to index the codebase, then reference files in chat.
Documentation
Full READMEGemini CLI
[!IMPORTANT] Read before installing — Gemini CLI status & tool guide - Enterprise Code Assist only: Designed for Gemini Code Assist Standard / Enterprise licenses and Code Assist for GitHub on Google Cloud (your access remains unchanged). - No free tier or Google AI plans: Free individual access and Google AI Pro / Ultra (Google One) moved to Antigravity CLI on June 18, 2026 (transition post). - Not optimized for Gemini 4+: Not tuned for the Gemini 4 series (for example, Gemini 4 Argon) or future releases in this or later generations. - Not for model benchmarks: Don't use Gemini CLI to benchmark Gemini models—its harness isn't tuned for Gemini 4+ and produces unrepresentative scores. Which Google CLI do you need? | Tool | Best for | Links | | :--- | :--- | :--- | | [Antigravity CLI](https://antigravity.google/product/antigravity-cli) (agy) | Interactive multi-agent coding terminal. Use for Gemini 4 Argon+, free / Google AI Pro & Ultra accounts, or Google Cloud. | Download · Migrate · Argon post | | [Gemini API CLI](https://github.com/google-gemini/gemini-api-cli) (gemini-api) | Stateless API CLI *(not a coding harness)*. Gives agents (agy, Claude Code, Codex), scripts, and CI direct commands for Gemini models, media gen, file analysis, and managed agents. | GitHub · Releases · API docs | | Gemini CLI (gemini, *this repo*) | Organizations with Gemini Code Assist Standard / Enterprise or Code Assist for GitHub on Google Cloud *(plus legacy paid API / Vertex keys)*. | Docs |
Gemini CLI (gemini) is an open-source terminal agent maintained for enterprise Gemini Code Assist workflows on Google Cloud. Learn more in the Gemini CLI 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-cliInstall globally with npm
npm install -g @google/gemini-cliInstall globally with Homebrew (macOS/Linux)
brew install gemini-cliInstall globally with MacPorts (macOS)
sudo port install gemini-cliExcerpt — the full document is on GitHub.
More AI Agents repositories
- AI Agents264k
deepseek-harness
DeepSeek Harness: Everything is a Plugin.
TypeScriptMITdeepseek-ai/deepseek-harness
- AI Agents258k
hermes-agent
The agent that grows with you
PythonMITNousResearch/hermes-agent
- AI Agents196k
firecrawl
Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥
TypeScriptAGPL-3.0firecrawl/firecrawl
- AI Agents179k
ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
JavaScriptMITDietrichGebert/ponytail
- AI Agents149k
langchain
The agent engineering platform.
PythonMITlangchain-ai/langchain
- AI Agents109k
orca
Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScriptMITstablyai/orca
Catalog data refreshed . Something wrong? Report it.