gemini-cli
An open-source AI agent that brings the power of Gemini directly into your terminal.
GraphCanon updated 1mo · GitHub synced 1mo · 30 views this month
Decision brief
Gemini CLI is an open-source AI agent software that facilitates interaction with Gemini's AI capabilities via a command-line interface in terminal environments. It supports multiple installation methods including npx,npm
Good fit when
- Use gemini-cli when you need to access and interact with Gemini's AI features through a terminal for automation or scripting purposes.
- Choose it if you prioritize flexibility and want the power of Gemini directly integrated into your existing workflows via command-line interface.
Avoid when
- Avoid using gemini-cli if you are looking for a graphical user interface (GUI) to interact with Gemini's AI services, as this tool is exclusively designed for terminal use.
- Do not select gemini-cli if your primary workflow does not benefit from the use of command-line interfaces and you prefer GUI-based tools.
Observed Jul 11, 2026 · Source: enrich:decision_facts
Verify the decision
Adoption
Package downloads where a registry match exists. GitHub stars (106,078) are secondary evidence.
- npm downloads (30d)
- 1,884,191·npm downloads API·1mo
Maintenance and security
Full trust report- Maintenance
- Very active (0d since push)
- As of 1mo
- Provenance
- Not a fork · Organization account
- As of 1mo
- Security (OSV)
- No MCP manifest
- As of 1mo
Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.
Install
npm install gemini-cliHow it fits your stack(40)
Typed graph edges - alternatives, integrations, successors, and dependencies. Ranked by relationship type, not raw GitHub stars.
Alternative
Integrates
Depends on
Related
Relationship graph
Optional deeper exploration of typed edges and category neighbours.
Similar tools
Same-category neighbours not already linked as typed edges.
Evidence and technical details
Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.
Overview
Gemini CLI is an AI agent tool allowing users to interact with Gemini's AI functionalities from their terminals, providing direct access and utility for invoking Gemini services through a command-line interface.
Capability facts
- Deploy
- Self-host
Source: dockerfile:Dockerfile · Jul 20, 2026
- Docker
- Dockerfile present
Source: dockerfile:Dockerfile · Jul 20, 2026
- CLI
- CLI entrypoint
Source: package.json:bin|scripts · Jul 20, 2026
- MCP server
- Ships MCP server
Source: package.json:@modelcontextprotocol/* · Jul 20, 2026
- Languages
- typescript, javascript
Source: github.language+package.json · Jul 20, 2026
Categories
Compatibility
Sourced claims from the README excerpt - not unsourced marketing copy.
Source: README excerpt (regex_v1, Jul 20, 2026)
npm install -g @google/gemini-cliSource link
Tags
README
📦 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)
---
# Install Gemini CLI globally via npm (inside the environment)
npm install -g @google/gemini-cli
Getting Started
- Quickstart Guide - Get up and running quickly.
- Authentication Setup - Detailed auth configuration.
- Configuration Guide - Settings and customization.
- Keyboard Shortcuts - Productivity tips.
For agents
This page has a .md twin and JSON over the API.