gemini-cli
An open-source AI agent that brings the power of Gemini directly into your terminal.
Gemini CLI is an open-source command-line tool that integrates Google's Gemini AI models directly into the terminal environment, with full support for MCP server extensions. Designed for developers who work primarily in the command line, it offers access to Gemini 2.0 and 3.0 models with up to 1 million token context windows. The tool includes built-in capabilities for code analysis, file operations, shell command execution, and Google Search grounding, while allowing developers to add custom functionality through MCP server integrations. It supports multiple authentication methods including OAuth, API keys, and Vertex AI, with a generous free tier and both interactive and headless scripting modes.
Key Features
Use Cases
- 01Analyzing and refactoring large codebases with natural language queries
- 02Generating new applications from PDFs, images, or UI sketches using multimodal inputs
- 03Automating DevOps tasks like querying pull requests or managing complex Git rebases
- 04Extending capabilities with MCP servers for media generation (Imagen, Veo, Lyria) or custom integrations
- 05Running non-interactive AI workflows in CI/CD pipelines and automation scripts
- 06Debugging production issues with real-time Google Search grounding for current information
Related MCP Servers
View moremarkitdown
Python tool for converting files and office documents to Markdown.
firecrawl
The context API to search, scrape, and interact with the web at scale. 🔥
prompts.chat
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.
langflow
Langflow is a powerful tool for building and deploying AI-powered agents and workflows.
gemini-cli — FAQ
What is Gemini CLI?+
Gemini CLI is an open-source terminal application that provides direct access to Google's Gemini AI models. It supports MCP server integrations to extend its capabilities with custom tools and can run both interactively and in headless scripting mode.
How do I install Gemini CLI?+
You can install Gemini CLI globally using npm (npm install -g @google/gemini-cli), Homebrew (brew install gemini-cli), or run it instantly with npx (@google/gemini-cli) without installation. It's also available via MacPorts and Anaconda for restricted environments.
Do I need an API key to use Gemini CLI?+
Not necessarily. You can sign in with your personal Google account (OAuth) for 60 requests/min and 1,000 requests/day free tier, or use a Gemini API key from AI Studio, or authenticate with Vertex AI for enterprise usage. The OAuth option requires no API key management.
How do I add MCP servers to Gemini CLI?+
Configure MCP servers in the ~/.gemini/settings.json file following the MCP Server Integration guide. Once configured, you can invoke custom tools using @ mentions like @github or @slack within your Gemini CLI sessions.
Which AI clients work with Gemini CLI?+
Gemini CLI is a standalone terminal application that runs independently, not a plugin for other AI clients. However, it includes VS Code companion support and can be integrated into GitHub workflows via the Gemini CLI GitHub Action.
Is Gemini CLI free to use?+
Yes, Gemini CLI is open-source (Apache 2.0 license) and offers a generous free tier: 60 requests/min and 1,000 requests/day with OAuth login, or 1,000 requests/day with Gemini API key. Usage-based billing is available for higher limits.
How do I install gemini-cli?+
Open the source repository on GitHub and follow its README. gemini-cli is a mcp server — MCP Agents Market links you directly to the official repo.
Is gemini-cli free?+
gemini-cli is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.