google-gemini/gemini-cli

google-gemini/gemini-cli is an open-source terminal agent maintained for enterprise coding workflows powered by Gemini models on Google Cloud. The command-line tool enables developers to inspect and refactor large codebases, troubleshoot issues using conversational instructions, generate new applications from multimodal inputs like sketches or documents, and automate repetitive operational workflows such as pull request analysis and rebasing. It also integrates with Model Context Protocol servers for expanded tool capabilities and supports non-interactive execution with structured JSON or newline-delimited stream-json output for shell scripting. The GitHub snapshot shows the repository is not archived and records an Apache-2.0 license.

The application specifically targets organizations and enterprise developers holding Gemini Code Assist Standard or Enterprise licenses, Code Assist for GitHub on Google Cloud, or legacy paid Vertex AI keys. Individual free-tier users and Google AI subscribers are directed by the documentation to Antigravity CLI, while developers seeking stateless script execution can utilize Gemini API CLI. The npm and npx options require a Node.js environment; other package-manager options have their own prerequisites. It can be run without permanent setup via `npx @google/gemini-cli`. Permanent global installation is supported using `npm install -g @google/gemini-cli`, Homebrew via `brew install gemini-cli`, MacPorts, or Anaconda environments. Authentication is configured by defining environment variables such as `GOOGLE_CLOUD_PROJECT` for Google account logins, `GEMINI_API_KEY`, or `GOOGLE_API_KEY` paired with Vertex AI activation.

Data as of : 108694 stars · 14915 forks.

GitHub · Gemini API CLI