Terminal-first interface
Use Gemini from the terminal for interactive prompting or scripted `-p` requests, keeping the workflow close to the codebase and shell tools you already use.
Gemini CLI
Gemini CLI is an open-source AI agent for the terminal that brings Gemini into command-line workflows. It supports interactive prompting, headless scripting, and project-specific extensions for developers.
Overview
Gemini CLI is an open-source AI agent for the terminal that brings Gemini into command-line workflows. It is presented as a lightweight way to prompt the model directly from the shell, with support for interactive use, headless scripting, and project-specific context.
The product combines code understanding, file and shell operations, Google Search grounding, and MCP-based extensibility. The docs also show GitHub workflow support, conversation checkpointing, and output formats that include text and JSON for automation use cases.
Key features
Code and multimodal assistance
Query and edit large codebases, generate apps from PDFs, images, or sketches, and troubleshoot issues with natural-language prompts.
Built-in tools
Use built-in Google Search grounding, file operations, shell commands, and web fetching to connect the model to local and external context.
Headless automation
Run headless with text or JSON output, pipe content from stdin, and redirect results to files for batch jobs and automation.
Extensibility and project context
Extend behavior with MCP servers, custom commands, and custom context files such as `GEMINI.md` to tailor sessions to your project.
Session and workflow support
Save and resume conversations, share chat history, and use GitHub-oriented workflows such as pull request reviews and issue triage.
Common use cases
Codebase analysis and debugging
Use Gemini CLI to inspect a repository, summarize changes, explain architecture, or troubleshoot code while staying in the terminal.
Automation and batch workflows
Run prompts non-interactively in shell scripts or CI jobs, pipe files into the model, and capture text or JSON output for downstream steps.
Session management and iterative work
Use the built-in commands and checkpointing features to branch conversations, save progress, and return to a previous state during longer sessions.
Project-specific extensions
Connect MCP servers, custom commands, and project context files to adapt Gemini CLI to a specific team or repository.
GitHub workflow support
Use the GitHub Action guidance for pull request reviews, issue triage, and on-demand assistance in repository workflows.
Pros and Cons
Pros
- Open-source and Apache 2.0 licensed.
- Free tier is documented for Google-account login.
- Supports both interactive terminal use and headless scripting.
- Built-in tools cover search, files, shell commands, and web fetching.
- MCP support and custom commands make it extensible for project-specific workflows.
Cons
- The pricing page in the collected sources is not available, so paid-plan details are not confirmed there.
- Some commands depend on external tools or environment setup, such as clipboard utilities for `/copy` and the supported Node.js or OS requirements.
- Preview and nightly releases are explicitly described as potentially containing regressions or outstanding issues.
FAQ
How do I get started with Gemini CLI?
Gemini CLI can be started from the terminal after installing it with `npx`, `npm`, or Homebrew. The docs also show a basic `gemini` command for interactive use and `gemini -p` for headless prompts.
Who is Gemini CLI for?
It is designed for developers working in the command line, and the docs describe use in scripting, automation, CI/CD pipelines, and GitHub workflows.
Can Gemini CLI be used in scripts?
Gemini CLI supports both interactive sessions and headless mode. In headless mode it can accept prompts from command-line arguments or stdin, and it can return text or JSON output for automation.
What does Gemini CLI cost?
The site lists a free tier for Google-account login and also documents API key and Vertex AI authentication options. The pricing page on the site is not available, so paid-plan details are not confirmed there.
Are there any limitations to know about?
The docs mention limits such as checkpoint storage locations, clipboard tool requirements for `/copy`, and that preview or nightly releases may contain regressions or outstanding issues. Headless usage also relies on valid authentication and a supported environment.
Quick Facts
- Category
- Developer Tool
- Platform
- macOS, Linux, Windows
- Primary interface
- Terminal / CLI
- Auth options
- Google login, Gemini API key, Vertex AI
- Source domain
- google-gemini.github.io
- License
- Apache 2.0
Альтернативы Gemini CLI
Tabnine
Tabnine is an AI code assistant for developers and engineering teams, with code completions, in-IDE chat, and enterprise deployment options. It emphasizes code privacy, governance, and context-aware AI grounded in the user’s codebase.
AakarDev AI
AakarDev AI helps teams manage AI provider access, project-level setups, logs, and analytics from one dashboard. It supports BYOK workflows and lists providers including OpenAI, Google Gemini, Anthropic, Groq, Mistral AI, and Perplexity AI.
JetBrains
JetBrains makes developer tools for individuals, teams, and businesses, including IntelliJ IDEA, PyCharm, DataGrip, WebStorm, Rider, and CLion. Its IDEs combine code-aware navigation, suggestions, and built-in run/debug/test workflows, with additional tools for CI/CD, project management, code quality, and documentation.
Perchance
Perchance is a browser-based random generator editor for creating and managing custom generators. It supports code editing, account-based saving, and revision recovery, but the provided sources do not confirm pricing or integrations.
图像大厨imgcook
imgcook is a design-to-code tool that converts design drafts into front-end code. It supports plugin-based and developer workflows for Sketch, Photoshop, VS Code, and CLI usage.
Devin Desktop
Devin Desktop is Windsurf’s desktop product for managing local and cloud agents from one workspace. It supports Mac, Windows, and Linux, with additional access through a JetBrains plugin and a local CLI.