How google-gemini/gemini-cli works
Gemini CLI is a terminal-based AI coding agent. Its main workflow takes a developer prompt through the interactive or scriptable CLI, uses core model and tool capabilities to produce a response or perform work, and presents the result in the terminal. The repository also includes documented MCP extensibility and checkpointing, plus a separate A2A server. The graph preserves these product branches and selected internal layers; source excerpts are partial, so undocumented runtime links are omitted.
Main entry points: interactiveCli.tsx Interactive terminal · app.ts A2A HTTP API · nonInteractiveCli.ts Script mode · baseLlmClient.ts Model client
Components 25
CLI experience
- Interactive terminal
packages/cli/src/interactiveCli.tsx - Script mode
packages/cli/src/nonInteractiveCli.ts - Terminal UI
packages/cli/src/ui/App.tsx - Conversation history
packages/cli/src/ui/hooks/useHistoryManager.ts
Agent runtime
- Model client
packages/core/src/core/baseLlmClient.ts - Content generation
packages/core/src/core/contentGenerator.ts - Context pipeline
packages/core/src/context/pipeline.ts - Core events
packages/core/src/utils/events.ts
Tools and extensions
- Tool policy
packages/core/src/policy/policy-engine.ts - Command sandbox
packages/core/src/services/sandboxManager.ts - File editing
packages/core/src/tools/edit.ts - MCP integrations
packages/core/src/tools/mcp-client.ts - Project skills
packages/core/src/skills/skillManager.ts
Configuration and state
- Agent configuration
packages/core/src/config/config.ts - Project storage
packages/core/src/config/storage.ts - CLI settings
packages/cli/src/config/settings.ts - Session recording
packages/core/src/services/chatRecordingService.ts - MCP credentials
packages/core/src/mcp/oauth-token-storage.ts
A2A server
- A2A HTTP API
packages/a2a-server/src/http/app.ts - Task executor
packages/a2a-server/src/agent/executor.ts - Server configuration
packages/a2a-server/src/config/config.ts - Server settings
packages/a2a-server/src/config/settings.ts - Server commands
packages/a2a-server/src/commands/command-registry.ts
Other components
- Developer
- A2A client
Connections 27
- Developer → Interactive terminal: prompts
README.md - Developer → Script mode: submits prompt
README.md - Interactive terminal → Terminal UI: renders
- Interactive terminal → Agent configuration: configures
- Script mode → Agent configuration: configures
- Interactive terminal → Model client: requests generation
- Script mode → Model client: requests generation
- Model client → Content generation: calls
packages/core/src/core/baseLlmClient.ts - Model client → Agent configuration: reads settings
packages/core/src/core/baseLlmClient.ts - Interactive terminal → Context pipeline: provides project context
- Script mode → Context pipeline: provides project context
- Interactive terminal → Conversation history: updates
- Conversation history → Session recording: records
- Agent configuration → Project storage: uses
packages/core/src/config/storage.ts - Tool policy → Command sandbox: checks commands
packages/core/src/policy/policy-engine.ts - Interactive terminal → Tool policy: authorizes tool calls
- Interactive terminal → File editing: invokes tools
- Interactive terminal → MCP integrations: invokes integrations
- Interactive terminal → Project skills: loads skills
- Project skills → Project storage: loads skill locations
packages/core/src/skills/skillManager.ts - MCP integrations → MCP credentials: uses credentials
- MCP credentials → Core events: emits events
packages/core/src/mcp/oauth-token-storage.ts - A2A client → A2A HTTP API: submits tasks
packages/a2a-server/src/http/app.ts - A2A HTTP API → Task executor: creates tasks
packages/a2a-server/src/http/app.ts - A2A HTTP API → Server commands: dispatches commands
packages/a2a-server/src/http/app.ts - A2A HTTP API → Server settings: loads settings
packages/a2a-server/src/http/app.ts - A2A HTTP API → Server configuration: loads configuration
packages/a2a-server/src/http/app.ts