Initial commit of Gemini Code CLI
This commit introduces the initial codebase for the Gemini Code CLI, a command-line interface designed to facilitate interaction with the Gemini API for software engineering tasks.
The code was migrated from a previous git repository as a single squashed commit.
Core Features & Components:
* **Gemini Integration:** Leverages the `@google/genai` SDK to interact with the Gemini models, supporting chat history, streaming responses, and function calling (tools).
* **Terminal UI:** Built with Ink (React for CLIs) providing an interactive chat interface within the terminal, including input prompts, message display, loading indicators, and tool interaction elements.
* **Tooling Framework:** Implements a robust tool system allowing Gemini to interact with the local environment. Includes tools for:
* File system listing (`ls`)
* File reading (`read-file`)
* Content searching (`grep`)
* File globbing (`glob`)
* File editing (`edit`)
* File writing (`write-file`)
* Executing bash commands (`terminal`)
* **State Management:** Handles the streaming state of Gemini responses and manages the conversation history.
* **Configuration:** Parses command-line arguments (`yargs`) and loads environment variables (`dotenv`) for setup.
* **Project Structure:** Organized into `core`, `ui`, `tools`, `config`, and `utils` directories using TypeScript. Includes basic build (`tsc`) and start scripts.
This initial version establishes the foundation for a powerful CLI tool enabling developers to use Gemini for coding assistance directly in their terminal environment.
---
Created by yours truly: __Gemini Code__
2025-04-15 21:41:08 -07:00
|
|
|
{
|
2025-04-17 17:57:39 -04:00
|
|
|
// Use IntelliSense to learn about possible attributes.
|
|
|
|
|
// Hover to view descriptions of existing attributes.
|
|
|
|
|
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
|
|
|
|
|
"version": "0.2.0",
|
|
|
|
|
"configurations": [
|
|
|
|
|
{
|
|
|
|
|
"name": "Attach",
|
|
|
|
|
"port": 9229,
|
|
|
|
|
"request": "attach",
|
|
|
|
|
"skipFiles": ["<node_internals>/**"],
|
2025-04-21 19:04:00 -07:00
|
|
|
"type": "node",
|
2025-04-28 12:44:34 -07:00
|
|
|
// fix source mapping when debugging in sandbox using global installation
|
|
|
|
|
// note this does not interfere when remoteRoot is also ${workspaceFolder}/packages
|
|
|
|
|
"remoteRoot": "/usr/local/share/npm-global/lib/node_modules/@gemini-code",
|
2025-04-21 19:04:00 -07:00
|
|
|
"localRoot": "${workspaceFolder}/packages"
|
2025-04-17 17:57:39 -04:00
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"type": "node",
|
|
|
|
|
"request": "launch",
|
|
|
|
|
"name": "Launch Program",
|
|
|
|
|
"skipFiles": ["<node_internals>/**"],
|
|
|
|
|
"program": "${file}",
|
|
|
|
|
"outFiles": ["${workspaceFolder}/**/*.js"]
|
2025-05-16 11:58:37 -07:00
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"type": "node",
|
|
|
|
|
"request": "launch",
|
|
|
|
|
"name": "Debug CLI Test: text-buffer",
|
|
|
|
|
"runtimeExecutable": "npm",
|
|
|
|
|
"runtimeArgs": [
|
|
|
|
|
"run",
|
|
|
|
|
"test",
|
|
|
|
|
"-w",
|
|
|
|
|
"packages/cli",
|
|
|
|
|
"--",
|
|
|
|
|
"--inspect-brk=9229",
|
|
|
|
|
"--no-file-parallelism",
|
|
|
|
|
"${workspaceFolder}/packages/cli/src/ui/components/shared/text-buffer.test.ts"
|
|
|
|
|
],
|
|
|
|
|
"cwd": "${workspaceFolder}",
|
|
|
|
|
"console": "integratedTerminal",
|
|
|
|
|
"internalConsoleOptions": "neverOpen",
|
|
|
|
|
"skipFiles": ["<node_internals>/**"]
|
2025-05-20 13:02:41 -07:00
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"type": "node",
|
|
|
|
|
"request": "launch",
|
|
|
|
|
"name": "Debug Server Test: read-many-files",
|
|
|
|
|
"runtimeExecutable": "npm",
|
|
|
|
|
"runtimeArgs": [
|
|
|
|
|
"run",
|
|
|
|
|
"test",
|
|
|
|
|
"-w",
|
2025-05-30 18:25:47 -07:00
|
|
|
"packages/core",
|
2025-05-20 13:02:41 -07:00
|
|
|
"--",
|
|
|
|
|
"--inspect-brk=9229",
|
|
|
|
|
"--no-file-parallelism",
|
2025-05-30 18:25:47 -07:00
|
|
|
"${workspaceFolder}/packages/core/src/tools/read-many-files.test.ts"
|
2025-05-20 13:02:41 -07:00
|
|
|
],
|
|
|
|
|
"cwd": "${workspaceFolder}",
|
|
|
|
|
"console": "integratedTerminal",
|
|
|
|
|
"internalConsoleOptions": "neverOpen",
|
|
|
|
|
"skipFiles": ["<node_internals>/**"]
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"type": "node",
|
|
|
|
|
"request": "launch",
|
|
|
|
|
"name": "Debug CLI Test: atCommandProcessor",
|
|
|
|
|
"runtimeExecutable": "npm",
|
|
|
|
|
"runtimeArgs": [
|
|
|
|
|
"run",
|
|
|
|
|
"test",
|
|
|
|
|
"-w",
|
|
|
|
|
"packages/cli",
|
|
|
|
|
"--",
|
|
|
|
|
"--inspect-brk=9229",
|
|
|
|
|
"--no-file-parallelism",
|
|
|
|
|
"${workspaceFolder}/packages/cli/src/ui/hooks/atCommandProcessor.test.ts"
|
|
|
|
|
],
|
|
|
|
|
"cwd": "${workspaceFolder}",
|
|
|
|
|
"console": "integratedTerminal",
|
|
|
|
|
"internalConsoleOptions": "neverOpen",
|
|
|
|
|
"skipFiles": ["<node_internals>/**"]
|
2025-05-24 00:44:17 -07:00
|
|
|
},
|
2025-05-29 22:30:18 +00:00
|
|
|
{
|
|
|
|
|
"type": "node",
|
|
|
|
|
"request": "launch",
|
|
|
|
|
"name": "Debug Server Test: read-file",
|
|
|
|
|
"runtimeExecutable": "npm",
|
|
|
|
|
"runtimeArgs": [
|
|
|
|
|
"run",
|
|
|
|
|
"test",
|
|
|
|
|
"-w",
|
2025-05-30 18:25:47 -07:00
|
|
|
"packages/core",
|
2025-05-29 22:30:18 +00:00
|
|
|
"--",
|
|
|
|
|
"--inspect-brk=9229",
|
|
|
|
|
"--no-file-parallelism",
|
2025-05-30 18:25:47 -07:00
|
|
|
"${workspaceFolder}/packages/core/src/tools/read-file.test.ts"
|
2025-05-29 22:30:18 +00:00
|
|
|
],
|
|
|
|
|
"cwd": "${workspaceFolder}",
|
|
|
|
|
"console": "integratedTerminal",
|
|
|
|
|
"internalConsoleOptions": "neverOpen",
|
|
|
|
|
"skipFiles": ["<node_internals>/**"]
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"type": "node",
|
|
|
|
|
"request": "launch",
|
|
|
|
|
"name": "Debug Server Test: turn",
|
|
|
|
|
"runtimeExecutable": "npm",
|
|
|
|
|
"runtimeArgs": [
|
|
|
|
|
"run",
|
|
|
|
|
"test",
|
|
|
|
|
"-w",
|
2025-05-30 18:25:47 -07:00
|
|
|
"packages/core",
|
2025-05-29 22:30:18 +00:00
|
|
|
"--",
|
|
|
|
|
"--inspect-brk=9229",
|
|
|
|
|
"--no-file-parallelism",
|
2025-05-30 18:25:47 -07:00
|
|
|
"${workspaceFolder}/packages/core/src/core/turn.test.ts"
|
2025-05-29 22:30:18 +00:00
|
|
|
],
|
|
|
|
|
"cwd": "${workspaceFolder}",
|
|
|
|
|
"console": "integratedTerminal",
|
|
|
|
|
"internalConsoleOptions": "neverOpen",
|
|
|
|
|
"skipFiles": ["<node_internals>/**"]
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"type": "node",
|
|
|
|
|
"request": "launch",
|
|
|
|
|
"name": "Debug Server Test: fileUtils",
|
|
|
|
|
"runtimeExecutable": "npm",
|
|
|
|
|
"runtimeArgs": [
|
|
|
|
|
"run",
|
|
|
|
|
"test",
|
|
|
|
|
"-w",
|
2025-05-30 18:25:47 -07:00
|
|
|
"packages/core",
|
2025-05-29 22:30:18 +00:00
|
|
|
"--",
|
|
|
|
|
"--inspect-brk=9229",
|
|
|
|
|
"--no-file-parallelism",
|
2025-05-30 18:25:47 -07:00
|
|
|
"${workspaceFolder}/packages/core/src/utils/fileUtils.test.ts"
|
2025-05-29 22:30:18 +00:00
|
|
|
],
|
|
|
|
|
"cwd": "${workspaceFolder}",
|
|
|
|
|
"console": "integratedTerminal",
|
|
|
|
|
"internalConsoleOptions": "neverOpen",
|
|
|
|
|
"skipFiles": ["<node_internals>/**"]
|
|
|
|
|
},
|
2025-05-24 00:44:17 -07:00
|
|
|
{
|
|
|
|
|
"type": "node",
|
|
|
|
|
"request": "launch",
|
|
|
|
|
"name": "Debug useLoadingIndicator Test (CLI)",
|
|
|
|
|
"runtimeExecutable": "npm",
|
|
|
|
|
"runtimeArgs": [
|
|
|
|
|
"run",
|
|
|
|
|
"test",
|
|
|
|
|
"-w",
|
|
|
|
|
"packages/cli",
|
|
|
|
|
"--",
|
|
|
|
|
"--inspect-brk=9229",
|
|
|
|
|
"--no-file-parallelism",
|
|
|
|
|
"${workspaceFolder}/packages/cli/src/ui/hooks/useLoadingIndicator.test.ts"
|
|
|
|
|
],
|
|
|
|
|
"cwd": "${workspaceFolder}",
|
|
|
|
|
"console": "integratedTerminal",
|
|
|
|
|
"internalConsoleOptions": "neverOpen",
|
|
|
|
|
"skipFiles": ["<node_internals>/**"]
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"type": "node",
|
|
|
|
|
"request": "launch",
|
|
|
|
|
"name": "Debug LoadingIndicator Test (CLI)",
|
|
|
|
|
"runtimeExecutable": "npm",
|
|
|
|
|
"runtimeArgs": [
|
|
|
|
|
"run",
|
|
|
|
|
"test",
|
|
|
|
|
"-w",
|
|
|
|
|
"packages/cli",
|
|
|
|
|
"--",
|
|
|
|
|
"--inspect-brk=9229",
|
|
|
|
|
"--no-file-parallelism",
|
|
|
|
|
"${workspaceFolder}/packages/cli/src/ui/components/LoadingIndicator.test.tsx"
|
|
|
|
|
],
|
|
|
|
|
"cwd": "${workspaceFolder}",
|
|
|
|
|
"console": "integratedTerminal",
|
|
|
|
|
"internalConsoleOptions": "neverOpen",
|
|
|
|
|
"skipFiles": ["<node_internals>/**"]
|
2025-05-29 22:30:18 +00:00
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"type": "node",
|
|
|
|
|
"request": "launch",
|
|
|
|
|
"name": "Debug CLI Test: useGeminiStream",
|
|
|
|
|
"runtimeExecutable": "npm",
|
|
|
|
|
"runtimeArgs": [
|
|
|
|
|
"run",
|
|
|
|
|
"test",
|
|
|
|
|
"-w",
|
|
|
|
|
"packages/cli",
|
|
|
|
|
"--",
|
|
|
|
|
"--inspect-brk=9229",
|
|
|
|
|
"--no-file-parallelism",
|
|
|
|
|
"${workspaceFolder}/packages/cli/src/ui/hooks/useGeminiStream.test.tsx"
|
|
|
|
|
],
|
|
|
|
|
"cwd": "${workspaceFolder}",
|
|
|
|
|
"console": "integratedTerminal",
|
|
|
|
|
"internalConsoleOptions": "neverOpen",
|
|
|
|
|
"skipFiles": ["<node_internals>/**"]
|
2025-04-17 17:57:39 -04:00
|
|
|
}
|
|
|
|
|
]
|
|
|
|
|
}
|