# google-gemini/gemini-cli

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/google-gemini-gemini-cli).**

105,341 stars · 14,078 forks · TypeScript · Apache-2.0

## Links

- GitHub: https://github.com/google-gemini/gemini-cli
- Homepage: https://geminicli.com
- awesome-repositories: https://awesome-repositories.com/repository/google-gemini-gemini-cli.md

## Topics

`ai` `ai-agents` `cli` `gemini` `gemini-api` `mcp-client` `mcp-server`

## Description

This project provides a command-line interface for managing autonomous agent workflows, task orchestration, and system-level automation. It includes a comprehensive framework for defining agent skills, managing persistent memory, and delegating tasks to specialized subagents. Users can configure complex planning modes, execute shell commands with safety constraints, and integrate external tools through standardized protocols.

The platform supports non-interactive execution via a headless mode and provides an event-driven hook framework for custom lifecycle automation. It features centralized configuration for model routing, system prompts, and cost management, alongside a modular extension system for adding custom commands and capabilities. The interface also includes diagnostic tools, file system management utilities, and repository-level automation for maintenance tasks.

## Tags

### Artificial Intelligence & ML

- [Agent Memory Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-orchestration-multi-agent/agent-memory-systems.md) — Persistent storage enables the saving and retrieval of user-provided facts to maintain context and personalized assistance across multiple sessions. ([source](https://geminicli.com/docs/cli/tutorials/memory-management))
- [Subagent Definitions](https://awesome-repositories.com/f/artificial-intelligence-ml/subagent-definitions.md) — Configuration-based definitions allow for the isolation of subagents with restricted tool access and built-in recursion protection for complex workflows. ([source](https://geminicli.com/docs/core/subagents))
- [Prompt Caching](https://awesome-repositories.com/f/artificial-intelligence-ml/prompt-caching.md) — Latency and API costs are minimized by storing previously processed prompt tokens for reuse in subsequent requests. ([source](https://geminicli.com/docs/cli/token-caching))
- [Agent Client Protocols](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-communication-protocols/agent-client-protocols.md) — Standardized communication protocols enable external agents to interact with the interface, facilitating file system access and remote session control. ([source](https://geminicli.com/docs/cli/acp-mode/))
- [Session Management Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/agent-frameworks/agent-runtimes/session-management-systems.md) — Session management maintains persistent state and interaction history, allowing users to resume workflows or rewind to specific points in time. ([source](https://geminicli.com/docs/cli/tutorials/session-management))
- [System and Configuration Layers](https://awesome-repositories.com/f/artificial-intelligence-ml/prompt-engineering/system-configuration-layers.md) — System-level instruction overrides enable users to define persistent behavioral patterns for the model that remain distinct from standard task prompts. ([source](https://geminicli.com/docs/cli/system-prompt))

### Development Tools & Productivity

- [CLI Extension Frameworks](https://awesome-repositories.com/f/development-tools-productivity/terminal-shell-cli/terminal-cli-enhancements/shell-terminal-utilities/frameworks-architectures/cli-extension-frameworks.md) — Modular architecture allows developers to register custom commands, configuration settings, and specialized agent skills directly within the interface. ([source](https://geminicli.com/docs/extensions/writing-extensions/))
- [Codebase Exploration Utilities](https://awesome-repositories.com/f/development-tools-productivity/code-editors-ides/codebase-exploration-utilities.md) — Search utilities enable the rapid location of code definitions and components within a project workspace. ([source](https://geminicli.com/docs/cli/tutorials/file-management))

### Testing & Quality Assurance

- [Integration Testing Suites](https://awesome-repositories.com/f/testing-quality-assurance/software-testing/testing-frameworks/test-frameworks/test-levels-and-types/integration-testing-suites.md) — Automated test suites verify the functional interoperability and cooperation between various software units, services, and API endpoints. ([source](https://geminicli.com/docs/integration-tests))

### Part of an Awesome List

- [Agent Frameworks](https://awesome-repositories.com/f/awesome-lists/ai/agent-frameworks.md) — Terminal-based agent with ReAct loops and large context support.
- [Agentic Coding Tools](https://awesome-repositories.com/f/awesome-lists/ai/agentic-coding-tools.md) — Official terminal agent for repository exploration and long-context tasks.
- [CLI Tools](https://awesome-repositories.com/f/awesome-lists/ai/cli-tools.md) — Terminal assistant built around Google Gemini.
- [Code Editors and Assistants](https://awesome-repositories.com/f/awesome-lists/devtools/code-editors-and-assistants.md) — Google's terminal coding agent powered by Gemini.
- [Coding Agents and IDEs](https://awesome-repositories.com/f/awesome-lists/devtools/coding-agents-and-ides.md) — Terminal AI agent with large context and search grounding.
- [Coding Assistants](https://awesome-repositories.com/f/awesome-lists/devtools/coding-assistants.md) — Terminal interface for interacting with large language models.
- [Command Line Tools](https://awesome-repositories.com/f/awesome-lists/devtools/command-line-tools.md) — Terminal coding agent with free Gemini 3 Pro access.

### Security & Cryptography

- [Action Resolution Policies](https://awesome-repositories.com/f/security-cryptography/identity-access-management/access-control/policy-enforcement-engines/action-resolution-policies.md) — Policy engines evaluate security rules based on tool names and environmental context to permit or restrict specific system actions. ([source](https://geminicli.com/docs/reference/policy-engine))

### Web Development

- [Code Application Utilities](https://awesome-repositories.com/f/web-development/web-infrastructure-deployment/code-application-utilities.md) — Researched web knowledge is applied directly into code generation and troubleshooting workflows through integrated utility functions. ([source](https://geminicli.com/docs/cli/tutorials/web-tools))
