GEMINI.md

1# Gemini CLI Core (`@google/gemini-cli-core`)
2 
3Backend logic for Gemini CLI: API orchestration, prompt construction, tool
4execution, and agent management.
5 
6## Architecture
7 
8- `src/agent/` & `src/agents/`: Agent lifecycle and sub-agent management.
9- `src/availability/`: Model availability checks.
10- `src/billing/`: Billing and usage tracking.
11- `src/code_assist/`: Code assistance features.
12- `src/commands/`: Built-in CLI command implementations.
13- `src/config/`: Configuration management.
14- `src/confirmation-bus/`: User confirmation flow for tool execution.
15- `src/core/`: Core types and shared logic.
16- `src/fallback/`: Fallback and retry strategies.
17- `src/hooks/`: Hook system for extensibility.
18- `src/ide/`: IDE integration interfaces.
19- `src/mcp/`: MCP (Model Context Protocol) client and server integration.
20- `src/output/`: Output formatting and rendering.
21- `src/policy/`: Policy enforcement (e.g., tool confirmation policies).
22- `src/prompts/`: System prompt construction and prompt snippets.
23- `src/resources/`: Resource management.
24- `src/routing/`: Model routing and selection logic.
25- `src/safety/`: Safety filtering and guardrails.
26- `src/scheduler/`: Task scheduling.
27- `src/services/`: Shared service layer.
28- `src/skills/`: Skill discovery and activation.
29- `src/telemetry/`: Usage telemetry and logging.
30- `src/tools/`: Built-in tool implementations (file system, shell, web, MCP).
31- `src/utils/`: Shared utility functions.
32- `src/voice/`: Voice input/output support.
33 
34## Coding Conventions
35 
36- **Legacy Snippets:** `src/prompts/snippets.legacy.ts` is a snapshot of an
37  older system prompt. Avoid changing the prompting verbiage to preserve its
38  historical behavior; however, structural changes to ensure compilation or
39  simplify the code are permitted.
40- **Style:** Follow existing backend logic patterns. This package has no UI
41  dependencies — keep it framework-agnostic.
42 
43## Testing
44 
45- Run tests: `npm test -w @google/gemini-cli-core`
46- Run a specific test:
47  `npm test -w @google/gemini-cli-core -- src/path/to/file.test.ts`
48