Gemini CLI documentation

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

npm install -g @google/gemini-cli

Get started

Jump in to Gemini CLI.

Quickstart: Your first session with Gemini CLI.
Installation: How to install Gemini CLI on your system.
Authentication: Setup instructions for personal and enterprise accounts.
Examples: Practical examples of Gemini CLI in action.
Cheatsheet: A quick reference for common commands and options.

Use Gemini CLI

User-focused guides and tutorials for daily development workflows.

File management: How to work with local files and directories.
Manage context and memory: Managing persistent instructions and facts.
Execute shell commands: Executing system commands safely.
Manage sessions and history: Resuming, managing, and rewinding conversations.
Plan tasks with todos: Using todos for complex workflows.
Web search and fetch: Searching and fetching content from the web.
Get started with skills: Getting started with specialized expertise.

Features

Technical reference documentation for each capability of Gemini CLI.

/about: About Gemini CLI.
/auth: Authentication.
/bug: Report a bug.
/chat: Chat history.
/clear: Clear screen.
/compress: Compress context.
/copy: Copy output.
/directory: Manage workspace.
/docs: Open documentation.
/editor: Select editor.
/extensions: Manage extensions.
/help: Show help.
/hooks: Hooks.
/ide: IDE integration.
/init: Initialize context.
/mcp: MCP servers.
/memory: Manage memory.
/model: Model selection.
/policies: Manage policies.
/privacy: Privacy notice.
/quit: Exit CLI.
/restore: Restore files.
/resume: Resume session.
/rewind: Rewind.
/settings: Settings.
/setup-github: GitHub setup.
/shells: Manage processes.
/skills: Agent skills.
/stats: Session statistics.
/terminal-setup: Terminal keybindings.
/theme: Themes.
/tools: List tools.
/vim: Vim mode.
Activate skill (tool): Internal mechanism for loading expert procedures.
Ask user (tool): Internal dialog system for clarification.
Checkpointing: Automatic session snapshots.
File system (tool): Technical details for local file operations.
Headless mode: Programmatic and scripting interface.
Internal documentation (tool): Technical lookup for CLI features.
Memory (tool): Storage details for persistent facts.
Model routing: Automatic fallback resilience.
Plan mode (experimental): Use a safe, read-only mode for planning complex changes.
Sandboxing: Isolate tool execution.
Shell (tool): Detailed system execution parameters.
Telemetry: Usage and performance metric details.
Todo (tool): Progress tracking specification.
Token caching: Performance optimization.
Web fetch (tool): URL retrieval and extraction details.
Web search (tool): Google Search integration technicals.

Configuration

Settings and customization options for Gemini CLI.

Custom commands: Personalized shortcuts.
Enterprise configuration: Professional environment controls.
Ignore files (.geminiignore): Exclusion pattern reference.
Model configuration: Fine-tune generation parameters like temperature and thinking budget.
Project context (GEMINI.md): Technical hierarchy of context files.
Settings: Full configuration reference.
System prompt override: Instruction replacement logic.
Themes: UI personalization technical guide.
Trusted folders: Security permission logic.

Reference

Deep technical documentation and API specifications.

Architecture overview: System design and components.
Command reference: Detailed slash command guide.
Configuration reference: Settings and environment variables.
Core concepts: Fundamental terminology and definitions.
Keyboard shortcuts: Productivity tips.
Policy engine: Fine-grained execution control.

Resources

Support, release history, and legal information.

FAQ: Answers to frequently asked questions.
Changelogs: Highlights and notable changes.
Quota and pricing: Limits and billing details.
Terms and privacy: Official notices and terms.

6.6 KiB Raw Blame History