Gemini CLI

Your open-source AI agent that brings the power of Gemini directly into your terminal

Download Now Learn More

See Gemini CLI in Action

Watch how Gemini CLI transforms your terminal workflow

Terminal — Gemini CLI
$ gemini 🚀 Gemini CLI v1.0.0 - Your AI assistant is ready! > Create a Python script to analyze my CSV sales data and generate charts ✓ Analyzing your request... ✓ Reading CSV structure... ✓ Generating Python script with pandas and matplotlib... 📁 Created: sales_analyzer.py 📊 Script includes: data cleaning, trend analysis, and 3 chart types > Debug this React component error: "Cannot read property 'map' of undefined" ✓ Analyzing error context... ✓ Found issue: Missing null check before array.map() 🔧 Suggested fix: Add optional chaining or default empty array 📝 Applied fix to UserList.jsx > _
60
Requests/minute
1000
Daily requests
1M
Token context
Free
Open source

Powerful AI in Your Terminal

⚡

Lightning Fast

Get instant AI assistance with industry-leading speed. 60 requests per minute and 1,000 daily requests at no charge.

🔧

Code Understanding

Query and edit large codebases within Gemini's massive 1 million token context window with intelligent code analysis.

🌐

Web Integration

Ground prompts with Google Search to fetch web pages and provide real-time, external context to the model.

🧩

Extensible

Extend capabilities through built-in Model Context Protocol (MCP) support and bundled extensions.

🎨

Multimodal

Generate new apps from PDFs or sketches using Gemini's advanced multimodal capabilities including Veo and Imagen.

🔒

Open Source

Fully open source (Apache 2.0) with transparent code that you can inspect, modify, and contribute to.

Easy Installation

Get started in minutes on any platform

1

Prerequisites

Make sure you have Git installed and a Google account ready.

git --version
2

Clone Repository

Download the Gemini CLI source code from GitHub.

git clone https://github.com/google-gemini/gemini-cli.git
cd gemini-cli
3

Install & Authenticate

Follow the setup script and sign in with your Google account.

./install.sh
gemini auth login
4

Start Using

You're ready! Start your first AI conversation.

gemini
1

Prerequisites

Install Git for Windows and ensure you have a Google account.

git --version
2

Clone Repository

Open PowerShell or Command Prompt and clone the repository.

git clone https://github.com/google-gemini/gemini-cli.git
cd gemini-cli
3

Install & Authenticate

Run the Windows installer and authenticate with Google.

.\install.bat
gemini auth login
4

Start Using

Launch Gemini CLI and start your AI-powered workflow.

gemini
1

Prerequisites

Ensure Git is installed on your Linux distribution.

# Ubuntu/Debian
sudo apt update && sudo apt install git

# CentOS/RHEL
sudo yum install git
2

Clone Repository

Clone the Gemini CLI repository to your local machine.

git clone https://github.com/google-gemini/gemini-cli.git
cd gemini-cli
3

Install & Configure

Make the installer executable and run the setup.

chmod +x install.sh
./install.sh
gemini auth login
4

Start Using

Begin your AI-enhanced terminal experience.

gemini

Real-World Use Cases

See how developers are using Gemini CLI in their daily workflows

🐛

Debug & Fix Issues

Quickly identify and resolve bugs in your codebase with AI-powered debugging assistance.

> Debug this React component error
📊

Data Analysis

Analyze CSV files, generate reports, and create data visualizations directly from your terminal.

> Analyze sales data and create charts
🚀

Project Kickstart

Generate complete applications, components, or scripts from simple descriptions or sketches.

> Create a Discord bot from FAQ.md
📝

Documentation

Auto-generate documentation, README files, and technical guides for your projects.

> Document this API endpoint
🔄

Code Refactoring

Modernize legacy code, optimize performance, and improve code structure with AI guidance.

> Refactor to use modern React hooks
🎨

Design to Code

Convert wireframes, mockups, or design sketches into working code and prototypes.

> Build this UI from my sketch

Frequently Asked Questions

Everything you need to know about Gemini CLI

Yes! Gemini CLI offers the industry's most generous free tier with 60 requests per minute and 1,000 requests per day at no charge. You just need a personal Google account to get started. For professional users needing higher limits, paid plans are available.
Gemini CLI supports macOS, Windows, and Linux. The installation process is streamlined for each platform, and you can run it in any terminal environment including Terminal, PowerShell, Command Prompt, or your favorite terminal emulator.
Your privacy is paramount. Gemini CLI runs locally on your machine and only sends your prompts to Google's Gemini API when you explicitly request assistance. Your code and files remain on your local system unless you specifically ask the AI to analyze them. All communications are encrypted.
Gemini CLI requires an internet connection to communicate with the Gemini API. However, it can work with your local files and execute commands locally. The AI assistance features require connectivity, but local file operations and command execution work offline.
Gemini CLI is unique in bringing Google's Gemini 2.5 Pro directly to your terminal with a massive 1 million token context window. Unlike IDE-based assistants, it works across your entire development workflow and integrates with system commands, file operations, and web search capabilities.
Absolutely! Gemini CLI is fully open source under the Apache 2.0 license. You can contribute by reporting bugs, suggesting features, improving documentation, or submitting code improvements. Visit our GitHub repository to get started with contributing.

Join Our Community

Connect with developers worldwide using Gemini CLI

⭐
15.2K
GitHub Stars
🍴
2.8K
Forks
👥
500+
Contributors
📦
v1.0.0
Latest Version
🐙
GitHub Repository
Source code, issues, and contributions
 💬
Discussions
Ask questions and share ideas
 📚
Documentation
Complete guides and API reference
 🐛
Report Issues
Bug reports and feature requests
 📰
Official Blog
Latest news and updates
 🚀
Gemini API
Learn about Gemini's capabilities

Getting Started

Start using Gemini CLI in minutes with these simple steps:

# 1. Clone the repository git clone https://github.com/google-gemini/gemini-cli cd gemini-cli # 2. Start Gemini CLI gemini # 3. Ask anything > Write me a Python script to analyze CSV data > Debug this error in my React component > Create a slide deck from my git history

All you need is a Google account to get started. Gemini CLI offers the industry's largest usage allowance completely free.

Start Building Now