GEMINI.md

1# Gemini CLI VS Code Companion (`gemini-cli-vscode-ide-companion`)
2 
3VS Code extension that pairs with Gemini CLI, providing direct IDE workspace
4access to the CLI agent.
5 
6## Architecture
7 
8- `src/extension.ts`: Extension activation and lifecycle.
9- `src/ide-server.ts`: Local server exposing IDE capabilities to the CLI.
10- `src/diff-manager.ts`: Diff viewing and application.
11- `src/open-files-manager.ts`: Tracks and exposes open editor files.
12- `src/utils/`: Shared utility functions.
13 
14## Development
15 
16- Requires VS Code `^1.99.0`.
17- Build: `npm run build` (uses esbuild).
18- Launch via VS Code's "Run Extension" debug configuration.
19 
20## Testing
21 
22- Run tests: `npm test -w gemini-cli-vscode-ide-companion`
23- Tests use standard Vitest patterns alongside VS Code test APIs.
24