mirror of
https://github.com/google-gemini/gemini-cli.git
synced 2026-06-24 02:07:16 -07:00
docs: weekly audit results for 24642541697
This commit is contained in:
github-merge-queue
committed by
github-actions[bot]
github-actions[bot]
parent
8573650253
commit
29a634446b
@@ -5,6 +5,9 @@ and parameters.
|
||||
|
||||
## CLI commands
|
||||
|
||||
Gemini CLI provides a range of commands for starting sessions, updating the
|
||||
application, and managing extensions and MCP servers.
|
||||
|
||||
| Command | Description | Example |
|
||||
| ---------------------------------- | ---------------------------------- | ------------------------------------------------------------ |
|
||||
| `gemini` | Start interactive REPL | `gemini` |
|
||||
@@ -17,10 +20,14 @@ and parameters.
|
||||
| `gemini -r "<session-id>" "query"` | Resume session by ID | `gemini -r "abc123" "Finish this PR"` |
|
||||
| `gemini update` | Update to latest version | `gemini update` |
|
||||
| `gemini extensions` | Manage extensions | See [Extensions Management](#extensions-management) |
|
||||
| `gemini hooks` | Manage hooks | See [Hooks Management](#hooks-management) |
|
||||
| `gemini mcp` | Configure MCP servers | See [MCP Server Management](#mcp-server-management) |
|
||||
| `gemini skills` | Manage agent skills | See [Skills Management](#skills-management) |
|
||||
|
||||
### Positional arguments
|
||||
|
||||
Use positional arguments to provide a prompt directly from the command line.
|
||||
|
||||
| Argument | Type | Description |
|
||||
| -------- | ----------------- | ---------------------------------------------------------------------------------------------------------- |
|
||||
| `query` | string (variadic) | Positional prompt. Defaults to interactive mode in a TTY. Use `-p/--prompt` for non-interactive execution. |
|
||||
@@ -42,6 +49,8 @@ These commands are available within the interactive REPL.
|
||||
|
||||
## CLI Options
|
||||
|
||||
Configure the behavior of Gemini CLI using these command-line options.
|
||||
|
||||
| Option | Alias | Type | Default | Description |
|
||||
| -------------------------------- | ----- | ------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `--debug` | `-d` | boolean | `false` | Run in debug mode with verbose logging |
|
||||
@@ -85,6 +94,8 @@ These are convenient shortcuts that map to specific models:
|
||||
|
||||
## Extensions management
|
||||
|
||||
Manage your Gemini CLI extensions with these commands.
|
||||
|
||||
| Command | Description | Example |
|
||||
| -------------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------ |
|
||||
| `gemini extensions install <source>` | Install extension from Git URL or local path | `gemini extensions install https://github.com/user/my-extension` |
|
||||
@@ -99,11 +110,24 @@ These are convenient shortcuts that map to specific models:
|
||||
| `gemini extensions link <path>` | Link local extension for development | `gemini extensions link /path/to/extension` |
|
||||
| `gemini extensions new <path>` | Create new extension from template | `gemini extensions new ./my-extension` |
|
||||
| `gemini extensions validate <path>` | Validate extension structure | `gemini extensions validate ./my-extension` |
|
||||
| `gemini extensions configure <name>` | Configure an extension | `gemini extensions configure my-extension` |
|
||||
|
||||
See [Extensions Documentation](../extensions/index.md) for more details.
|
||||
|
||||
## Hooks management
|
||||
|
||||
Manage your Gemini CLI hooks with these commands.
|
||||
|
||||
| Command | Description | Example |
|
||||
| ---------------------- | -------------------- | ---------------------- |
|
||||
| `gemini hooks migrate` | Migrate legacy hooks | `gemini hooks migrate` |
|
||||
|
||||
See [Hooks Documentation](../hooks/index.md) for more details.
|
||||
|
||||
## MCP server management
|
||||
|
||||
Manage your Model Context Protocol (MCP) servers with these commands.
|
||||
|
||||
| Command | Description | Example |
|
||||
| ------------------------------------------------------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------- |
|
||||
| `gemini mcp add <name> <command>` | Add stdio-based MCP server | `gemini mcp add github npx -y @modelcontextprotocol/server-github` |
|
||||
@@ -113,11 +137,15 @@ See [Extensions Documentation](../extensions/index.md) for more details.
|
||||
| `gemini mcp add <name> <command> --include-tools tool1,tool2` | Add with specific tools | `gemini mcp add github npx -y @modelcontextprotocol/server-github --include-tools list_repos,get_pr` |
|
||||
| `gemini mcp remove <name>` | Remove an MCP server | `gemini mcp remove github` |
|
||||
| `gemini mcp list` | List all configured MCP servers | `gemini mcp list` |
|
||||
| `gemini mcp enable <name>` | Enable an MCP server | `gemini mcp enable github` |
|
||||
| `gemini mcp disable <name>` | Disable an MCP server | `gemini mcp disable github` |
|
||||
|
||||
See [MCP Server Integration](../tools/mcp-server.md) for more details.
|
||||
|
||||
## Skills management
|
||||
|
||||
Manage your agent skills with these commands.
|
||||
|
||||
| Command | Description | Example |
|
||||
| -------------------------------- | ------------------------------------- | ------------------------------------------------- |
|
||||
| `gemini skills list` | List all discovered agent skills | `gemini skills list` |
|
||||
|
||||
@@ -2545,29 +2545,29 @@ image separately and reference that image in your sandbox configuration.
|
||||
|
||||
## Usage statistics
|
||||
|
||||
To help us improve Gemini CLI, we collect anonymized usage statistics. This data
|
||||
helps us understand how the CLI is used, identify common issues, and prioritize
|
||||
new features.
|
||||
To improve Gemini CLI, Gemini CLI collects anonymized usage statistics. This
|
||||
data helps identify common issues and prioritize new features.
|
||||
|
||||
**What we collect:**
|
||||
**Collected data:**
|
||||
|
||||
- **Tool calls:** We log the names of the tools that are called, whether they
|
||||
succeed or fail, and how long they take to execute. We do not collect the
|
||||
arguments passed to the tools or any data returned by them.
|
||||
- **API requests:** We log the Gemini model used for each request, the duration
|
||||
of the request, and whether it was successful. We do not collect the content
|
||||
of the prompts or responses.
|
||||
- **Session information:** We collect information about the configuration of the
|
||||
CLI, such as the enabled tools and the approval mode.
|
||||
- **Tool calls:** Gemini CLI logs the names of the tools that are called,
|
||||
whether they succeed or fail, and how long they take to execute. Gemini CLI
|
||||
does not collect the arguments passed to the tools or any data returned by
|
||||
them.
|
||||
- **API requests:** Gemini CLI logs the Gemini model used for each request, the
|
||||
duration of the request, and whether it was successful. Gemini CLI does not
|
||||
collect the content of the prompts or responses.
|
||||
- **Session information:** Gemini CLI collects information about the
|
||||
configuration of the CLI, such as the enabled tools and the approval mode.
|
||||
|
||||
**What we DON'T collect:**
|
||||
**Data NOT collected:**
|
||||
|
||||
- **Personally identifiable information (PII):** We do not collect any personal
|
||||
information, such as your name, email address, or API keys.
|
||||
- **Prompt and response content:** We do not log the content of your prompts or
|
||||
the responses from the Gemini model.
|
||||
- **File content:** We do not log the content of any files that are read or
|
||||
written by the CLI.
|
||||
- **Personally identifiable information (PII):** Gemini CLI does not collect
|
||||
personal information, such as your name, email address, or API keys.
|
||||
- **Prompt and response content:** Gemini CLI does not log the content of your
|
||||
prompts or the responses from the Gemini model.
|
||||
- **File content:** Gemini CLI does not log the content of any files that are
|
||||
read or written by the CLI.
|
||||
|
||||
**How to opt out:**
|
||||
|
||||
|
||||
Reference in New Issue
Block a user