gemini-cli
by google-gemini · TypeScript · Apache-2.0
An open-source AI agent that brings the power of Gemini directly into your terminal.
Overview
An open-source AI agent that brings the power of Gemini directly into your terminal.
gemini-cli is one of the most-starred projects in the AI agent ecosystem, maintained by google-gemini with 105,612 GitHub stars. It targets the MCP layer of the agent stack — where reusable skills, MCP servers, and tool integrations accelerate production workflows.
Tagged with ai, ai-agents, cli, gemini, gemini-api, mcp-client, and more, this skill fits naturally into modern agent architectures that combine LLMs, tools, and memory.
Key Features
- Typed tool schemas compatible with Model Context Protocol clients
- stdio and HTTP transport options for local and remote deployment
- Resource and prompt templates for context-rich agent sessions
- Composable with Claude Desktop, Cursor, Windsurf, and custom hosts
- Security boundaries for filesystem, network, and API access
- Active ecosystem with hundreds of community MCP servers
Use Cases
- Give coding assistants access to internal databases and docs
- Expose custom business APIs as typed agent tools
- Standardize tool interfaces across Claude, Cursor, and internal agents
- Prototype agent integrations without rebuilding auth each time
Integration
Primary integration surface: Model Context Protocol (Claude Desktop, Cursor, Windsurf).
Implementation language: TypeScript — check the repo for package install instructions.
Official homepage: https://geminicli.com
Most skills support environment variables for API keys and configurable endpoints.
For MCP servers, add the server config to your client JSON and restart the host application.
Who It's For
Developers building mcp-heavy agent features who want open-source building blocks.
Teams standardizing on MCP or shared tool libraries across multiple agent products.
Indie hackers and startups optimizing time-to-ship for agent MVPs.
Enterprises seeking community-vetted integrations with large install bases.
Getting Started
- Clone or install from https://github.com/google-gemini/gemini-cli.
- Read the README for prerequisites (Node, Python, Docker, API keys).
- Add the server entry to your MCP client configuration file.
- Run the provided example or quickstart script to verify connectivity.
- Iterate on prompts and tool schemas using the project's test utilities.
- Pin versions in production and monitor upstream releases for breaking changes.
Community & Trust Signals
105,612 GitHub stars indicate broad community interest.
License: Apache-2.0. Verify compatibility with your product's distribution model.
Last repository activity: June 2026.
Review open issues and PR velocity to gauge maintainer responsiveness.
Star and watch the repo to track releases and security advisories.
Topics
Strengths
- Strong fit for mcp workflows in agent applications
- 105,612+ stars — proven adoption
- Apache-2.0 licensed
- Well-categorized (ai, ai-agents, cli)
Considerations
- Verify API costs and rate limits when connecting to paid LLM providers
- Test in a sandbox before granting production credentials or network access
- Upstream breaking changes may require periodic upgrades
- Align data handling with your privacy and compliance requirements