google-gemini/gemini-cli: An open-source AI agent that brings the power of Gemini directly into your terminal.

google-geminigemini-cli An open-source AI agent that brings the power of Gemini directly into your terminal

How to Use a Remote Docker Server to Speed Up Your Workflow

n8n Now Runs My ENTIRE Homelab

Can I setup Gemini CLI in docker?

How to Setup Gemini CLI + Docker MCP Toolkit for powerful AI-assisted Development

Yes, Gemini CLI can be set up and run within Docker, offering a secure and isolated environment for AI-assisted development workflows. The recommended approach is to pair Gemini CLI with the Docker MCP Toolkit, which allows for easy management of multiple development tool integrations and provides a streamlined setup process.ajeetraina+2

Steps to Set Up Gemini CLI in Docker

  • Install Docker Desktop: Ensure Docker is running on the system.
  • Install Gemini CLI: Either install globally with npm (npm install -g @google/gemini-cli) or use a ready-made Docker image, such as weaponsforge/gemini-cli, designed for streamlined Gemini CLI deployments.hub.docker+1
  • Configure MCP Servers: Add MCP server configurations to the ~/.gemini/settings.json file. For Docker MCP Toolkit, include something like: json { "selectedAuthType": "oauth-personal", "theme": "Default", "mcpServers": { "MCP_DOCKER": { "command": "docker", "args": ["mcp", "gateway", "run"], "env": {} } } }
  • Authentication: After installation, start Gemini CLI with gemini, and follow the setup wizard to authenticate with your Google account or set the GEMINI_API_KEY as an environment variable if needed.codelabs.developers.google+2
  • Start Using Gemini CLI: Once configured and authenticated, you can access terminal-based AI tooling. Use /mcp commands to interact with integrated tools, and restart Gemini CLI after adding new servers to refresh the connections.reddit+1

Tips for Containerized Environments

  • Use the provided Docker images for the fastest setup without dependency conflicts.hub.docker
  • Update the settings.json file whenever adding new MCP integrations.
  • Restart Gemini CLI when the MCP tool catalog changes.reddit

By following these steps, Gemini CLI will function seamlessly in Docker, maximizing security, portability, and integration with other development tools in a modern workflow.dev+2

  1. https://www.ajeetraina.com/how-to-setup-gemini-cli-docker-mcp-toolkit-for-ai-assisted-development/
  2. https://dev.to/ajeetraina/how-to-setup-gemini-cli-docker-mcp-toolkit-for-powerful-ai-assisted-development-k4b
  3. https://codelabs.developers.google.com/cloud-gemini-cli-mcp-go
  4. https://www.reddit.com/r/docker/comments/1lmapqz/mcp_docker_in_geminicli/
  5. https://hub.docker.com/r/weaponsforge/gemini-cli
  6. https://www.youtube.com/watch?v=hmh30wuXg08
  7. https://github.com/google-gemini/gemini-cli
  8. https://www.reddit.com/r/googlecloud/comments/1lk55a4/gemini_cli_your_opensource_ai_agent/

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

google-gemini.github.io/gemini-cli/

Apache-2.0 license

NameName

Last commit message

Last commit date

Stop logging tool call error message to clearcut (#10511)

7db79e1 ·

2,666 Commits

.allstar

.allstar

.gcp

.gcp

.gemini

.gemini

feat(commands): Add new commands for docs, git, and PR review (#7853)

.github

.github

feat(lint): add sensitive keyword linter (#10488)

.husky

.husky

fix(pre-commit): improve monorepo handling and failure messaging (#9123)

.vscode

.vscode

Improve CI Times by 70% (#8530)

docs

docs

fix(doc) - Update releases doc (#10504)

hello

hello

Add 'getting started' extensions documentation (#9536)

integration-tests

integration-tests

test: fix flaky integration tests for compress command (#10371)

packages

packages

Stop logging tool call error message to clearcut (#10511)

Gemini CLI

Gemini CLI Screenshot

Gemini CLI is an open-source AI agent that brings the power of Gemini directly into your terminal. It provides lightweight access to Gemini, giving you the most direct path from your prompt to our model.

  • 🎯 Free tier: 60 requests/min and 1,000 requests/day with personal Google account.
  • 🧠 Powerful Gemini 2.5 Pro: Access to 1M token context window.
  • 🔧 Built-in tools: Google Search grounding, file operations, shell commands, web fetching.
  • 🔌 Extensible: MCP (Model Context Protocol) support for custom integrations.
  • 💻 Terminal-first: Designed for developers who live in the command line.
  • 🛡️ Open source: Apache 2.0 licensed.

📦 Installation

Quick Install

# Using npx (no installation required)
npx https://github.com/google-gemini/gemini-cli

npm install -g @google/gemini-cli

brew install gemini-cli

System Requirements

  • Node.js version 20 or higher
  • macOS, Linux, or Windows

See Releases for more details.

Preview

New preview releases will be published each week at UTC 2359 on Tuesdays. These releases will not have been fully vetted and may contain regressions or other outstanding issues. Please help us test and install with preview tag.

npm install -g @google/gemini-cli@preview

Stable

  • New stable releases will be published each week at UTC 2000 on Tuesdays, this will be the full promotion of last week's preview release + any bug fixes and validations. Use latest tag.
npm install -g @google/gemini-cli@latest

Nightly

  • New releases will be published each week at UTC 0000 each day, This will be all changes from the main branch as represented at time of release. It should be assumed there are pending validations and issues. Use nightly tag.
npm install -g @google/gemini-cli@nightly
  • Query and edit large codebases
  • Generate new apps from PDFs, images, or sketches using multimodal capabilities
  • Debug issues and troubleshoot with natural language
  • Automate operational tasks like querying pull requests or handling complex rebases
  • Use MCP servers to connect new capabilities, including media generation with Imagen, Veo or Lyria
  • Run non-interactively in scripts for workflow automation

Advanced Capabilities

  • Ground your queries with built-in Google Search for real-time information
  • Conversation checkpointing to save and resume complex sessions
  • Custom context files (GEMINI.md) to tailor behavior for your projects

GitHub Integration

Integrate Gemini CLI directly into your GitHub workflows with Gemini CLI GitHub Action:

  • Pull Request Reviews: Automated code review with contextual feedback and suggestions
  • Issue Triage: Automated labeling and prioritization of GitHub issues based on content analysis
  • On-demand Assistance: Mention @gemini-cli in issues and pull requests for help with debugging, explanations, or task delegation
  • Custom Workflows: Build automated, scheduled and on-demand workflows tailored to your team's needs

Choose the authentication method that best fits your needs:

✨ Best for: Individual developers as well as anyone who has a Gemini Code Assist License. (see quota limits and terms of service for details)

Benefits:

  • Free tier: 60 requests/min and 1,000 requests/day
  • Gemini 2.5 Pro with 1M token context window
  • No API key management - just sign in with your Google account
  • Automatic updates to latest models
gemini

# Set your Google Cloud Project
export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
gemini

✨ Best for: Developers who need specific model control or paid tier access

Benefits:

  • Free tier: 100 requests/day with Gemini 2.5 Pro
  • Model selection: Choose specific Gemini models
  • Usage-based billing: Upgrade for higher limits when needed
# Get your key from https://aistudio.google.com/apikey
export GEMINI_API_KEY="YOUR_API_KEY"
gemini

✨ Best for: Enterprise teams and production workloads

Benefits:

  • Enterprise features: Advanced security and compliance
  • Scalable: Higher rate limits with billing account
  • Integration: Works with existing Google Cloud infrastructure
# Get your key from Google Cloud Console
export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini

For Google Workspace accounts and other authentication methods, see the authentication guide.

Basic Usage

gemini

gemini --include-directories ../lib,../docs

gemini -m gemini-2.5-flash

Get a simple text response:

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:

gemini -p "Explain the architecture of this codebase" --output-format json

Quick Examples

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

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

📚 Documentation

Getting Started

Core Features

Advanced Topics

Configure MCP servers in ~/.gemini/settings.json to extend Gemini CLI with custom tools:

> @github List my open pull requests
> @slack Send a summary of today's commits to #dev channel
> @database Run a query to find inactive users

See the MCP Server Integration guide for setup instructions.

🤝 Contributing

We welcome contributions! Gemini CLI is fully open source (Apache 2.0), and we encourage the community to:

  • Report bugs and suggest features.
  • Improve documentation.
  • Submit code improvements.
  • Share your MCP servers and extensions.

See our Contributing Guide for development setup, coding standards, and how to submit pull requests.

Check our Official Roadmap for planned features and priorities.

📖 Resources

Uninstall

See the Uninstall Guide for removal instructions.

Built with ❤️ by Google and the open source community

Releases 110

+ 109 releases

Languages