@google/gemini-cli 0.36.0 → 0.37.0-preview.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. package/bundle/{chunk-UNM3DGTG.js → chunk-33B2YA3V.js} +711 -240
  2. package/bundle/{chunk-2OFO4ODK.js → chunk-43UUP7VO.js} +6717 -4203
  3. package/bundle/{chunk-MYI75E6G.js → chunk-5OOT636U.js} +262 -92
  4. package/bundle/{chunk-GHJNEZXJ.js → chunk-BLL44IGV.js} +777 -294
  5. package/bundle/{chunk-S2IQOR7T.js → chunk-JS5WSGB2.js} +243 -88
  6. package/bundle/{chunk-QVTX2M5J.js → chunk-PPWUMHZT.js} +6355 -4117
  7. package/bundle/chunk-TSSVZ7RZ.js +98376 -0
  8. package/bundle/chunk-U4FACSVX.js +30 -0
  9. package/bundle/{chunk-VB55KQW3.js → chunk-VSXV53B7.js} +11735 -14377
  10. package/bundle/{chunk-EAXTBDLN.js → chunk-WZB27TDF.js} +711 -240
  11. package/bundle/chunk-ZB4UQCX5.js +356418 -0
  12. package/bundle/{core-6V2OYDRU.js → core-RMRIZ3E5.js} +60 -4
  13. package/bundle/{devtoolsService-ZKU2HLK2.js → devtoolsService-2ULAA43E.js} +20 -3
  14. package/bundle/{devtoolsService-UL6JE436.js → devtoolsService-AWVCG2N2.js} +22 -4
  15. package/bundle/devtoolsService-IWSTJYRB.js +871 -0
  16. package/bundle/{devtoolsService-QTW7GHQP.js → devtoolsService-SZYXXACN.js} +20 -3
  17. package/bundle/{core-BMLL5RF4.js → dist-4FKFY6XB.js} +60 -4
  18. package/bundle/{dist-PYC2JXAJ.js → dist-PRDBNGX2.js} +60 -4
  19. package/bundle/dist-TCCEQJDV.js +1942 -0
  20. package/bundle/docs/CONTRIBUTING.md +10 -7
  21. package/bundle/docs/assets/theme-tokyonight-dark.png +0 -0
  22. package/bundle/docs/changelogs/index.md +24 -0
  23. package/bundle/docs/changelogs/latest.md +366 -459
  24. package/bundle/docs/changelogs/preview.md +362 -356
  25. package/bundle/docs/cli/acp-mode.md +126 -0
  26. package/bundle/docs/cli/cli-reference.md +1 -1
  27. package/bundle/docs/cli/notifications.md +5 -5
  28. package/bundle/docs/cli/plan-mode.md +22 -11
  29. package/bundle/docs/cli/sandbox.md +1 -1
  30. package/bundle/docs/cli/settings.md +14 -13
  31. package/bundle/docs/cli/themes.md +5 -0
  32. package/bundle/docs/core/index.md +2 -2
  33. package/bundle/docs/core/subagents.md +134 -23
  34. package/bundle/docs/get-started/gemini-3.md +1 -1
  35. package/bundle/docs/get-started/index.md +127 -1
  36. package/bundle/docs/ide-integration/index.md +99 -24
  37. package/bundle/docs/index.md +0 -2
  38. package/bundle/docs/redirects.json +1 -0
  39. package/bundle/docs/reference/commands.md +1 -3
  40. package/bundle/docs/reference/configuration.md +182 -91
  41. package/bundle/docs/reference/keyboard-shortcuts.md +14 -6
  42. package/bundle/docs/reference/policy-engine.md +36 -31
  43. package/bundle/docs/reference/tools.md +56 -23
  44. package/bundle/docs/resources/quota-and-pricing.md +23 -9
  45. package/bundle/docs/sidebar.json +11 -4
  46. package/bundle/docs/tools/planning.md +6 -4
  47. package/bundle/events-CLX3JQHP.js +12 -0
  48. package/bundle/gemini.js +342 -52
  49. package/bundle/{interactiveCli-VLQHRXHU.js → interactiveCli-24VGI5NV.js} +5066 -4010
  50. package/bundle/{interactiveCli-A6HZ2TDO.js → interactiveCli-D2MTTARB.js} +5066 -4010
  51. package/bundle/{interactiveCli-DWMSDCKV.js → interactiveCli-DX76MWWT.js} +5296 -4223
  52. package/bundle/interactiveCli-VNDJAKWG.js +50355 -0
  53. package/bundle/{memoryDiscovery-BQGYT4OD.js → memoryDiscovery-A265O6ML.js} +3 -1
  54. package/bundle/{memoryDiscovery-FCEPFZ3M.js → memoryDiscovery-H6J7KIH2.js} +3 -1
  55. package/bundle/node_modules/@google/gemini-cli-devtools/dist/client/main.js +26 -19
  56. package/bundle/node_modules/@google/gemini-cli-devtools/dist/src/_client-assets.d.ts +1 -1
  57. package/bundle/node_modules/@google/gemini-cli-devtools/dist/src/_client-assets.js +1 -1
  58. package/bundle/node_modules/@google/gemini-cli-devtools/dist/src/_client-assets.js.map +1 -1
  59. package/bundle/node_modules/@google/gemini-cli-devtools/dist/src/index.js +35 -1
  60. package/bundle/node_modules/@google/gemini-cli-devtools/dist/src/index.js.map +1 -1
  61. package/bundle/node_modules/@google/gemini-cli-devtools/package.json +1 -1
  62. package/bundle/{oauth2-provider-5ENESIRQ.js → oauth2-provider-FZUTS3SV.js} +2 -2
  63. package/bundle/{oauth2-provider-CAKFQRQV.js → oauth2-provider-K25DXIWC.js} +2 -2
  64. package/bundle/{oauth2-provider-RVED6DAZ.js → oauth2-provider-N73M7SQI.js} +39 -73
  65. package/bundle/oauth2-provider-RMDEEXSP.js +237 -0
  66. package/bundle/policies/discovered.toml +7 -0
  67. package/bundle/policies/non-interactive.toml +7 -0
  68. package/bundle/policies/plan.toml +25 -0
  69. package/bundle/policies/read-only.toml +6 -0
  70. package/bundle/policies/sandbox-default.toml +3 -2
  71. package/bundle/policies/write.toml +21 -0
  72. package/bundle/policies/yolo.toml +1 -1
  73. package/package.json +1 -1
  74. package/bundle/docs/get-started/examples.md +0 -141
@@ -63,29 +63,62 @@ details.
63
63
 
64
64
  ## Available tools
65
65
 
66
- The following table lists all available tools, categorized by their primary
67
- function.
68
-
69
- | Category | Tool | Kind | Description |
70
- | :---------- | :----------------------------------------------- | :------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
71
- | Execution | [`run_shell_command`](../tools/shell.md) | `Execute` | Executes arbitrary shell commands. Supports interactive sessions and background processes. Requires manual confirmation.<br><br>**Parameters:** `command`, `description`, `dir_path`, `is_background` |
72
- | File System | [`glob`](../tools/file-system.md) | `Search` | Finds files matching specific glob patterns across the workspace.<br><br>**Parameters:** `pattern`, `dir_path`, `case_sensitive`, `respect_git_ignore`, `respect_gemini_ignore` |
73
- | File System | [`grep_search`](../tools/file-system.md) | `Search` | Searches for a regular expression pattern within file contents. Legacy alias: `search_file_content`.<br><br>**Parameters:** `pattern`, `dir_path`, `include`, `exclude_pattern`, `names_only`, `max_matches_per_file`, `total_max_matches` |
74
- | File System | [`list_directory`](../tools/file-system.md) | `Read` | Lists the names of files and subdirectories within a specified path.<br><br>**Parameters:** `dir_path`, `ignore`, `file_filtering_options` |
75
- | File System | [`read_file`](../tools/file-system.md) | `Read` | Reads the content of a specific file. Supports text, images, audio, and PDF.<br><br>**Parameters:** `file_path`, `start_line`, `end_line` |
76
- | File System | [`read_many_files`](../tools/file-system.md) | `Read` | Reads and concatenates content from multiple files. Often triggered by the `@` symbol in your prompt.<br><br>**Parameters:** `include`, `exclude`, `recursive`, `useDefaultExcludes`, `file_filtering_options` |
77
- | File System | [`replace`](../tools/file-system.md) | `Edit` | Performs precise text replacement within a file. Requires manual confirmation.<br><br>**Parameters:** `file_path`, `instruction`, `old_string`, `new_string`, `allow_multiple` |
78
- | File System | [`write_file`](../tools/file-system.md) | `Edit` | Creates or overwrites a file with new content. Requires manual confirmation.<br><br>**Parameters:** `file_path`, `content` |
79
- | Interaction | [`ask_user`](../tools/ask-user.md) | `Communicate` | Requests clarification or missing information via an interactive dialog.<br><br>**Parameters:** `questions` |
80
- | Interaction | [`write_todos`](../tools/todos.md) | `Other` | Maintains an internal list of subtasks. The model uses this to track its own progress and display it to you.<br><br>**Parameters:** `todos` |
81
- | Memory | [`activate_skill`](../tools/activate-skill.md) | `Other` | Loads specialized procedural expertise for specific tasks from the `.gemini/skills` directory.<br><br>**Parameters:** `name` |
82
- | Memory | [`get_internal_docs`](../tools/internal-docs.md) | `Think` | Accesses Gemini CLI's own documentation to provide more accurate answers about its capabilities.<br><br>**Parameters:** `path` |
83
- | Memory | [`save_memory`](../tools/memory.md) | `Think` | Persists specific facts and project details to your `GEMINI.md` file to retain context.<br><br>**Parameters:** `fact` |
84
- | Planning | [`enter_plan_mode`](../tools/planning.md) | `Plan` | Switches the CLI to a safe, read-only "Plan Mode" for researching complex changes.<br><br>**Parameters:** `reason` |
85
- | Planning | [`exit_plan_mode`](../tools/planning.md) | `Plan` | Finalizes a plan, presents it for review, and requests approval to start implementation.<br><br>**Parameters:** `plan` |
86
- | System | `complete_task` | `Other` | Finalizes a subagent's mission and returns the result to the parent agent. This tool is not available to the user.<br><br>**Parameters:** `result` |
87
- | Web | [`google_web_search`](../tools/web-search.md) | `Search` | Performs a Google Search to find up-to-date information.<br><br>**Parameters:** `query` |
88
- | Web | [`web_fetch`](../tools/web-fetch.md) | `Fetch` | Retrieves and processes content from specific URLs. **Warning:** This tool can access local and private network addresses (e.g., localhost), which may pose a security risk if used with untrusted prompts.<br><br>**Parameters:** `prompt` |
66
+ The following sections list all available tools, categorized by their primary
67
+ function. For detailed parameter information, see the linked documentation for
68
+ each tool.
69
+
70
+ ### Execution
71
+
72
+ | Tool | Kind | Description |
73
+ | :--------------------------------------- | :-------- | :----------------------------------------------------------------------------------------------------------------------- |
74
+ | [`run_shell_command`](../tools/shell.md) | `Execute` | Executes arbitrary shell commands. Supports interactive sessions and background processes. Requires manual confirmation. |
75
+
76
+ ### File System
77
+
78
+ | Tool | Kind | Description |
79
+ | :------------------------------------------- | :------- | :---------------------------------------------------------------------------------------------------- |
80
+ | [`glob`](../tools/file-system.md) | `Search` | Finds files matching specific glob patterns across the workspace. |
81
+ | [`grep_search`](../tools/file-system.md) | `Search` | Searches for a regular expression pattern within file contents. Legacy alias: `search_file_content`. |
82
+ | [`list_directory`](../tools/file-system.md) | `Read` | Lists the names of files and subdirectories within a specified path. |
83
+ | [`read_file`](../tools/file-system.md) | `Read` | Reads the content of a specific file. Supports text, images, audio, and PDF. |
84
+ | [`read_many_files`](../tools/file-system.md) | `Read` | Reads and concatenates content from multiple files. Often triggered by the `@` symbol in your prompt. |
85
+ | [`replace`](../tools/file-system.md) | `Edit` | Performs precise text replacement within a file. Requires manual confirmation. |
86
+ | [`write_file`](../tools/file-system.md) | `Edit` | Creates or overwrites a file with new content. Requires manual confirmation. |
87
+
88
+ ### Interaction
89
+
90
+ | Tool | Kind | Description |
91
+ | :--------------------------------- | :------------ | :------------------------------------------------------------------------------------- |
92
+ | [`ask_user`](../tools/ask-user.md) | `Communicate` | Requests clarification or missing information via an interactive dialog. |
93
+ | [`write_todos`](../tools/todos.md) | `Other` | Maintains an internal list of subtasks. The model uses this to track its own progress. |
94
+
95
+ ### Memory
96
+
97
+ | Tool | Kind | Description |
98
+ | :----------------------------------------------- | :------ | :----------------------------------------------------------------------------------- |
99
+ | [`activate_skill`](../tools/activate-skill.md) | `Other` | Loads specialized procedural expertise from the `.gemini/skills` directory. |
100
+ | [`get_internal_docs`](../tools/internal-docs.md) | `Think` | Accesses Gemini CLI's own documentation for accurate answers about its capabilities. |
101
+ | [`save_memory`](../tools/memory.md) | `Think` | Persists specific facts and project details to your `GEMINI.md` file. |
102
+
103
+ ### Planning
104
+
105
+ | Tool | Kind | Description |
106
+ | :---------------------------------------- | :----- | :--------------------------------------------------------------------------------------- |
107
+ | [`enter_plan_mode`](../tools/planning.md) | `Plan` | Switches the CLI to a safe, read-only "Plan Mode" for researching complex changes. |
108
+ | [`exit_plan_mode`](../tools/planning.md) | `Plan` | Finalizes a plan, presents it for review, and requests approval to start implementation. |
109
+
110
+ ### System
111
+
112
+ | Tool | Kind | Description |
113
+ | :-------------- | :------ | :----------------------------------------------------------------------------------------------------------------- |
114
+ | `complete_task` | `Other` | Finalizes a subagent's mission and returns the result to the parent agent. This tool is not available to the user. |
115
+
116
+ ### Web
117
+
118
+ | Tool | Kind | Description |
119
+ | :-------------------------------------------- | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
120
+ | [`google_web_search`](../tools/web-search.md) | `Search` | Performs a Google Search to find up-to-date information. |
121
+ | [`web_fetch`](../tools/web-fetch.md) | `Fetch` | Retrieves and processes content from specific URLs. **Warning:** This tool can access local and private network addresses (e.g., localhost), which may pose a security risk if used with untrusted prompts. |
89
122
 
90
123
  ## Under the hood
91
124
 
@@ -12,6 +12,21 @@ quota for your needs, see the [Plans page](https://geminicli.com/plans/).
12
12
  This article outlines the specific quotas and pricing applicable to Gemini CLI
13
13
  when using different authentication methods.
14
14
 
15
+ The following table summarizes the available quotas and their respective limits:
16
+
17
+ | Authentication method | Tier / Subscription | Maximum requests per user per day |
18
+ | :-------------------- | :------------------------------ | :-------------------------------- |
19
+ | **Google account** | Gemini Code Assist (Individual) | 1,000 requests |
20
+ | | Google AI Pro | 1,500 requests |
21
+ | | Google AI Ultra | 2,000 requests |
22
+ | **Gemini API key** | Free tier (Unpaid) | 250 requests |
23
+ | | Pay-as-you-go (Paid) | Varies |
24
+ | **Vertex AI** | Express mode (Free) | Varies |
25
+ | | Pay-as-you-go (Paid) | Varies |
26
+ | **Google Workspace** | Code Assist Standard | 1,500 requests |
27
+ | | Code Assist Enterprise | 2,000 requests |
28
+ | | Workspace AI Ultra | 2,000 requests |
29
+
15
30
  Generally, there are three categories to choose from:
16
31
 
17
32
  - Free Usage: Ideal for experimentation and light use.
@@ -20,6 +35,9 @@ Generally, there are three categories to choose from:
20
35
  - Pay-As-You-Go: The most flexible option for professional use, long-running
21
36
  tasks, or when you need full control over your usage.
22
37
 
38
+ Requests are limited per user per minute and are subject to the availability of
39
+ the service in times of high demand.
40
+
23
41
  ## Free usage
24
42
 
25
43
  Access to Gemini CLI begins with a generous free tier, perfect for
@@ -33,8 +51,7 @@ authorization type.
33
51
  For users who authenticate by using their Google account to access Gemini Code
34
52
  Assist for individuals. This includes:
35
53
 
36
- - 1000 model requests / user / day
37
- - 60 model requests / user / minute
54
+ - 1000 maximum model requests / user / day
38
55
  - Model requests will be made across the Gemini model family as determined by
39
56
  Gemini CLI.
40
57
 
@@ -46,8 +63,7 @@ Learn more at
46
63
  If you are using a Gemini API key, you can also benefit from a free tier. This
47
64
  includes:
48
65
 
49
- - 250 model requests / user / day
50
- - 10 model requests / user / minute
66
+ - 250 maximum model requests / user / day
51
67
  - Model requests to Flash model only.
52
68
 
53
69
  Learn more at
@@ -59,7 +75,7 @@ Vertex AI offers an Express Mode without the need to enable billing. This
59
75
  includes:
60
76
 
61
77
  - 90 days before you need to enable billing.
62
- - Quotas and models are variable and specific to your account.
78
+ - Quotas and models are specific to your account and their limits vary.
63
79
 
64
80
  Learn more at
65
81
  [Vertex AI Express Mode Limits](https://cloud.google.com/vertex-ai/generative-ai/docs/start/express-mode/overview#quotas).
@@ -112,11 +128,9 @@ Standard/Plus and AI Expanded, are not supported._
112
128
 
113
129
  This includes the following request limits:
114
130
  - Gemini Code Assist Standard edition:
115
- - 1500 model requests / user / day
116
- - 120 model requests / user / minute
131
+ - 1500 maximum model requests / user / day
117
132
  - Gemini Code Assist Enterprise edition:
118
- - 2000 model requests / user / day
119
- - 120 model requests / user / minute
133
+ - 2000 maximum model requests / user / day
120
134
  - Model requests will be made across the Gemini model family as determined by
121
135
  Gemini CLI.
122
136
 
@@ -12,7 +12,6 @@
12
12
  "label": "Authentication",
13
13
  "slug": "docs/get-started/authentication"
14
14
  },
15
- { "label": "Examples", "slug": "docs/get-started/examples" },
16
15
  { "label": "CLI cheatsheet", "slug": "docs/cli/cli-reference" },
17
16
  {
18
17
  "label": "Gemini 3 on Gemini CLI",
@@ -112,7 +111,17 @@
112
111
  { "label": "Reference", "slug": "docs/hooks/reference" }
113
112
  ]
114
113
  },
115
- { "label": "IDE integration", "slug": "docs/ide-integration" },
114
+ {
115
+ "label": "IDE integration",
116
+ "collapsed": true,
117
+ "items": [
118
+ { "label": "Overview", "slug": "docs/ide-integration" },
119
+ {
120
+ "label": "Developer guide: ACP mode",
121
+ "slug": "docs/cli/acp-mode"
122
+ }
123
+ ]
124
+ },
116
125
  { "label": "MCP servers", "slug": "docs/tools/mcp-server" },
117
126
  { "label": "Model routing", "slug": "docs/cli/model-routing" },
118
127
  { "label": "Model selection", "slug": "docs/cli/model" },
@@ -129,12 +138,10 @@
129
138
  { "label": "Plan mode", "slug": "docs/cli/plan-mode" },
130
139
  {
131
140
  "label": "Subagents",
132
- "badge": "🔬",
133
141
  "slug": "docs/core/subagents"
134
142
  },
135
143
  {
136
144
  "label": "Remote subagents",
137
- "badge": "🔬",
138
145
  "slug": "docs/core/remote-agents"
139
146
  },
140
147
  { "label": "Rewind", "slug": "docs/cli/rewind" },
@@ -32,7 +32,9 @@ and planning.
32
32
  ## 2. `exit_plan_mode` (ExitPlanMode)
33
33
 
34
34
  `exit_plan_mode` signals that the planning phase is complete. It presents the
35
- finalized plan to the user and requests approval to start the implementation.
35
+ finalized plan to the user and requests formal approval to start the
36
+ implementation. The agent MUST reach an informal agreement with the user in the
37
+ chat regarding the proposed strategy BEFORE calling this tool.
36
38
 
37
39
  - **Tool name:** `exit_plan_mode`
38
40
  - **Display name:** Exit Plan Mode
@@ -44,7 +46,7 @@ finalized plan to the user and requests approval to start the implementation.
44
46
  - **Behavior:**
45
47
  - Validates that the `plan_path` is within the allowed directory and that the
46
48
  file exists and has content.
47
- - Presents the plan to the user for review.
49
+ - Presents the plan to the user for formal review.
48
50
  - If the user approves the plan:
49
51
  - Switches the CLI's approval mode to the user's chosen approval mode (
50
52
  `DEFAULT` or `AUTO_EDIT`).
@@ -56,5 +58,5 @@ finalized plan to the user and requests approval to start the implementation.
56
58
  - On approval: A message indicating the plan was approved and the new approval
57
59
  mode.
58
60
  - On rejection: A message containing the user's feedback.
59
- - **Confirmation:** Yes. Shows the finalized plan and asks for user approval to
60
- proceed with implementation.
61
+ - **Confirmation:** Yes. Shows the finalized plan and asks for user formal
62
+ approval to proceed with implementation.
@@ -0,0 +1,12 @@
1
+ const require = (await import('node:module')).createRequire(import.meta.url); const __chunk_filename = (await import('node:url')).fileURLToPath(import.meta.url); const __chunk_dirname = (await import('node:path')).dirname(__chunk_filename);
2
+ import {
3
+ AppEvent,
4
+ TransientMessageType,
5
+ appEvents
6
+ } from "./chunk-U4FACSVX.js";
7
+ import "./chunk-34MYV7JD.js";
8
+ export {
9
+ AppEvent,
10
+ TransientMessageType,
11
+ appEvents
12
+ };