{"name":"gemini-cli: Bringing Gemini AI Power to Your Terminal","description":"gemini-cli is an open-source AI agent that integrates the power of Google's Gemini directly into your terminal. It offers a lightweight and direct path from your prompts to the Gemini model, making AI accessible for developers who prefer the command line. This tool is designed to enhance productivity by providing AI assistance within your familiar development environment.","github":"https://github.com/google-gemini/gemini-cli","url":"https://osrepos.com/repo/google-gemini-gemini-cli","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/google-gemini-gemini-cli","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/google-gemini-gemini-cli.md","json":"https://osrepos.com/repo/google-gemini-gemini-cli.json","topics":["gemini","gemini-api","TypeScript","AI","CLI","Developer Tools","Open Source"],"keywords":["gemini","gemini-api","TypeScript","AI","CLI","Developer Tools","Open Source"],"stars":null,"summary":"gemini-cli is an open-source AI agent that integrates the power of Google's Gemini directly into your terminal. It offers a lightweight and direct path from your prompts to the Gemini model, making AI accessible for developers who prefer the command line. This tool is designed to enhance productivity by providing AI assistance within your familiar development environment.","content":"## Introduction\ngemini-cli is an open-source AI agent developed by Google Gemini, designed to bring the advanced capabilities of the Gemini model directly into your terminal. This command-line interface provides a lightweight and efficient way to interact with Gemini, offering a direct path from your prompts to the AI model. It is built for developers who live in the command line and seek powerful AI assistance without leaving their terminal environment. For comprehensive details, refer to the [official documentation](https://geminicli.com/docs/).\n\n## Installation\nTo get started with gemini-cli, you have several convenient installation options:\n\n### Quick Install\n\n#### Run instantly with npx (no installation required)\nbash\nnpx https://github.com/google-gemini/gemini-cli\n\n\n#### Install globally with npm\nbash\nnpm install -g @google/gemini-cli\n\n\n#### Install globally with Homebrew (macOS/Linux)\nbash\nbrew install gemini-cli\n\n\n### System Requirements\n*   Node.js version 20 or higher\n*   macOS, Linux, or Windows\n\n## Examples\ngemini-cli is designed for intuitive use, whether you're starting a new project, analyzing existing code, or automating tasks.\n\n### Basic Usage\n\n#### Start in current directory\nbash\ngemini\n\n\n#### Include multiple directories\nbash\ngemini --include-directories ../lib,../docs\n\n\n#### Non-interactive mode for scripts\nGet a simple text response:\nbash\ngemini -p \"Explain the architecture of this codebase\"\n\n\nFor more advanced scripting, including how to parse JSON and handle errors, use the `--output-format json` flag to get structured output:\nbash\ngemini -p \"Explain the architecture of this codebase\" --output-format json\n\n\n### Quick Examples\n\n#### Start a new project\nbash\ncd new-project/\ngemini\n# > Write me a Discord bot that answers questions using a FAQ.md file I will provide\n\n\n#### Analyze existing code\nbash\ngit clone https://github.com/google-gemini/gemini-cli\ncd gemini-cli\ngemini\n# > Give me a summary of all of the changes that went in yesterday\n\n\n## Why Use gemini-cli?\ngemini-cli offers compelling reasons for developers to integrate AI into their workflow:\n\n*   **Free Tier Access:** Enjoy 60 requests/min and 1,000 requests/day with a personal Google account, making powerful AI accessible.\n*   **Gemini 2.5 Pro:** Access the advanced Gemini 2.5 Pro model with a 1M token context window for complex tasks.\n*   **Built-in Tools:** Leverage integrated tools like Google Search grounding, file operations, shell commands, and web fetching.\n*   **Extensible:** Support for the Model Context Protocol (MCP) allows for custom integrations and expanded capabilities.\n*   **Terminal-First Design:** Optimized for developers who prefer to work within the command line environment.\n*   **Open Source:** Licensed under Apache 2.0, encouraging community contributions and transparency.\n*   **GitHub Integration:** Enhance your GitHub workflows with automated PR reviews, issue triage, and on-demand assistance via the [Gemini CLI GitHub Action](https://github.com/google-github-actions/run-gemini-cli).\n\n## Links\nFor more information and to get involved, explore these resources:\n\n*   **GitHub Repository:** [google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli)\n*   **Official Documentation:** [geminicli.com/docs](https://geminicli.com/docs/)\n*   **NPM Package:** [@google/gemini-cli](https://www.npmjs.com/package/@google/gemini-cli)\n*   **GitHub Issues:** [Report bugs or request features](https://github.com/google-gemini/gemini-cli/issues)\n*   **Contributing Guide:** [How to contribute](https://github.com/google-gemini/gemini-cli/blob/main/CONTRIBUTING.md)","metrics":{"detailViews":5,"githubClicks":4},"dates":{"published":null,"modified":"2025-10-24T11:01:46.000Z"}}