# Gemini CLI documentation

> Gemini CLI brings the power of Gemini models directly into your terminal.

- 网址：https://funcoding.ai/agents/gemini-cli/overview/
- 来源：Gemini CLI 官方文档原文（英文），Apache-2.0 许可，同步于 2026-10-11
- 官方原文：https://geminicli.com/docs/

---
Gemini CLI brings the power of Gemini models directly into your terminal. Use it
to understand code, automate tasks, and build workflows with your local project
context.

## Install

```bash
npm install -g @google/gemini-cli
```

## Get started

Jump in to Gemini CLI.

- **[Quickstart](https://funcoding.ai/agents/gemini-cli/get-started/):** Your first session with Gemini CLI.
- **[Installation](https://funcoding.ai/agents/gemini-cli/get-started/installation/):** How to install Gemini CLI
  on your system.
- **[Authentication](https://funcoding.ai/agents/gemini-cli/get-started/authentication/):** Setup instructions for
  personal and enterprise accounts.
- **[CLI cheatsheet](https://funcoding.ai/agents/gemini-cli/cli/cli-reference/):** A quick reference for common
  commands and options.
- **[Gemini 3 on Gemini CLI](https://funcoding.ai/agents/gemini-cli/get-started/gemini-3/):** Learn about Gemini 3
  support in Gemini CLI.

## Use Gemini CLI

User-focused guides and tutorials for daily development workflows.

- **[File management](https://funcoding.ai/agents/gemini-cli/cli/tutorials/file-management/):** How to work with
  local files and directories.
- **[Get started with Agent skills](https://funcoding.ai/agents/gemini-cli/cli/tutorials/skills-getting-started/):**
  Getting started with specialized expertise.
- **[Manage context and memory](https://funcoding.ai/agents/gemini-cli/cli/tutorials/memory-management/):**
  Managing persistent instructions and facts.
- **[Execute shell commands](https://funcoding.ai/agents/gemini-cli/cli/tutorials/shell-commands/):** Executing
  system commands safely.
- **[Manage sessions and history](https://funcoding.ai/agents/gemini-cli/cli/tutorials/session-management/):**
  Resuming, managing, and rewinding conversations.
- **[Plan tasks with todos](https://funcoding.ai/agents/gemini-cli/cli/tutorials/task-planning/):** Using todos for
  complex workflows.
- **[Web search and fetch](https://funcoding.ai/agents/gemini-cli/cli/tutorials/web-tools/):** Searching and
  fetching content from the web.
- **[Set up an MCP server](https://funcoding.ai/agents/gemini-cli/cli/tutorials/mcp-setup/):** Set up an MCP
  server.
- **[Automate tasks](https://funcoding.ai/agents/gemini-cli/cli/tutorials/automation/):** Automate tasks.

## Features

Technical documentation for each capability of Gemini CLI.

- **[Extensions](https://funcoding.ai/agents/gemini-cli/extensions/):** Extend Gemini CLI with new tools and
  capabilities.
- **[Agent Skills](https://funcoding.ai/agents/gemini-cli/cli/skills/):** Use specialized agents for specific
  tasks.
- **[Checkpointing](https://funcoding.ai/agents/gemini-cli/cli/checkpointing/):** Automatic session snapshots.
- **[Headless mode](https://funcoding.ai/agents/gemini-cli/cli/headless/):** Programmatic and scripting interface.
- **[Hooks](https://funcoding.ai/agents/gemini-cli/hooks/):** Customize Gemini CLI behavior with scripts.
- **[IDE integration](https://funcoding.ai/agents/gemini-cli/ide-integration/):** Integrate Gemini CLI with
  your favorite IDE.
- **[MCP servers](https://funcoding.ai/agents/gemini-cli/tools/mcp-server/):** Connect to and use remote agents.
- **[Model routing](https://funcoding.ai/agents/gemini-cli/cli/model-routing/):** Automatic fallback resilience.
- **[Model selection](https://funcoding.ai/agents/gemini-cli/cli/model/):** Choose the best model for your needs.
- **[Plan mode 🔬](https://funcoding.ai/agents/gemini-cli/cli/plan-mode/):** Use a safe, read-only mode for
  planning complex changes.
- **[Subagents 🔬](https://funcoding.ai/agents/gemini-cli/core/subagents/):** Using specialized agents for specific
  tasks.
- **[Remote subagents 🔬](https://funcoding.ai/agents/gemini-cli/core/remote-agents/):** Connecting to and using
  remote agents.
- **[Rewind](https://funcoding.ai/agents/gemini-cli/cli/rewind/):** Rewind and replay sessions.
- **[Sandboxing](https://funcoding.ai/agents/gemini-cli/cli/sandbox/):** Isolate tool execution.
- **[Settings](https://funcoding.ai/agents/gemini-cli/cli/settings/):** Full configuration reference.
- **[Telemetry](https://funcoding.ai/agents/gemini-cli/cli/telemetry/):** Usage and performance metric details.
- **[Token caching](https://funcoding.ai/agents/gemini-cli/cli/token-caching/):** Performance optimization.

## Configuration

Settings and customization options for Gemini CLI.

- **[Custom commands](https://funcoding.ai/agents/gemini-cli/cli/custom-commands/):** Personalized shortcuts.
- **[Enterprise configuration](https://funcoding.ai/agents/gemini-cli/cli/enterprise/):** Professional environment
  controls.
- **[Ignore files (.geminiignore)](https://funcoding.ai/agents/gemini-cli/cli/gemini-ignore/):** Exclusion pattern
  reference.
- **[Model configuration](https://funcoding.ai/agents/gemini-cli/cli/generation-settings/):** Fine-tune generation
  parameters like temperature and thinking budget.
- **[Project context (GEMINI.md)](https://funcoding.ai/agents/gemini-cli/cli/gemini-md/):** Technical hierarchy of
  context files.
- **[System prompt override](https://funcoding.ai/agents/gemini-cli/cli/system-prompt/):** Instruction replacement
  logic.
- **[Themes](https://funcoding.ai/agents/gemini-cli/cli/themes/):** UI personalization technical guide.
- **[Trusted folders](https://funcoding.ai/agents/gemini-cli/cli/trusted-folders/):** Security permission logic.

## Reference

Deep technical documentation and API specifications.

- **[Command reference](https://funcoding.ai/agents/gemini-cli/reference/commands/):** Detailed slash command
  guide.
- **[Configuration reference](https://funcoding.ai/agents/gemini-cli/reference/configuration/):** Settings and
  environment variables.
- **[Keyboard shortcuts](https://funcoding.ai/agents/gemini-cli/reference/keyboard-shortcuts/):** Productivity
  tips.
- **[Memory import processor](https://funcoding.ai/agents/gemini-cli/reference/memport/):** How Gemini CLI
  processes memory from various sources.
- **[Policy engine](https://funcoding.ai/agents/gemini-cli/reference/policy-engine/):** Fine-grained execution
  control.
- **[Tools reference](https://funcoding.ai/agents/gemini-cli/reference/tools/):** Information on how tools are
  defined, registered, and used.

## Resources

Support, release history, and legal information.

- **[FAQ](https://funcoding.ai/agents/gemini-cli/resources/faq/):** Answers to frequently asked questions.
- **[Quota and pricing](https://funcoding.ai/agents/gemini-cli/resources/quota-and-pricing/):** Limits and billing
  details.
- **[Terms and privacy](https://funcoding.ai/agents/gemini-cli/resources/tos-privacy/):** Official notices and
  terms.
- **[Troubleshooting](https://funcoding.ai/agents/gemini-cli/resources/troubleshooting/):** Common issues and
  solutions.
- **[Uninstall](https://funcoding.ai/agents/gemini-cli/resources/uninstall/):** How to uninstall Gemini CLI.

## Development

- **[Contribution guide](https://geminicli.com/docs/contributing):** How to contribute to Gemini CLI.
- **[Integration testing](https://funcoding.ai/agents/gemini-cli/integration-tests/):** Running integration tests.
- **[Issue and PR automation](https://funcoding.ai/agents/gemini-cli/issue-and-pr-automation/):** Automation for
  issues and pull requests.
- **[Local development](https://funcoding.ai/agents/gemini-cli/local-development/):** Setting up a local
  development environment.
- **[NPM package structure](https://funcoding.ai/agents/gemini-cli/npm/):** The structure of the NPM packages.

## Releases

- **[Release notes](https://funcoding.ai/agents/gemini-cli/changelogs/):** Release notes for all versions.
- **[Stable release](https://funcoding.ai/agents/gemini-cli/changelogs/latest/):** The latest stable release.
- **[Preview release](https://funcoding.ai/agents/gemini-cli/changelogs/preview/):** The latest preview release.
