Software Development & Delivery · Public

gemini-cli

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

Best fitUsers who want source-backed project understanding before installing it.

Check whether this project matches your task before installing it.

What it can doPortable AI capability asset

Review the portable capability path.

Before continuingVerify in a sandbox

Do not treat a preview pack as a proven local install.

GitHub snapshot105k stars

14k forks · 681 contributors

Doramagic.ai Last verification date: 2026-07-09 Verification method: source evidence, semantic profile, public page gate, and static build acceptance.

Official first step Read manual preview Source repository

Publication status · 2026-07-09

What is gemini-cli?

An open-source AI agent that brings the power of Gemini directly into your terminal.
Best fit: Users who want source-backed project understanding before installing it.
Not for: Not for users who want to skip sandbox verification or cannot accept configuration, permission, or maintenance overhead.
Capability added to an AI workflow: Portable AI capability asset
First safe verification step: Verify the smallest path in an isolated environment and keep a rollback path.
Verification state: source, Quick Start, and sandbox install checks are recorded as passed.
Top risk: May increase setup, validation, or first-run risk for the user.
Evidence base: https://github.com/google-gemini/gemini-cli, https://github.com/google-gemini/gemini-cli#readme, Human Manual, Pitfall Log

Quick decision

Use this section to decide whether the project is worth a deeper read.

Best forUsers who want source-backed project understanding before installing it.

Match the project to your task before installing it.

CapabilityPortable AI capability asset

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

Repositorygoogle-gemini/gemini-cli

105k stars · 14k forks

What it can do

Translate the upstream project into concrete capabilities the user can judge before installing.

Overview & Getting Started

Related topics: System Architecture & Agent Loop

Source: https://github.com/google-gemini/gemini-cli / Human Manual

System Architecture & Agent Loop

Related topics: Overview & Getting Started, Built-in Tools & MCP Integration

Source: https://github.com/google-gemini/gemini-cli / Human Manual

Built-in Tools & MCP Integration

Related topics: Plan Mode & Skills System

Source: https://github.com/google-gemini/gemini-cli / Human Manual

Plan Mode & Skills System

Related topics: Built-in Tools & MCP Integration, Security: Sandbox, Policy Engine & Hooks

Source: https://github.com/google-gemini/gemini-cli / Human Manual

Security: Sandbox, Policy Engine & Hooks

Related topics: Plan Mode & Skills System, Sessions, Checkpointing & Rewind

Source: https://github.com/google-gemini/gemini-cli / Human Manual

Sources: https://github.com/google-gemini/gemini-cli, Human Manual, Project Pack evidence, and downstream validation signals.

Community Discussion Evidence

Project-level external discussion stays visible on the detail page, not only inside the manual.

Stars105k stars

Forks14k forks

Contributors681 contributors

LicenseApache-2.0

Community Discussion Evidence

12 source-linked items

Review these external discussions before using gemini-cli with real data or production workflows. They are review inputs, not standalone proof that the project is production-ready.

01
Add deterministic redaction and reduce Auto Memory logging
github / github_issue
02
Surface or quarantine invalid Auto Memory inbox patches
github / github_issue
03
Stop Auto Memory from retrying low-signal sessions indefinitely
github / github_issue
04
Memory system bugs and quality improvements
github / github_issue
05
Shell command execution gets stuck with "Waiting input" after command co
github / github_issue
06
Corruption after exiting external editors in terminalBuffer mode
github / github_issue
07
Robust component level evalutions
github / github_issue
08
Gemini CLI encounters 400 error with > 128 tools
github / github_issue
09
Model frequently creates tmp scripts in random spots
github / github_issue
10
Change the steering eval test to always pass
github / github_issue
11
Stabilize and Enhance Internal Project Evaluations
github / github_issue
12
Investigate using AST aware tools to search and perform file reads
github / github_issue

How to start

Only source-backed commands are shown here. Verify them in an isolated environment first.

Try the prompt first

Test the workflow without installing the upstream project.

preview

Read the Human Manual

Understand inputs, outputs, limits, and failure modes.

manual

Take context to your AI host

Use the compiled assets in your preferred AI environment.

context

Run sandbox verification

Confirm install commands and rollback before using a primary environment.

verify

npx @google/gemini-cli

Official start command · https://github.com/google-gemini/gemini-cli#readme · verified: yes

Human Manual

The English page must expose the real manual, not a short placeholder.

8+ sections · Human Manual

gemini-cli Manual

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

Open the full manual

https://github.com/google-gemini/gemini-cli Project Manual
Table of Contents
Overview & Getting Started
Related Pages
What Gemini CLI Is
Installation and First Run
Authentication Options
Core Features and Built-in Tools

Overview & Getting Started

Related topics: System Architecture & Agent Loop

Source: https://github.com/google-gemini/gemini-cli / Human Manual

System Architecture & Agent Loop

Related topics: Overview & Getting Started, Built-in Tools & MCP Integration

Source: https://github.com/google-gemini/gemini-cli / Human Manual

Built-in Tools & MCP Integration

Related topics: Plan Mode & Skills System

Source: https://github.com/google-gemini/gemini-cli / Human Manual

Plan Mode & Skills System

Related topics: Built-in Tools & MCP Integration, Security: Sandbox, Policy Engine & Hooks

Source: https://github.com/google-gemini/gemini-cli / Human Manual

Security: Sandbox, Policy Engine & Hooks

Related topics: Plan Mode & Skills System, Sessions, Checkpointing & Rewind

Source: https://github.com/google-gemini/gemini-cli / Human Manual

AI Context Pack and portable assets

After deciding to continue, take the project context into your own AI host.

Complete pack plus user-owned assets

These files are planning and verification assets for Claude Code, Codex, Gemini, Cursor, ChatGPT, and other AI hosts.

Download complete pack Read Human Manual

BundleComplete Project Pack AssetAI Context Pack AssetBoundary & Risk Card AssetHuman Manual AssetPitfall Log AssetPrompt Preview AssetQuick Start EvidenceREPO_INSPECTION.json

Preflight checks

Treat this page as a planning asset, not proof that your local environment is ready.

The manual is generated from source-linked project files and Doramagic validation signals.
Community evidence warnings stay visible instead of being converted into marketing claims.
This English page is indexable because the locale quality gate passed and explicit English index approval is enabled.
Use the upstream repository as the final authority for installation commands, license, and version-specific behavior.

Pitfall Log and verification risks

Doramagic surfaces high-risk items before users treat a candidate capability as verified.

high

Installation risk requires verification

May increase setup, validation, or first-run risk for the user.

high

Installation risk requires verification

May increase setup, validation, or first-run risk for the user.

high

Configuration risk requires verification

May increase setup, validation, or first-run risk for the user.

high

Runtime risk requires verification

May increase setup, validation, or first-run risk for the user.

high

Runtime risk requires verification

May increase setup, validation, or first-run risk for the user.

high

Runtime risk requires verification

May increase setup, validation, or first-run risk for the user.

high

Runtime risk requires verification

May increase setup, validation, or first-run risk for the user.

high

Maintenance risk requires verification

May increase setup, validation, or first-run risk for the user.