@google/gemini-cli 0.0.8999999 → 0.0.77777773

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 (465) hide show
  1. package/README.md +105 -62
  2. package/dist/package.json +13 -5
  3. package/dist/src/commands/extensions/examples/context/GEMINI.md +9 -3
  4. package/dist/src/commands/extensions/examples/context/gemini-extension.json +1 -2
  5. package/dist/src/commands/extensions/examples/mcp-server/gemini-extension.json +3 -2
  6. package/dist/src/commands/extensions/examples/mcp-server/package.json +18 -0
  7. package/dist/src/commands/extensions/examples/mcp-server/tsconfig.json +13 -0
  8. package/dist/src/commands/extensions/install.d.ts +2 -2
  9. package/dist/src/commands/extensions/install.js +35 -36
  10. package/dist/src/commands/extensions/install.js.map +1 -1
  11. package/dist/src/commands/extensions/install.test.js +25 -25
  12. package/dist/src/commands/extensions/install.test.js.map +1 -1
  13. package/dist/src/commands/extensions/link.js +2 -2
  14. package/dist/src/commands/extensions/link.js.map +1 -1
  15. package/dist/src/commands/extensions/list.js +1 -1
  16. package/dist/src/commands/extensions/list.js.map +1 -1
  17. package/dist/src/commands/extensions/new.js +28 -8
  18. package/dist/src/commands/extensions/new.js.map +1 -1
  19. package/dist/src/commands/extensions/new.test.js +14 -5
  20. package/dist/src/commands/extensions/new.test.js.map +1 -1
  21. package/dist/src/commands/extensions/uninstall.js +1 -1
  22. package/dist/src/commands/extensions/uninstall.js.map +1 -1
  23. package/dist/src/commands/extensions/uninstall.test.js +4 -1
  24. package/dist/src/commands/extensions/uninstall.test.js.map +1 -1
  25. package/dist/src/commands/extensions/update.js +35 -24
  26. package/dist/src/commands/extensions/update.js.map +1 -1
  27. package/dist/src/commands/mcp/add.js +6 -1
  28. package/dist/src/commands/mcp/add.js.map +1 -1
  29. package/dist/src/commands/mcp/list.js +5 -4
  30. package/dist/src/commands/mcp/list.js.map +1 -1
  31. package/dist/src/config/config.d.ts +7 -4
  32. package/dist/src/config/config.js +125 -39
  33. package/dist/src/config/config.js.map +1 -1
  34. package/dist/src/config/extension.d.ts +44 -18
  35. package/dist/src/config/extension.js +250 -143
  36. package/dist/src/config/extension.js.map +1 -1
  37. package/dist/src/config/extensions/extensionEnablement.d.ts +12 -9
  38. package/dist/src/config/extensions/extensionEnablement.js +36 -9
  39. package/dist/src/config/extensions/extensionEnablement.js.map +1 -1
  40. package/dist/src/config/extensions/extensionEnablement.test.js +74 -1
  41. package/dist/src/config/extensions/extensionEnablement.test.js.map +1 -1
  42. package/dist/src/config/extensions/github.d.ts +14 -2
  43. package/dist/src/config/extensions/github.js +111 -89
  44. package/dist/src/config/extensions/github.js.map +1 -1
  45. package/dist/src/config/extensions/github.test.js +124 -13
  46. package/dist/src/config/extensions/github.test.js.map +1 -1
  47. package/dist/src/config/extensions/github_fetch.d.ts +7 -0
  48. package/dist/src/config/extensions/github_fetch.js +34 -0
  49. package/dist/src/config/extensions/github_fetch.js.map +1 -0
  50. package/dist/src/config/extensions/update.d.ts +4 -5
  51. package/dist/src/config/extensions/update.js +64 -42
  52. package/dist/src/config/extensions/update.js.map +1 -1
  53. package/dist/src/config/extensions/update.test.js +121 -71
  54. package/dist/src/config/extensions/update.test.js.map +1 -1
  55. package/dist/src/config/keyBindings.js +1 -1
  56. package/dist/src/config/keyBindings.js.map +1 -1
  57. package/dist/src/config/policy.js +2 -2
  58. package/dist/src/config/policy.js.map +1 -1
  59. package/dist/src/config/settings.d.ts +10 -1
  60. package/dist/src/config/settings.js +21 -6
  61. package/dist/src/config/settings.js.map +1 -1
  62. package/dist/src/config/settingsSchema.d.ts +97 -5
  63. package/dist/src/config/settingsSchema.js +96 -4
  64. package/dist/src/config/settingsSchema.js.map +1 -1
  65. package/dist/src/config/settingsSchema.test.js +8 -0
  66. package/dist/src/config/settingsSchema.test.js.map +1 -1
  67. package/dist/src/config/trustedFolders.d.ts +10 -2
  68. package/dist/src/config/trustedFolders.js +41 -16
  69. package/dist/src/config/trustedFolders.js.map +1 -1
  70. package/dist/src/config/trustedFolders.test.js +95 -14
  71. package/dist/src/config/trustedFolders.test.js.map +1 -1
  72. package/dist/src/gemini.js +114 -132
  73. package/dist/src/gemini.js.map +1 -1
  74. package/dist/src/gemini.test.js +95 -14
  75. package/dist/src/gemini.test.js.map +1 -1
  76. package/dist/src/generated/git-commit.d.ts +2 -2
  77. package/dist/src/generated/git-commit.js +2 -2
  78. package/dist/src/generated/git-commit.js.map +1 -1
  79. package/dist/src/services/BuiltinCommandLoader.js +7 -0
  80. package/dist/src/services/BuiltinCommandLoader.js.map +1 -1
  81. package/dist/src/services/BuiltinCommandLoader.test.js +87 -1
  82. package/dist/src/services/BuiltinCommandLoader.test.js.map +1 -1
  83. package/dist/src/services/FileCommandLoader.d.ts +1 -1
  84. package/dist/src/services/FileCommandLoader.js +4 -4
  85. package/dist/src/services/FileCommandLoader.js.map +1 -1
  86. package/dist/src/services/prompt-processors/shellProcessor.js +1 -1
  87. package/dist/src/services/prompt-processors/shellProcessor.js.map +1 -1
  88. package/dist/src/test-utils/render.d.ts +12 -1
  89. package/dist/src/test-utils/render.js +56 -1
  90. package/dist/src/test-utils/render.js.map +1 -1
  91. package/dist/src/ui/App.js +7 -9
  92. package/dist/src/ui/App.js.map +1 -1
  93. package/dist/src/ui/AppContainer.js +99 -27
  94. package/dist/src/ui/AppContainer.js.map +1 -1
  95. package/dist/src/ui/AppContainer.test.js +300 -7
  96. package/dist/src/ui/AppContainer.test.js.map +1 -1
  97. package/dist/src/ui/IdeIntegrationNudge.js +3 -0
  98. package/dist/src/ui/IdeIntegrationNudge.js.map +1 -1
  99. package/dist/src/ui/auth/AuthDialog.js +8 -1
  100. package/dist/src/ui/auth/AuthDialog.js.map +1 -1
  101. package/dist/src/ui/auth/AuthDialog.test.js +1 -0
  102. package/dist/src/ui/auth/AuthDialog.test.js.map +1 -1
  103. package/dist/src/ui/auth/AuthInProgress.js +2 -2
  104. package/dist/src/ui/auth/AuthInProgress.js.map +1 -1
  105. package/dist/src/ui/commands/chatCommand.js +21 -27
  106. package/dist/src/ui/commands/chatCommand.js.map +1 -1
  107. package/dist/src/ui/commands/extensionsCommand.js +39 -34
  108. package/dist/src/ui/commands/extensionsCommand.js.map +1 -1
  109. package/dist/src/ui/commands/mcpCommand.js +78 -260
  110. package/dist/src/ui/commands/mcpCommand.js.map +1 -1
  111. package/dist/src/ui/commands/memoryCommand.js +23 -5
  112. package/dist/src/ui/commands/memoryCommand.js.map +1 -1
  113. package/dist/src/ui/commands/modelCommand.d.ts +7 -0
  114. package/dist/src/ui/commands/modelCommand.js +16 -0
  115. package/dist/src/ui/commands/modelCommand.js.map +1 -0
  116. package/dist/src/ui/commands/modelCommand.test.js +30 -0
  117. package/dist/src/ui/commands/modelCommand.test.js.map +1 -0
  118. package/dist/src/ui/commands/permissionsCommand.d.ts +7 -0
  119. package/dist/src/ui/commands/permissionsCommand.js +16 -0
  120. package/dist/src/ui/commands/permissionsCommand.js.map +1 -0
  121. package/dist/src/ui/commands/permissionsCommand.test.d.ts +6 -0
  122. package/dist/src/ui/commands/permissionsCommand.test.js +30 -0
  123. package/dist/src/ui/commands/permissionsCommand.test.js.map +1 -0
  124. package/dist/src/ui/commands/profileCommand.d.ts +7 -0
  125. package/dist/src/ui/commands/profileCommand.js +23 -0
  126. package/dist/src/ui/commands/profileCommand.js.map +1 -0
  127. package/dist/src/ui/commands/setupGithubCommand.test.js +2 -1
  128. package/dist/src/ui/commands/setupGithubCommand.test.js.map +1 -1
  129. package/dist/src/ui/commands/toolsCommand.js +10 -24
  130. package/dist/src/ui/commands/toolsCommand.js.map +1 -1
  131. package/dist/src/ui/commands/types.d.ts +8 -6
  132. package/dist/src/ui/commands/types.js.map +1 -1
  133. package/dist/src/ui/components/AnsiOutput.d.ts +1 -0
  134. package/dist/src/ui/components/AnsiOutput.js +5 -5
  135. package/dist/src/ui/components/AnsiOutput.js.map +1 -1
  136. package/dist/src/ui/components/AnsiOutput.test.js +6 -6
  137. package/dist/src/ui/components/AnsiOutput.test.js.map +1 -1
  138. package/dist/src/ui/components/AppHeader.js +2 -5
  139. package/dist/src/ui/components/AppHeader.js.map +1 -1
  140. package/dist/src/ui/components/CliSpinner.d.ts +10 -0
  141. package/dist/src/ui/components/CliSpinner.js +20 -0
  142. package/dist/src/ui/components/CliSpinner.js.map +1 -0
  143. package/dist/src/ui/components/Composer.js +7 -29
  144. package/dist/src/ui/components/Composer.js.map +1 -1
  145. package/dist/src/ui/components/ConsentPrompt.d.ts +13 -0
  146. package/dist/src/ui/components/ConsentPrompt.js +19 -0
  147. package/dist/src/ui/components/ConsentPrompt.js.map +1 -0
  148. package/dist/src/ui/components/ConsentPrompt.test.d.ts +6 -0
  149. package/dist/src/ui/components/ConsentPrompt.test.js +67 -0
  150. package/dist/src/ui/components/ConsentPrompt.test.js.map +1 -0
  151. package/dist/src/ui/components/ContextSummaryDisplay.js +2 -2
  152. package/dist/src/ui/components/ContextSummaryDisplay.js.map +1 -1
  153. package/dist/src/ui/components/ContextUsageDisplay.d.ts +2 -1
  154. package/dist/src/ui/components/ContextUsageDisplay.js +4 -2
  155. package/dist/src/ui/components/ContextUsageDisplay.js.map +1 -1
  156. package/dist/src/ui/components/DebugProfiler.d.ts +18 -0
  157. package/dist/src/ui/components/DebugProfiler.js +158 -12
  158. package/dist/src/ui/components/DebugProfiler.js.map +1 -1
  159. package/dist/src/ui/components/DebugProfiler.test.d.ts +6 -0
  160. package/dist/src/ui/components/DebugProfiler.test.js +140 -0
  161. package/dist/src/ui/components/DebugProfiler.test.js.map +1 -0
  162. package/dist/src/ui/components/DialogManager.d.ts +7 -1
  163. package/dist/src/ui/components/DialogManager.js +18 -9
  164. package/dist/src/ui/components/DialogManager.js.map +1 -1
  165. package/dist/src/ui/components/EditorSettingsDialog.js +11 -2
  166. package/dist/src/ui/components/EditorSettingsDialog.js.map +1 -1
  167. package/dist/src/ui/components/ExitWarning.d.ts +7 -0
  168. package/dist/src/ui/components/ExitWarning.js +9 -0
  169. package/dist/src/ui/components/ExitWarning.js.map +1 -0
  170. package/dist/src/ui/components/FolderTrustDialog.js +3 -0
  171. package/dist/src/ui/components/FolderTrustDialog.js.map +1 -1
  172. package/dist/src/ui/components/FolderTrustDialog.test.js +2 -2
  173. package/dist/src/ui/components/FolderTrustDialog.test.js.map +1 -1
  174. package/dist/src/ui/components/Footer.d.ts +1 -19
  175. package/dist/src/ui/components/Footer.js +35 -17
  176. package/dist/src/ui/components/Footer.js.map +1 -1
  177. package/dist/src/ui/components/GeminiRespondingSpinner.js +2 -2
  178. package/dist/src/ui/components/GeminiRespondingSpinner.js.map +1 -1
  179. package/dist/src/ui/components/Help.js +1 -1
  180. package/dist/src/ui/components/Help.js.map +1 -1
  181. package/dist/src/ui/components/HistoryItemDisplay.d.ts +2 -1
  182. package/dist/src/ui/components/HistoryItemDisplay.js +10 -1
  183. package/dist/src/ui/components/HistoryItemDisplay.js.map +1 -1
  184. package/dist/src/ui/components/HistoryItemDisplay.test.js +90 -9
  185. package/dist/src/ui/components/HistoryItemDisplay.test.js.map +1 -1
  186. package/dist/src/ui/components/IdeTrustChangeDialog.d.ts +11 -0
  187. package/dist/src/ui/components/IdeTrustChangeDialog.js +32 -0
  188. package/dist/src/ui/components/IdeTrustChangeDialog.js.map +1 -0
  189. package/dist/src/ui/components/IdeTrustChangeDialog.test.d.ts +6 -0
  190. package/dist/src/ui/components/IdeTrustChangeDialog.test.js +57 -0
  191. package/dist/src/ui/components/IdeTrustChangeDialog.test.js.map +1 -0
  192. package/dist/src/ui/components/InputPrompt.d.ts +8 -2
  193. package/dist/src/ui/components/InputPrompt.js +66 -32
  194. package/dist/src/ui/components/InputPrompt.js.map +1 -1
  195. package/dist/src/ui/components/LoadingIndicator.js +1 -1
  196. package/dist/src/ui/components/LoadingIndicator.js.map +1 -1
  197. package/dist/src/ui/components/LoadingIndicator.test.js +4 -0
  198. package/dist/src/ui/components/LoadingIndicator.test.js.map +1 -1
  199. package/dist/src/ui/components/LoopDetectionConfirmation.js +2 -0
  200. package/dist/src/ui/components/LoopDetectionConfirmation.js.map +1 -1
  201. package/dist/src/ui/components/MainContent.js +7 -2
  202. package/dist/src/ui/components/MainContent.js.map +1 -1
  203. package/dist/src/ui/components/ModelDialog.d.ts +11 -0
  204. package/dist/src/ui/components/ModelDialog.js +57 -0
  205. package/dist/src/ui/components/ModelDialog.js.map +1 -0
  206. package/dist/src/ui/components/ModelDialog.test.d.ts +6 -0
  207. package/dist/src/ui/components/ModelDialog.test.js +153 -0
  208. package/dist/src/ui/components/ModelDialog.test.js.map +1 -0
  209. package/dist/src/ui/components/Notifications.js +12 -4
  210. package/dist/src/ui/components/Notifications.js.map +1 -1
  211. package/dist/src/ui/components/PermissionsModifyTrustDialog.d.ts +13 -0
  212. package/dist/src/ui/components/PermissionsModifyTrustDialog.js +48 -0
  213. package/dist/src/ui/components/PermissionsModifyTrustDialog.js.map +1 -0
  214. package/dist/src/ui/components/PermissionsModifyTrustDialog.test.d.ts +6 -0
  215. package/dist/src/ui/components/PermissionsModifyTrustDialog.test.js +154 -0
  216. package/dist/src/ui/components/PermissionsModifyTrustDialog.test.js.map +1 -0
  217. package/dist/src/ui/components/ProQuotaDialog.js +2 -0
  218. package/dist/src/ui/components/ProQuotaDialog.js.map +1 -1
  219. package/dist/src/ui/components/ProQuotaDialog.test.js +2 -0
  220. package/dist/src/ui/components/ProQuotaDialog.test.js.map +1 -1
  221. package/dist/src/ui/components/SettingsDialog.js +6 -3
  222. package/dist/src/ui/components/SettingsDialog.js.map +1 -1
  223. package/dist/src/ui/components/SettingsDialog.test.js +47 -13
  224. package/dist/src/ui/components/SettingsDialog.test.js.map +1 -1
  225. package/dist/src/ui/components/ShellConfirmationDialog.js +3 -0
  226. package/dist/src/ui/components/ShellConfirmationDialog.js.map +1 -1
  227. package/dist/src/ui/components/ThemeDialog.js +2 -0
  228. package/dist/src/ui/components/ThemeDialog.js.map +1 -1
  229. package/dist/src/ui/components/WorkspaceMigrationDialog.d.ts +2 -2
  230. package/dist/src/ui/components/WorkspaceMigrationDialog.js +7 -5
  231. package/dist/src/ui/components/WorkspaceMigrationDialog.js.map +1 -1
  232. package/dist/src/ui/components/messages/CompressionMessage.js +2 -2
  233. package/dist/src/ui/components/messages/CompressionMessage.js.map +1 -1
  234. package/dist/src/ui/components/messages/ToolConfirmationMessage.js +15 -1
  235. package/dist/src/ui/components/messages/ToolConfirmationMessage.js.map +1 -1
  236. package/dist/src/ui/components/messages/ToolGroupMessage.d.ts +1 -1
  237. package/dist/src/ui/components/messages/ToolGroupMessage.js +5 -5
  238. package/dist/src/ui/components/messages/ToolGroupMessage.js.map +1 -1
  239. package/dist/src/ui/components/messages/ToolMessage.d.ts +1 -1
  240. package/dist/src/ui/components/messages/ToolMessage.js +28 -5
  241. package/dist/src/ui/components/messages/ToolMessage.js.map +1 -1
  242. package/dist/src/ui/components/messages/UserMessage.js +1 -2
  243. package/dist/src/ui/components/messages/UserMessage.js.map +1 -1
  244. package/dist/src/ui/components/shared/BaseSelectionList.d.ts +38 -0
  245. package/dist/src/ui/components/shared/BaseSelectionList.js +72 -0
  246. package/dist/src/ui/components/shared/BaseSelectionList.js.map +1 -0
  247. package/dist/src/ui/components/shared/BaseSelectionList.test.d.ts +6 -0
  248. package/dist/src/ui/components/shared/BaseSelectionList.test.js +376 -0
  249. package/dist/src/ui/components/shared/BaseSelectionList.test.js.map +1 -0
  250. package/dist/src/ui/components/shared/DescriptiveRadioButtonSelect.d.ts +35 -0
  251. package/dist/src/ui/components/shared/DescriptiveRadioButtonSelect.js +13 -0
  252. package/dist/src/ui/components/shared/DescriptiveRadioButtonSelect.js.map +1 -0
  253. package/dist/src/ui/components/shared/DescriptiveRadioButtonSelect.test.d.ts +6 -0
  254. package/dist/src/ui/components/shared/DescriptiveRadioButtonSelect.test.js +79 -0
  255. package/dist/src/ui/components/shared/DescriptiveRadioButtonSelect.test.js.map +1 -0
  256. package/dist/src/ui/components/shared/RadioButtonSelect.d.ts +2 -3
  257. package/dist/src/ui/components/shared/RadioButtonSelect.js +9 -104
  258. package/dist/src/ui/components/shared/RadioButtonSelect.js.map +1 -1
  259. package/dist/src/ui/components/shared/RadioButtonSelect.test.js +115 -92
  260. package/dist/src/ui/components/shared/RadioButtonSelect.test.js.map +1 -1
  261. package/dist/src/ui/components/shared/ScopeSelector.js +4 -1
  262. package/dist/src/ui/components/shared/ScopeSelector.js.map +1 -1
  263. package/dist/src/ui/components/views/ChatList.d.ts +12 -0
  264. package/dist/src/ui/components/views/ChatList.js +17 -0
  265. package/dist/src/ui/components/views/ChatList.js.map +1 -0
  266. package/dist/src/ui/components/views/ChatList.test.d.ts +6 -0
  267. package/dist/src/ui/components/views/ChatList.test.js +42 -0
  268. package/dist/src/ui/components/views/ChatList.test.js.map +1 -0
  269. package/dist/src/ui/components/views/ExtensionsList.test.js +1 -1
  270. package/dist/src/ui/components/views/ExtensionsList.test.js.map +1 -1
  271. package/dist/src/ui/components/views/McpStatus.d.ts +27 -0
  272. package/dist/src/ui/components/views/McpStatus.js +77 -0
  273. package/dist/src/ui/components/views/McpStatus.js.map +1 -0
  274. package/dist/src/ui/components/views/McpStatus.test.d.ts +6 -0
  275. package/dist/src/ui/components/views/McpStatus.test.js +117 -0
  276. package/dist/src/ui/components/views/McpStatus.test.js.map +1 -0
  277. package/dist/src/ui/components/views/ToolsList.d.ts +14 -0
  278. package/dist/src/ui/components/views/ToolsList.js +7 -0
  279. package/dist/src/ui/components/views/ToolsList.js.map +1 -0
  280. package/dist/src/ui/components/views/ToolsList.test.d.ts +6 -0
  281. package/dist/src/ui/components/views/ToolsList.test.js +45 -0
  282. package/dist/src/ui/components/views/ToolsList.test.js.map +1 -0
  283. package/dist/src/ui/contexts/KeypressContext.js +3 -0
  284. package/dist/src/ui/contexts/KeypressContext.js.map +1 -1
  285. package/dist/src/ui/contexts/ShellFocusContext.d.ts +7 -0
  286. package/dist/src/ui/contexts/ShellFocusContext.js +9 -0
  287. package/dist/src/ui/contexts/ShellFocusContext.js.map +1 -0
  288. package/dist/src/ui/contexts/UIActionsContext.d.ts +2 -0
  289. package/dist/src/ui/contexts/UIActionsContext.js.map +1 -1
  290. package/dist/src/ui/contexts/UIStateContext.d.ts +11 -2
  291. package/dist/src/ui/contexts/UIStateContext.js +2 -0
  292. package/dist/src/ui/contexts/UIStateContext.js.map +1 -1
  293. package/dist/src/ui/hooks/shellCommandProcessor.js +5 -6
  294. package/dist/src/ui/hooks/shellCommandProcessor.js.map +1 -1
  295. package/dist/src/ui/hooks/shellCommandProcessor.test.js +19 -32
  296. package/dist/src/ui/hooks/shellCommandProcessor.test.js.map +1 -1
  297. package/dist/src/ui/hooks/slashCommandProcessor.d.ts +8 -5
  298. package/dist/src/ui/hooks/slashCommandProcessor.js +11 -2
  299. package/dist/src/ui/hooks/slashCommandProcessor.js.map +1 -1
  300. package/dist/src/ui/hooks/useExtensionUpdates.d.ts +10 -1
  301. package/dist/src/ui/hooks/useExtensionUpdates.js +140 -38
  302. package/dist/src/ui/hooks/useExtensionUpdates.js.map +1 -1
  303. package/dist/src/ui/hooks/useExtensionUpdates.test.js +163 -84
  304. package/dist/src/ui/hooks/useExtensionUpdates.test.js.map +1 -1
  305. package/dist/src/ui/hooks/useFlickerDetector.d.ts +14 -0
  306. package/dist/src/ui/hooks/useFlickerDetector.js +37 -0
  307. package/dist/src/ui/hooks/useFlickerDetector.js.map +1 -0
  308. package/dist/src/ui/hooks/useFlickerDetector.test.d.ts +6 -0
  309. package/dist/src/ui/hooks/useFlickerDetector.test.js +102 -0
  310. package/dist/src/ui/hooks/useFlickerDetector.test.js.map +1 -0
  311. package/dist/src/ui/hooks/useFocus.js +10 -0
  312. package/dist/src/ui/hooks/useFocus.js.map +1 -1
  313. package/dist/src/ui/hooks/useFolderTrust.d.ts +2 -1
  314. package/dist/src/ui/hooks/useFolderTrust.js +13 -9
  315. package/dist/src/ui/hooks/useFolderTrust.js.map +1 -1
  316. package/dist/src/ui/hooks/useGeminiStream.js +38 -3
  317. package/dist/src/ui/hooks/useGeminiStream.js.map +1 -1
  318. package/dist/src/ui/hooks/useGitBranchName.test.js.map +1 -1
  319. package/dist/src/ui/hooks/useHistoryManager.js +3 -3
  320. package/dist/src/ui/hooks/useHistoryManager.js.map +1 -1
  321. package/dist/src/ui/hooks/useIdeTrustListener.d.ts +4 -2
  322. package/dist/src/ui/hooks/useIdeTrustListener.js +40 -14
  323. package/dist/src/ui/hooks/useIdeTrustListener.js.map +1 -1
  324. package/dist/src/ui/hooks/useIdeTrustListener.test.d.ts +6 -0
  325. package/dist/src/ui/hooks/useIdeTrustListener.test.js +183 -0
  326. package/dist/src/ui/hooks/useIdeTrustListener.test.js.map +1 -0
  327. package/dist/src/ui/hooks/useModelCommand.d.ts +12 -0
  328. package/dist/src/ui/hooks/useModelCommand.js +21 -0
  329. package/dist/src/ui/hooks/useModelCommand.js.map +1 -0
  330. package/dist/src/ui/hooks/useModelCommand.test.d.ts +6 -0
  331. package/dist/src/ui/hooks/useModelCommand.test.js +35 -0
  332. package/dist/src/ui/hooks/useModelCommand.test.js.map +1 -0
  333. package/dist/src/ui/hooks/usePermissionsModifyTrust.d.ts +17 -0
  334. package/dist/src/ui/hooks/usePermissionsModifyTrust.js +78 -0
  335. package/dist/src/ui/hooks/usePermissionsModifyTrust.js.map +1 -0
  336. package/dist/src/ui/hooks/usePermissionsModifyTrust.test.d.ts +6 -0
  337. package/dist/src/ui/hooks/usePermissionsModifyTrust.test.js +182 -0
  338. package/dist/src/ui/hooks/usePermissionsModifyTrust.test.js.map +1 -0
  339. package/dist/src/ui/hooks/usePhraseCycler.js +1 -0
  340. package/dist/src/ui/hooks/usePhraseCycler.js.map +1 -1
  341. package/dist/src/ui/hooks/useQuotaAndFallback.js +3 -17
  342. package/dist/src/ui/hooks/useQuotaAndFallback.js.map +1 -1
  343. package/dist/src/ui/hooks/useQuotaAndFallback.test.js +13 -43
  344. package/dist/src/ui/hooks/useQuotaAndFallback.test.js.map +1 -1
  345. package/dist/src/ui/hooks/useSelectionList.d.ts +34 -0
  346. package/dist/src/ui/hooks/useSelectionList.js +272 -0
  347. package/dist/src/ui/hooks/useSelectionList.js.map +1 -0
  348. package/dist/src/ui/hooks/useSelectionList.test.d.ts +6 -0
  349. package/dist/src/ui/hooks/useSelectionList.test.js +725 -0
  350. package/dist/src/ui/hooks/useSelectionList.test.js.map +1 -0
  351. package/dist/src/ui/hooks/useShellHistory.test.js +12 -8
  352. package/dist/src/ui/hooks/useShellHistory.test.js.map +1 -1
  353. package/dist/src/ui/hooks/useSlashCompletion.js +7 -2
  354. package/dist/src/ui/hooks/useSlashCompletion.js.map +1 -1
  355. package/dist/src/ui/hooks/useSlashCompletion.test.js +33 -0
  356. package/dist/src/ui/hooks/useSlashCompletion.test.js.map +1 -1
  357. package/dist/src/ui/hooks/useTerminalSize.js +2 -3
  358. package/dist/src/ui/hooks/useTerminalSize.js.map +1 -1
  359. package/dist/src/ui/hooks/useToolScheduler.test.js +2 -2
  360. package/dist/src/ui/hooks/useToolScheduler.test.js.map +1 -1
  361. package/dist/src/ui/hooks/useWorkspaceMigration.d.ts +2 -2
  362. package/dist/src/ui/hooks/useWorkspaceMigration.js +13 -8
  363. package/dist/src/ui/hooks/useWorkspaceMigration.js.map +1 -1
  364. package/dist/src/ui/layouts/DefaultAppLayout.d.ts +7 -0
  365. package/dist/src/ui/layouts/DefaultAppLayout.js +16 -0
  366. package/dist/src/ui/layouts/DefaultAppLayout.js.map +1 -0
  367. package/dist/src/ui/layouts/ScreenReaderAppLayout.d.ts +7 -0
  368. package/dist/src/ui/layouts/ScreenReaderAppLayout.js +17 -0
  369. package/dist/src/ui/layouts/ScreenReaderAppLayout.js.map +1 -0
  370. package/dist/src/ui/noninteractive/nonInteractiveUi.js +3 -1
  371. package/dist/src/ui/noninteractive/nonInteractiveUi.js.map +1 -1
  372. package/dist/src/ui/privacy/CloudFreePrivacyNotice.js +5 -5
  373. package/dist/src/ui/privacy/CloudFreePrivacyNotice.js.map +1 -1
  374. package/dist/src/ui/state/extensions.d.ts +47 -1
  375. package/dist/src/ui/state/extensions.js +68 -1
  376. package/dist/src/ui/state/extensions.js.map +1 -1
  377. package/dist/src/ui/themes/theme.js +2 -2
  378. package/dist/src/ui/themes/theme.js.map +1 -1
  379. package/dist/src/ui/types.d.ts +54 -3
  380. package/dist/src/ui/types.js +3 -0
  381. package/dist/src/ui/types.js.map +1 -1
  382. package/dist/src/ui/utils/MarkdownDisplay.js +1 -2
  383. package/dist/src/ui/utils/MarkdownDisplay.js.map +1 -1
  384. package/dist/src/ui/utils/MarkdownDisplay.test.js +94 -91
  385. package/dist/src/ui/utils/MarkdownDisplay.test.js.map +1 -1
  386. package/dist/src/ui/utils/displayUtils.d.ts +1 -0
  387. package/dist/src/ui/utils/displayUtils.js +4 -1
  388. package/dist/src/ui/utils/displayUtils.js.map +1 -1
  389. package/dist/src/ui/utils/displayUtils.test.js +36 -17
  390. package/dist/src/ui/utils/displayUtils.test.js.map +1 -1
  391. package/dist/src/ui/utils/textUtils.d.ts +1 -0
  392. package/dist/src/ui/utils/textUtils.js +56 -0
  393. package/dist/src/ui/utils/textUtils.js.map +1 -1
  394. package/dist/src/ui/utils/textUtils.test.d.ts +6 -0
  395. package/dist/src/ui/utils/textUtils.test.js +132 -0
  396. package/dist/src/ui/utils/textUtils.test.js.map +1 -0
  397. package/dist/src/ui/utils/ui-sizing.d.ts +7 -0
  398. package/dist/src/ui/utils/ui-sizing.js +23 -0
  399. package/dist/src/ui/utils/ui-sizing.js.map +1 -0
  400. package/dist/src/utils/commentJson.js +95 -13
  401. package/dist/src/utils/commentJson.js.map +1 -1
  402. package/dist/src/utils/commentJson.test.js +161 -0
  403. package/dist/src/utils/commentJson.test.js.map +1 -1
  404. package/dist/src/utils/deepMerge.d.ts +2 -3
  405. package/dist/src/utils/errors.d.ts +8 -3
  406. package/dist/src/utils/errors.js +23 -13
  407. package/dist/src/utils/errors.js.map +1 -1
  408. package/dist/src/utils/errors.test.js +40 -46
  409. package/dist/src/utils/errors.test.js.map +1 -1
  410. package/dist/src/utils/events.d.ts +2 -1
  411. package/dist/src/utils/events.js +1 -0
  412. package/dist/src/utils/events.js.map +1 -1
  413. package/dist/src/utils/handleAutoUpdate.js +4 -1
  414. package/dist/src/utils/handleAutoUpdate.js.map +1 -1
  415. package/dist/src/utils/installationInfo.d.ts +1 -0
  416. package/dist/src/utils/installationInfo.js +2 -0
  417. package/dist/src/utils/installationInfo.js.map +1 -1
  418. package/dist/src/utils/math.d.ts +13 -0
  419. package/dist/src/utils/math.js +14 -0
  420. package/dist/src/utils/math.js.map +1 -0
  421. package/dist/src/utils/relaunch.d.ts +7 -0
  422. package/dist/src/utils/relaunch.js +57 -0
  423. package/dist/src/utils/relaunch.js.map +1 -0
  424. package/dist/src/utils/relaunch.test.d.ts +6 -0
  425. package/dist/src/utils/relaunch.test.js +273 -0
  426. package/dist/src/utils/relaunch.test.js.map +1 -0
  427. package/dist/src/utils/sandbox.js +31 -17
  428. package/dist/src/utils/sandbox.js.map +1 -1
  429. package/dist/src/utils/sessionCleanup.d.ts +22 -0
  430. package/dist/src/utils/sessionCleanup.integration.test.d.ts +6 -0
  431. package/dist/src/utils/sessionCleanup.integration.test.js +182 -0
  432. package/dist/src/utils/sessionCleanup.integration.test.js.map +1 -0
  433. package/dist/src/utils/sessionCleanup.js +214 -0
  434. package/dist/src/utils/sessionCleanup.js.map +1 -0
  435. package/dist/src/utils/sessionCleanup.test.d.ts +6 -0
  436. package/dist/src/utils/sessionCleanup.test.js +1232 -0
  437. package/dist/src/utils/sessionCleanup.test.js.map +1 -0
  438. package/dist/src/utils/sessionUtils.d.ts +37 -0
  439. package/dist/src/utils/sessionUtils.js +71 -0
  440. package/dist/src/utils/sessionUtils.js.map +1 -0
  441. package/dist/src/utils/windowTitle.d.ts +12 -0
  442. package/dist/src/utils/windowTitle.js +19 -0
  443. package/dist/src/utils/windowTitle.js.map +1 -0
  444. package/dist/src/utils/windowTitle.test.d.ts +6 -0
  445. package/dist/src/utils/windowTitle.test.js +49 -0
  446. package/dist/src/utils/windowTitle.test.js.map +1 -0
  447. package/dist/src/validateNonInterActiveAuth.js +6 -7
  448. package/dist/src/validateNonInterActiveAuth.js.map +1 -1
  449. package/dist/src/zed-integration/acp.js +1 -2
  450. package/dist/src/zed-integration/acp.js.map +1 -1
  451. package/dist/src/zed-integration/fileSystemService.d.ts +1 -0
  452. package/dist/src/zed-integration/fileSystemService.js +3 -0
  453. package/dist/src/zed-integration/fileSystemService.js.map +1 -1
  454. package/dist/src/zed-integration/schema.d.ts +70 -70
  455. package/dist/src/zed-integration/zedIntegration.d.ts +9 -3
  456. package/dist/src/zed-integration/zedIntegration.js +23 -28
  457. package/dist/src/zed-integration/zedIntegration.js.map +1 -1
  458. package/dist/tsconfig.tsbuildinfo +1 -1
  459. package/package.json +13 -5
  460. package/dist/src/commands/extensions/examples/mcp-server/example.js +0 -46
  461. package/dist/src/commands/extensions/examples/mcp-server/example.js.map +0 -1
  462. package/dist/src/ui/contexts/FocusContext.d.ts +0 -7
  463. package/dist/src/ui/contexts/FocusContext.js +0 -9
  464. package/dist/src/ui/contexts/FocusContext.js.map +0 -1
  465. /package/dist/src/{commands/extensions/examples/mcp-server/example.d.ts → ui/commands/modelCommand.test.d.ts} +0 -0
package/README.md CHANGED
@@ -7,16 +7,21 @@
7
7
 
8
8
  ![Gemini CLI Screenshot](./docs/assets/gemini-screenshot.png)
9
9
 
10
- Gemini CLI is an open-source AI agent that brings the power of Gemini directly into your terminal. It provides lightweight access to Gemini, giving you the most direct path from your prompt to our model.
10
+ Gemini CLI is an open-source AI agent that brings the power of Gemini directly
11
+ into your terminal. It provides lightweight access to Gemini, giving you the
12
+ most direct path from your prompt to our model.
11
13
 
12
14
  ## 🚀 Why Gemini CLI?
13
15
 
14
- - **🎯 Free tier**: 60 requests/min and 1,000 requests/day with personal Google account
15
- - **🧠 Powerful Gemini 2.5 Pro**: Access to 1M token context window
16
- - **🔧 Built-in tools**: Google Search grounding, file operations, shell commands, web fetching
17
- - **🔌 Extensible**: MCP (Model Context Protocol) support for custom integrations
18
- - **💻 Terminal-first**: Designed for developers who live in the command line
19
- - **🛡️ Open source**: Apache 2.0 licensed
16
+ - **🎯 Free tier**: 60 requests/min and 1,000 requests/day with personal Google
17
+ account.
18
+ - **🧠 Powerful Gemini 2.5 Pro**: Access to 1M token context window.
19
+ - **🔧 Built-in tools**: Google Search grounding, file operations, shell
20
+ commands, web fetching.
21
+ - **🔌 Extensible**: MCP (Model Context Protocol) support for custom
22
+ integrations.
23
+ - **💻 Terminal-first**: Designed for developers who live in the command line.
24
+ - **🛡️ Open source**: Apache 2.0 licensed.
20
25
 
21
26
  ## 📦 Installation
22
27
 
@@ -52,7 +57,9 @@ See [Releases](./docs/releases.md) for more details.
52
57
 
53
58
  ### Preview
54
59
 
55
- New preview releases will be published each week at UTC 2359 on Tuesdays. These releases will not have been fully vetted and may contain regressions or other outstanding issues. Please help us test and install with `preview` tag.
60
+ New preview releases will be published each week at UTC 2359 on Tuesdays. These
61
+ releases will not have been fully vetted and may contain regressions or other
62
+ outstanding issues. Please help us test and install with `preview` tag.
56
63
 
57
64
  ```bash
58
65
  npm install -g @google/gemini-cli@preview
@@ -60,7 +67,9 @@ npm install -g @google/gemini-cli@preview
60
67
 
61
68
  ### Stable
62
69
 
63
- - New stable releases will be published each week at UTC 2000 on Tuesdays, this will be the full promotion of last week's `preview` release + any bug fixes and validations. Use `latest` tag.
70
+ - New stable releases will be published each week at UTC 2000 on Tuesdays, this
71
+ will be the full promotion of last week's `preview` release + any bug fixes
72
+ and validations. Use `latest` tag.
64
73
 
65
74
  ```bash
66
75
  npm install -g @google/gemini-cli@latest
@@ -68,7 +77,9 @@ npm install -g @google/gemini-cli@latest
68
77
 
69
78
  ### Nightly
70
79
 
71
- - New releases will be published each week at UTC 0000 each day, This will be all changes from the main branch as represented at time of release. It should be assumed there are pending validations and issues. Use `nightly` tag.
80
+ - New releases will be published each week at UTC 0000 each day, This will be
81
+ all changes from the main branch as represented at time of release. It should
82
+ be assumed there are pending validations and issues. Use `nightly` tag.
72
83
 
73
84
  ```bash
74
85
  npm install -g @google/gemini-cli@nightly
@@ -84,24 +95,33 @@ npm install -g @google/gemini-cli@nightly
84
95
 
85
96
  ### Automation & Integration
86
97
 
87
- - Automate operational tasks like querying pull requests or handling complex rebases
88
- - Use MCP servers to connect new capabilities, including [media generation with Imagen, Veo or Lyria](https://github.com/GoogleCloudPlatform/vertex-ai-creative-studio/tree/main/experiments/mcp-genmedia)
98
+ - Automate operational tasks like querying pull requests or handling complex
99
+ rebases
100
+ - Use MCP servers to connect new capabilities, including
101
+ [media generation with Imagen, Veo or Lyria](https://github.com/GoogleCloudPlatform/vertex-ai-creative-studio/tree/main/experiments/mcp-genmedia)
89
102
  - Run non-interactively in scripts for workflow automation
90
103
 
91
104
  ### Advanced Capabilities
92
105
 
93
- - Ground your queries with built-in [Google Search](https://ai.google.dev/gemini-api/docs/grounding) for real-time information
106
+ - Ground your queries with built-in
107
+ [Google Search](https://ai.google.dev/gemini-api/docs/grounding) for real-time
108
+ information
94
109
  - Conversation checkpointing to save and resume complex sessions
95
110
  - Custom context files (GEMINI.md) to tailor behavior for your projects
96
111
 
97
112
  ### GitHub Integration
98
113
 
99
- Integrate Gemini CLI directly into your GitHub workflows with [**Gemini CLI GitHub Action**](https://github.com/google-github-actions/run-gemini-cli):
114
+ Integrate Gemini CLI directly into your GitHub workflows with
115
+ [**Gemini CLI GitHub Action**](https://github.com/google-github-actions/run-gemini-cli):
100
116
 
101
- - **Pull Request Reviews**: Automated code review with contextual feedback and suggestions
102
- - **Issue Triage**: Automated labeling and prioritization of GitHub issues based on content analysis
103
- - **On-demand Assistance**: Mention `@gemini-cli` in issues and pull requests for help with debugging, explanations, or task delegation
104
- - **Custom Workflows**: Build automated, scheduled and on-demand workflows tailored to your team's needs
117
+ - **Pull Request Reviews**: Automated code review with contextual feedback and
118
+ suggestions
119
+ - **Issue Triage**: Automated labeling and prioritization of GitHub issues based
120
+ on content analysis
121
+ - **On-demand Assistance**: Mention `@gemini-cli` in issues and pull requests
122
+ for help with debugging, explanations, or task delegation
123
+ - **Custom Workflows**: Build automated, scheduled and on-demand workflows
124
+ tailored to your team's needs
105
125
 
106
126
  ## 🔐 Authentication Options
107
127
 
@@ -109,7 +129,10 @@ Choose the authentication method that best fits your needs:
109
129
 
110
130
  ### Option 1: Login with Google (OAuth login using your Google Account)
111
131
 
112
- **✨ Best for:** Individual developers as well as anyone who has a Gemini Code Assist License. (see [quota limits and terms of service](https://cloud.google.com/gemini/docs/quotas) for details)
132
+ **✨ Best for:** Individual developers as well as anyone who has a Gemini Code
133
+ Assist License. (see
134
+ [quota limits and terms of service](https://cloud.google.com/gemini/docs/quotas)
135
+ for details)
113
136
 
114
137
  **Benefits:**
115
138
 
@@ -128,7 +151,7 @@ gemini
128
151
 
129
152
  ```bash
130
153
  # Set your Google Cloud Project
131
- export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_NAME"
154
+ export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
132
155
  gemini
133
156
  ```
134
157
 
@@ -165,7 +188,8 @@ export GOOGLE_GENAI_USE_VERTEXAI=true
165
188
  gemini
166
189
  ```
167
190
 
168
- For Google Workspace accounts and other authentication methods, see the [authentication guide](./docs/cli/authentication.md).
191
+ For Google Workspace accounts and other authentication methods, see the
192
+ [authentication guide](./docs/get-started/authentication.md).
169
193
 
170
194
  ## 🚀 Getting Started
171
195
 
@@ -227,17 +251,26 @@ gemini
227
251
 
228
252
  ### Getting Started
229
253
 
230
- - [**Quickstart Guide**](./docs/cli/index.md) - Get up and running quickly
231
- - [**Authentication Setup**](./docs/cli/authentication.md) - Detailed auth configuration
232
- - [**Configuration Guide**](./docs/cli/configuration.md) - Settings and customization
233
- - [**Keyboard Shortcuts**](./docs/keyboard-shortcuts.md) - Productivity tips
254
+ - [**Quickstart Guide**](./docs/get-started/index.md) - Get up and running
255
+ quickly.
256
+ - [**Authentication Setup**](./docs/get-started/authentication.md) - Detailed
257
+ auth configuration.
258
+ - [**Configuration Guide**](./docs/get-started/configuration.md) - Settings and
259
+ customization.
260
+ - [**Keyboard Shortcuts**](./docs/cli/keyboard-shortcuts.md) - Productivity
261
+ tips.
234
262
 
235
263
  ### Core Features
236
264
 
237
- - [**Commands Reference**](./docs/cli/commands.md) - All slash commands (`/help`, `/chat`, `/mcp`, etc.)
238
- - [**Checkpointing**](./docs/checkpointing.md) - Save and resume conversations
239
- - [**Memory Management**](./docs/tools/memory.md) - Using GEMINI.md context files
240
- - [**Token Caching**](./docs/cli/token-caching.md) - Optimize token usage
265
+ - [**Commands Reference**](./docs/cli/commands.md) - All slash commands
266
+ (`/help`, `/chat`, etc).
267
+ - [**Custom Commands**](./docs/cli/custom-commands.md) - Create your own
268
+ reusable commands.
269
+ - [**Context Files (GEMINI.md)**](./docs/cli/gemini-md.md) - Provide persistent
270
+ context to Gemini CLI.
271
+ - [**Checkpointing**](./docs/cli/checkpointing.md) - Save and resume
272
+ conversations.
273
+ - [**Token Caching**](./docs/cli/token-caching.md) - Optimize token usage.
241
274
 
242
275
  ### Tools & Extensions
243
276
 
@@ -245,35 +278,37 @@ gemini
245
278
  - [File System Operations](./docs/tools/file-system.md)
246
279
  - [Shell Commands](./docs/tools/shell.md)
247
280
  - [Web Fetch & Search](./docs/tools/web-fetch.md)
248
- - [Multi-file Operations](./docs/tools/multi-file.md)
249
- - [**MCP Server Integration**](./docs/tools/mcp-server.md) - Extend with custom tools
250
- - [**Custom Extensions**](./docs/extension.md) - Build your own commands
281
+ - [**MCP Server Integration**](./docs/tools/mcp-server.md) - Extend with custom
282
+ tools.
283
+ - [**Custom Extensions**](./docs/extensions/index.md) - Build and share your own
284
+ commands.
251
285
 
252
286
  ### Advanced Topics
253
287
 
254
- - [**Architecture Overview**](./docs/architecture.md) - How Gemini CLI works
255
- - [**IDE Integration**](./docs/ide-integration.md) - VS Code companion
256
- - [**Sandboxing & Security**](./docs/sandbox.md) - Safe execution environments
257
- - [**Enterprise Deployment**](./docs/deployment.md) - Docker, system-wide config
258
- - [**Telemetry & Monitoring**](./docs/telemetry.md) - Usage tracking
259
- - [**Tools API Development**](./docs/core/tools-api.md) - Create custom tools
260
-
261
- ### Configuration & Customization
262
-
263
- - [**Settings Reference**](./docs/cli/configuration.md) - All configuration options
264
- - [**Theme Customization**](./docs/cli/themes.md) - Visual customization
265
- - [**.gemini Directory**](./docs/gemini-ignore.md) - Project-specific settings
266
- - [**Environment Variables**](./docs/cli/configuration.md#environment-variables)
288
+ - [**Headless Mode (Scripting)**](./docs/cli/headless.md) - Use Gemini CLI in
289
+ automated workflows.
290
+ - [**Architecture Overview**](./docs/architecture.md) - How Gemini CLI works.
291
+ - [**IDE Integration**](./docs/ide-integration/index.md) - VS Code companion.
292
+ - [**Sandboxing & Security**](./docs/cli/sandbox.md) - Safe execution
293
+ environments.
294
+ - [**Trusted Folders**](./docs/cli/trusted-folders.md) - Control execution
295
+ policies by folder.
296
+ - [**Enterprise Guide**](./docs/cli/enterprise.md) - Deploy and manage in a
297
+ corporate environment.
298
+ - [**Telemetry & Monitoring**](./docs/cli/telemetry.md) - Usage tracking.
299
+ - [**Tools API Development**](./docs/core/tools-api.md) - Create custom tools.
267
300
 
268
301
  ### Troubleshooting & Support
269
302
 
270
- - [**Troubleshooting Guide**](./docs/troubleshooting.md) - Common issues and solutions
271
- - [**FAQ**](./docs/troubleshooting.md#frequently-asked-questions) - Quick answers
272
- - Use `/bug` command to report issues directly from the CLI
303
+ - [**Troubleshooting Guide**](./docs/troubleshooting.md) - Common issues and
304
+ solutions.
305
+ - [**FAQ**](./docs/faq.md) - Frequently asked questions.
306
+ - Use `/bug` command to report issues directly from the CLI.
273
307
 
274
308
  ### Using MCP Servers
275
309
 
276
- Configure MCP servers in `~/.gemini/settings.json` to extend Gemini CLI with custom tools:
310
+ Configure MCP servers in `~/.gemini/settings.json` to extend Gemini CLI with
311
+ custom tools:
277
312
 
278
313
  ```text
279
314
  > @github List my open pull requests
@@ -281,31 +316,39 @@ Configure MCP servers in `~/.gemini/settings.json` to extend Gemini CLI with cus
281
316
  > @database Run a query to find inactive users
282
317
  ```
283
318
 
284
- See the [MCP Server Integration guide](./docs/tools/mcp-server.md) for setup instructions.
319
+ See the [MCP Server Integration guide](./docs/tools/mcp-server.md) for setup
320
+ instructions.
285
321
 
286
322
  ## 🤝 Contributing
287
323
 
288
- We welcome contributions! Gemini CLI is fully open source (Apache 2.0), and we encourage the community to:
324
+ We welcome contributions! Gemini CLI is fully open source (Apache 2.0), and we
325
+ encourage the community to:
289
326
 
290
- - Report bugs and suggest features
291
- - Improve documentation
292
- - Submit code improvements
293
- - Share your MCP servers and extensions
327
+ - Report bugs and suggest features.
328
+ - Improve documentation.
329
+ - Submit code improvements.
330
+ - Share your MCP servers and extensions.
294
331
 
295
- See our [Contributing Guide](./CONTRIBUTING.md) for development setup, coding standards, and how to submit pull requests.
332
+ See our [Contributing Guide](./CONTRIBUTING.md) for development setup, coding
333
+ standards, and how to submit pull requests.
296
334
 
297
- Check our [Official Roadmap](https://github.com/orgs/google-gemini/projects/11/) for planned features and priorities.
335
+ Check our [Official Roadmap](https://github.com/orgs/google-gemini/projects/11)
336
+ for planned features and priorities.
298
337
 
299
338
  ## 📖 Resources
300
339
 
301
- - **[Official Roadmap](./ROADMAP.md)** - See what's coming next
302
- - **[NPM Package](https://www.npmjs.com/package/@google/gemini-cli)** - Package registry
303
- - **[GitHub Issues](https://github.com/google-gemini/gemini-cli/issues)** - Report bugs or request features
304
- - **[Security Advisories](https://github.com/google-gemini/gemini-cli/security/advisories)** - Security updates
340
+ - **[Official Roadmap](./ROADMAP.md)** - See what's coming next.
341
+ - **[Changelog](./docs/changelogs/index.md)** - See recent notable updates.
342
+ - **[NPM Package](https://www.npmjs.com/package/@google/gemini-cli)** - Package
343
+ registry.
344
+ - **[GitHub Issues](https://github.com/google-gemini/gemini-cli/issues)** -
345
+ Report bugs or request features.
346
+ - **[Security Advisories](https://github.com/google-gemini/gemini-cli/security/advisories)** -
347
+ Security updates.
305
348
 
306
349
  ### Uninstall
307
350
 
308
- See the [Uninstall Guide](docs/Uninstall.md) for removal instructions.
351
+ See the [Uninstall Guide](docs/cli/uninstall.md) for removal instructions.
309
352
 
310
353
  ## 📄 Legal
311
354
 
package/dist/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@google/gemini-cli",
3
- "version": "0.0.8999999",
3
+ "version": "0.0.77777773",
4
4
  "description": "Gemini CLI",
5
5
  "repository": {
6
6
  "type": "git",
@@ -18,14 +18,14 @@
18
18
  "lint": "eslint . --ext .ts,.tsx",
19
19
  "format": "prettier --write .",
20
20
  "test": "vitest run",
21
- "test:ci": "vitest run --coverage",
21
+ "test:ci": "vitest run",
22
22
  "typecheck": "tsc --noEmit"
23
23
  },
24
24
  "files": [
25
25
  "dist"
26
26
  ],
27
27
  "config": {
28
- "sandboxImageUri": "us-docker.pkg.dev/gemini-code-dev/gemini-cli/sandbox:0.0.8999999"
28
+ "sandboxImageUri": "us-docker.pkg.dev/gemini-code-dev/gemini-cli/sandbox:0.0.77777773"
29
29
  },
30
30
  "dependencies": {
31
31
  "@google/gemini-cli-core": "file:../core",
@@ -33,27 +33,32 @@
33
33
  "@iarna/toml": "^2.2.5",
34
34
  "@modelcontextprotocol/sdk": "^1.15.1",
35
35
  "@types/update-notifier": "^6.0.8",
36
+ "ansi-regex": "^6.2.2",
36
37
  "command-exists": "^1.2.9",
37
38
  "comment-json": "^4.2.5",
38
39
  "diff": "^7.0.0",
39
40
  "dotenv": "^17.1.0",
40
41
  "fzf": "^0.5.2",
41
- "glob": "^10.4.1",
42
+ "glob": "^10.4.5",
42
43
  "highlight.js": "^11.11.1",
43
44
  "ink": "^6.2.3",
44
45
  "ink-gradient": "^3.0.0",
45
46
  "ink-spinner": "^5.0.0",
46
47
  "lowlight": "^3.3.0",
48
+ "mnemonist": "^0.40.3",
47
49
  "open": "^10.1.2",
48
50
  "react": "^19.1.0",
49
51
  "read-package-up": "^11.0.0",
50
- "simple-git": "^3.28.0",
51
52
  "shell-quote": "^1.8.3",
53
+ "simple-git": "^3.28.0",
52
54
  "string-width": "^7.1.0",
53
55
  "strip-ansi": "^7.1.0",
54
56
  "strip-json-comments": "^3.1.1",
57
+ "tar": "^7.5.1",
55
58
  "undici": "^7.10.0",
59
+ "extract-zip": "^2.0.1",
56
60
  "update-notifier": "^7.3.1",
61
+ "wrap-ansi": "9.0.2",
57
62
  "yargs": "^17.7.2",
58
63
  "zod": "^3.23.8"
59
64
  },
@@ -61,6 +66,7 @@
61
66
  "@babel/runtime": "^7.27.6",
62
67
  "@google/gemini-cli-test-utils": "file:../test-utils",
63
68
  "@testing-library/react": "^16.3.0",
69
+ "@types/archiver": "^6.0.3",
64
70
  "@types/command-exists": "^1.2.3",
65
71
  "@types/diff": "^7.0.2",
66
72
  "@types/dotenv": "^6.1.1",
@@ -69,7 +75,9 @@
69
75
  "@types/react-dom": "^19.1.6",
70
76
  "@types/semver": "^7.7.0",
71
77
  "@types/shell-quote": "^1.7.5",
78
+ "@types/tar": "^6.1.13",
72
79
  "@types/yargs": "^17.0.32",
80
+ "archiver": "^7.0.1",
73
81
  "ink-testing-library": "^4.0.0",
74
82
  "jsdom": "^26.1.0",
75
83
  "pretty-format": "^30.0.2",
@@ -1,8 +1,14 @@
1
1
  # Ink Library Screen Reader Guidance
2
2
 
3
- When building custom components, it's important to keep accessibility in mind. While Ink provides the building blocks, ensuring your components are accessible will make your CLIs usable by a wider audience.
3
+ When building custom components, it's important to keep accessibility in mind.
4
+ While Ink provides the building blocks, ensuring your components are accessible
5
+ will make your CLIs usable by a wider audience.
4
6
 
5
7
  ## General Principles
6
8
 
7
- Provide screen reader-friendly output: Use the useIsScreenReaderEnabled hook to detect if a screen reader is active. You can then render a more descriptive output for screen reader users.
8
- Leverage ARIA props: For components that have a specific role (e.g., a checkbox or a button), use the aria-role, aria-state, and aria-label props on <Box> and <Text> to provide semantic meaning to screen readers.
9
+ Provide screen reader-friendly output: Use the useIsScreenReaderEnabled hook to
10
+ detect if a screen reader is active. You can then render a more descriptive
11
+ output for screen reader users. Leverage ARIA props: For components that have a
12
+ specific role (e.g., a checkbox or a button), use the aria-role, aria-state, and
13
+ aria-label props on <Box> and <Text> to provide semantic meaning to screen
14
+ readers.
@@ -1,5 +1,4 @@
1
1
  {
2
2
  "name": "context-example",
3
- "version": "1.0.0",
4
- "contextFileName": "GEMINI.md"
3
+ "version": "1.0.0"
5
4
  }
@@ -1,10 +1,11 @@
1
1
  {
2
- "name": "mcp-server",
2
+ "name": "mcp-server-example",
3
3
  "version": "1.0.0",
4
4
  "mcpServers": {
5
5
  "nodeServer": {
6
6
  "command": "node",
7
- "args": ["${extensionPath}${/}example.ts"]
7
+ "args": ["${extensionPath}${/}dist${/}example.js"],
8
+ "cwd": "${extensionPath}"
8
9
  }
9
10
  }
10
11
  }
@@ -0,0 +1,18 @@
1
+ {
2
+ "name": "mcp-server-example",
3
+ "version": "1.0.0",
4
+ "description": "Example MCP Server for Gemini CLI Extension",
5
+ "type": "module",
6
+ "main": "example.js",
7
+ "scripts": {
8
+ "build": "tsc"
9
+ },
10
+ "devDependencies": {
11
+ "typescript": "~5.4.5",
12
+ "@types/node": "^20.11.25"
13
+ },
14
+ "dependencies": {
15
+ "@modelcontextprotocol/sdk": "^1.11.0",
16
+ "zod": "^3.22.4"
17
+ }
18
+ }
@@ -0,0 +1,13 @@
1
+ {
2
+ "compilerOptions": {
3
+ "target": "ES2022",
4
+ "module": "NodeNext",
5
+ "moduleResolution": "NodeNext",
6
+ "strict": true,
7
+ "esModuleInterop": true,
8
+ "skipLibCheck": true,
9
+ "forceConsistentCasingInFileNames": true,
10
+ "outDir": "./dist"
11
+ },
12
+ "include": ["example.ts"]
13
+ }
@@ -5,10 +5,10 @@
5
5
  */
6
6
  import type { CommandModule } from 'yargs';
7
7
  interface InstallArgs {
8
- source?: string;
9
- path?: string;
8
+ source: string;
10
9
  ref?: string;
11
10
  autoUpdate?: boolean;
11
+ allowPreRelease?: boolean;
12
12
  }
13
13
  export declare function handleInstall(args: InstallArgs): Promise<void>;
14
14
  export declare const installCommand: CommandModule;
@@ -3,40 +3,41 @@
3
3
  * Copyright 2025 Google LLC
4
4
  * SPDX-License-Identifier: Apache-2.0
5
5
  */
6
- import { installExtension } from '../../config/extension.js';
6
+ import { installOrUpdateExtension, requestConsentNonInteractive, } from '../../config/extension.js';
7
7
  import { getErrorMessage } from '../../utils/errors.js';
8
+ import { stat } from 'node:fs/promises';
8
9
  export async function handleInstall(args) {
9
10
  try {
10
11
  let installMetadata;
11
- if (args.source) {
12
- const { source } = args;
13
- if (source.startsWith('http://') ||
14
- source.startsWith('https://') ||
15
- source.startsWith('git@') ||
16
- source.startsWith('sso://')) {
17
- installMetadata = {
18
- source,
19
- type: 'git',
20
- ref: args.ref,
21
- autoUpdate: args.autoUpdate,
22
- };
23
- }
24
- else {
25
- throw new Error(`The source "${source}" is not a valid URL format.`);
26
- }
27
- }
28
- else if (args.path) {
12
+ const { source } = args;
13
+ if (source.startsWith('http://') ||
14
+ source.startsWith('https://') ||
15
+ source.startsWith('git@') ||
16
+ source.startsWith('sso://')) {
29
17
  installMetadata = {
30
- source: args.path,
31
- type: 'local',
18
+ source,
19
+ type: 'git',
20
+ ref: args.ref,
32
21
  autoUpdate: args.autoUpdate,
22
+ allowPreRelease: args.allowPreRelease,
33
23
  };
34
24
  }
35
25
  else {
36
- // This should not be reached due to the yargs check.
37
- throw new Error('Either --source or --path must be provided.');
26
+ if (args.ref || args.autoUpdate) {
27
+ throw new Error('--ref and --auto-update are not applicable for local extensions.');
28
+ }
29
+ try {
30
+ await stat(source);
31
+ installMetadata = {
32
+ source,
33
+ type: 'local',
34
+ };
35
+ }
36
+ catch {
37
+ throw new Error('Install source not found.');
38
+ }
38
39
  }
39
- const name = await installExtension(installMetadata, true);
40
+ const name = await installOrUpdateExtension(installMetadata, requestConsentNonInteractive);
40
41
  console.log(`Extension "${name}" installed successfully and enabled.`);
41
42
  }
42
43
  catch (error) {
@@ -45,16 +46,13 @@ export async function handleInstall(args) {
45
46
  }
46
47
  }
47
48
  export const installCommand = {
48
- command: 'install [source]',
49
+ command: 'install <source> [--auto-update] [--pre-release]',
49
50
  describe: 'Installs an extension from a git repository URL or a local path.',
50
51
  builder: (yargs) => yargs
51
52
  .positional('source', {
52
- describe: 'The github URL of the extension to install.',
53
- type: 'string',
54
- })
55
- .option('path', {
56
- describe: 'Path to a local extension directory.',
53
+ describe: 'The github URL or local path of the extension to install.',
57
54
  type: 'string',
55
+ demandOption: true,
58
56
  })
59
57
  .option('ref', {
60
58
  describe: 'The git ref to install from.',
@@ -64,21 +62,22 @@ export const installCommand = {
64
62
  describe: 'Enable auto-update for this extension.',
65
63
  type: 'boolean',
66
64
  })
67
- .conflicts('source', 'path')
68
- .conflicts('path', 'ref')
69
- .conflicts('path', 'auto-update')
65
+ .option('pre-release', {
66
+ describe: 'Enable pre-release versions for this extension.',
67
+ type: 'boolean',
68
+ })
70
69
  .check((argv) => {
71
- if (!argv.source && !argv.path) {
72
- throw new Error('Either source or --path must be provided.');
70
+ if (!argv.source) {
71
+ throw new Error('The source argument must be provided.');
73
72
  }
74
73
  return true;
75
74
  }),
76
75
  handler: async (argv) => {
77
76
  await handleInstall({
78
77
  source: argv['source'],
79
- path: argv['path'],
80
78
  ref: argv['ref'],
81
79
  autoUpdate: argv['auto-update'],
80
+ allowPreRelease: argv['pre-release'],
82
81
  });
83
82
  },
84
83
  };
@@ -1 +1 @@
1
- {"version":3,"file":"install.js","sourceRoot":"","sources":["../../../../src/commands/extensions/install.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"install.js","sourceRoot":"","sources":["../../../../src/commands/extensions/install.ts"],"names":[],"mappings":"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"}