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.
How to install gemini-cli?
google-gemini/gemini-cli
$git clone https://github.com/google-gemini/gemini-cliInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install gemini-cli by running `git clone https://github.com/google-gemini/gemini-cli`, then use it for the current task and follow its documentation at https://github.com/google-gemini/gemini-cli.
README.md
| 1 | # Gemini CLI |
| 2 | |
| 3 | [](https://github.com/google-gemini/gemini-cli/actions/workflows/ci.yml) |
| 4 | [](https://github.com/google-gemini/gemini-cli/actions/workflows/chained_e2e.yml) |
| 5 | [](https://www.npmjs.com/package/@google/gemini-cli) |
| 6 | [](https://github.com/google-gemini/gemini-cli/blob/main/LICENSE) |
| 7 | [](https://codewiki.google/github.com/google-gemini/gemini-cli?utm_source=badge&utm_medium=github&utm_campaign=github.com/google-gemini/gemini-cli) |
| 8 | |
| 9 |  |
| 10 | |
| 11 | Gemini CLI is an open-source AI agent that brings the power of Gemini directly |
| 12 | into your terminal. It provides lightweight access to Gemini, giving you the |
| 13 | most direct path from your prompt to our model. |
| 14 | |
| 15 | Learn all about Gemini CLI in our [documentation](https://geminicli.com/docs/). |
| 16 | |
| 17 | ## 🚀 Why Gemini CLI? |
| 18 | |
| 19 | - **🎯 Free tier**: 60 requests/min and 1,000 requests/day with personal Google |
| 20 | account. |
| 21 | - **🧠 Powerful Gemini 3 models**: Access to improved reasoning and 1M token |
| 22 | context window. |
| 23 | - **🔧 Built-in tools**: Google Search grounding, file operations, shell |
| 24 | commands, web fetching. |
| 25 | - **🔌 Extensible**: MCP (Model Context Protocol) support for custom |
| 26 | integrations. |
| 27 | - **💻 Terminal-first**: Designed for developers who live in the command line. |
| 28 | - **🛡️ Open source**: Apache 2.0 licensed. |
| 29 | |
| 30 | ## 📦 Installation |
| 31 | |
| 32 | See |
| 33 | [Gemini CLI installation, execution, and releases](https://www.geminicli.com/docs/get-started/installation) |
| 34 | for recommended system specifications and a detailed installation guide. |
| 35 | |
| 36 | ### Quick Install |
| 37 | |
| 38 | #### Run instantly with npx |
| 39 | |
| 40 | ```bash |
| 41 | # Using npx (no installation required) |
| 42 | npx @google/gemini-cli |
| 43 | ``` |
| 44 | |
| 45 | #### Install globally with npm |
| 46 | |
| 47 | ```bash |
| 48 | npm install -g @google/gemini-cli |
| 49 | ``` |
| 50 | |
| 51 | #### Install globally with Homebrew (macOS/Linux) |
| 52 | |
| 53 | ```bash |
| 54 | brew install gemini-cli |
| 55 | ``` |
| 56 | |
| 57 | #### Install globally with MacPorts (macOS) |
| 58 | |
| 59 | ```bash |
| 60 | sudo port install gemini-cli |
| 61 | ``` |
| 62 | |
| 63 | #### Install with Anaconda (for restricted environments) |
| 64 | |
| 65 | ```bash |
| 66 | # Create and activate a new environment |
| 67 | conda create -y -n gemini_env -c conda-forge nodejs |
| 68 | conda activate gemini_env |
| 69 | |
| 70 | # Install Gemini CLI globally via npm (inside the environment) |
| 71 | npm install -g @google/gemini-cli |
| 72 | ``` |
| 73 | |
| 74 | ## Release Channels |
| 75 | |
| 76 | See [Releases](https://www.geminicli.com/docs/changelogs) for more details. |
| 77 | |
| 78 | ### Preview |
| 79 | |
| 80 | New preview releases will be published each week at UTC 23:59 on Tuesdays. These |
| 81 | releases will not have been fully vetted and may contain regressions or other |
| 82 | outstanding issues. Please help us test and install with `preview` tag. |
| 83 | |
| 84 | ```bash |
| 85 | npm install -g @google/gemini-cli@preview |
| 86 | ``` |
| 87 | |
| 88 | ### Stable |
| 89 | |
| 90 | - New stable releases will be published each week at UTC 20:00 on Tuesdays, this |
| 91 | will be the full promotion of last week's `preview` release + any bug fixes |
| 92 | and validations. Use `latest` tag. |
| 93 | |
| 94 | ```bash |
| 95 | npm install -g @google/gemini-cli@latest |
| 96 | ``` |
| 97 | |
| 98 | ### Nightly |
| 99 | |
| 100 | - New releases will be published each day at UTC 00:00. This will be all changes |
| 101 | from the main branch as represented at time of release. It should be assumed |
| 102 | there are pending validations and issues. Use `nightly` tag. |
| 103 | |
| 104 | ```bash |
| 105 | npm install -g @google/gemini-cli@nightly |
| 106 | ``` |
| 107 | |
| 108 | ## 📋 Key Features |
| 109 | |
| 110 | ### Code Understanding & Generation |
| 111 | |
| 112 | - Query and edit large codebases |
| 113 | - Generate new apps from PDFs, images, or sketches using multimodal capabilities |
| 114 | - Debug issues and troubleshoot with natural language |
| 115 | |
| 116 | ### Automation & Integration |
| 117 | |
| 118 | - Automate operational tasks like querying pull requests or handling complex |
| 119 | rebases |
| 120 | - Use MCP servers to connect new capabilities, including |
| 121 | [media generation with Imagen, Veo or Lyria](https://gi |
Related
6 picksType
- langchain-mcp-adaptersMake Anthropic Model Context Protocol (MCP) tools compatible with LangChain and LangGraph agents.Jul 2026
- mcporterTypeScript runtime and CLI for connecting to configured Model Context Protocol servers.Jul 2026
- mcp-proxyA MCP server which proxies requests to a remote MCP server over streamable HTTP or SSE.Jul 2026
- mcp-atlassianThe Model Context Protocol (MCP) Atlassian integration is an open-source implementation that bridges Atlassian products (Jira and Confluence) with AI language models following Anthropic's MCP specification.Jul 2026
- open-webuiOpen WebUIJul 2026
- rulesyncUnified AI rules management CLI tool that generates configuration files for various AI development toolsJul 2026
