# gemini-cli: Bringing Gemini AI Power to Your Terminal

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/google-gemini-gemini-cli
Generated for open source discovery and AI-assisted research.

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
OSRepos URL: https://osrepos.com/repo/google-gemini-gemini-cli

## 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.

## Topics

- gemini
- gemini-api
- TypeScript
- AI
- CLI
- Developer Tools
- Open Source

## Repository Information

Last analyzed by OSRepos: Fri Oct 24 2025 12:01:46 GMT+0100 (Western European Summer Time)
Detail views: 5
GitHub clicks: 4

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Introduction
gemini-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/).

## Installation
To get started with gemini-cli, you have several convenient installation options:

### Quick Install

#### Run instantly with npx (no installation required)
bash
npx https://github.com/google-gemini/gemini-cli


#### Install globally with npm
bash
npm install -g @google/gemini-cli


#### Install globally with Homebrew (macOS/Linux)
bash
brew install gemini-cli


### System Requirements
*   Node.js version 20 or higher
*   macOS, Linux, or Windows

## Examples
gemini-cli is designed for intuitive use, whether you're starting a new project, analyzing existing code, or automating tasks.

### Basic Usage

#### Start in current directory
bash
gemini


#### Include multiple directories
bash
gemini --include-directories ../lib,../docs


#### Non-interactive mode for scripts
Get a simple text response:
bash
gemini -p "Explain the architecture of this codebase"


For more advanced scripting, including how to parse JSON and handle errors, use the `--output-format json` flag to get structured output:
bash
gemini -p "Explain the architecture of this codebase" --output-format json


### Quick Examples

#### Start a new project
bash
cd new-project/
gemini
# > Write me a Discord bot that answers questions using a FAQ.md file I will provide


#### Analyze existing code
bash
git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
# > Give me a summary of all of the changes that went in yesterday


## Why Use gemini-cli?
gemini-cli offers compelling reasons for developers to integrate AI into their workflow:

*   **Free Tier Access:** Enjoy 60 requests/min and 1,000 requests/day with a personal Google account, making powerful AI accessible.
*   **Gemini 2.5 Pro:** Access the advanced Gemini 2.5 Pro model with a 1M token context window for complex tasks.
*   **Built-in Tools:** Leverage integrated tools like Google Search grounding, file operations, shell commands, and web fetching.
*   **Extensible:** Support for the Model Context Protocol (MCP) allows for custom integrations and expanded capabilities.
*   **Terminal-First Design:** Optimized for developers who prefer to work within the command line environment.
*   **Open Source:** Licensed under Apache 2.0, encouraging community contributions and transparency.
*   **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).

## Links
For more information and to get involved, explore these resources:

*   **GitHub Repository:** [google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli)
*   **Official Documentation:** [geminicli.com/docs](https://geminicli.com/docs/)
*   **NPM Package:** [@google/gemini-cli](https://www.npmjs.com/package/@google/gemini-cli)
*   **GitHub Issues:** [Report bugs or request features](https://github.com/google-gemini/gemini-cli/issues)
*   **Contributing Guide:** [How to contribute](https://github.com/google-gemini/gemini-cli/blob/main/CONTRIBUTING.md)