@google/gemini-cli-core 0.30.0-nightly.20260212.099aa9621 → 0.30.0-preview.0
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.
- package/README.md +3 -4
- package/dist/docs/CONTRIBUTING.md +7 -6
- package/dist/docs/admin/enterprise-controls.md +115 -0
- package/dist/docs/cli/checkpointing.md +2 -3
- package/dist/docs/cli/cli-reference.md +4 -5
- package/dist/docs/cli/commands.md +358 -325
- package/dist/docs/cli/custom-commands.md +3 -0
- package/dist/docs/cli/enterprise.md +1 -1
- package/dist/docs/cli/gemini-md.md +20 -12
- package/dist/docs/cli/headless.md +34 -372
- package/dist/docs/cli/index.md +111 -55
- package/dist/docs/cli/keyboard-shortcuts.md +41 -34
- package/dist/docs/cli/plan-mode.md +6 -2
- package/dist/docs/cli/rewind.md +11 -11
- package/dist/docs/cli/sandbox.md +3 -2
- package/dist/docs/cli/session-management.md +61 -44
- package/dist/docs/cli/settings.md +1 -0
- package/dist/docs/cli/skills.md +15 -8
- package/dist/docs/cli/telemetry.md +18 -4
- package/dist/docs/cli/themes.md +85 -51
- package/dist/docs/cli/tutorials/automation.md +187 -0
- package/dist/docs/cli/tutorials/file-management.md +142 -0
- package/dist/docs/cli/tutorials/mcp-setup.md +105 -0
- package/dist/docs/cli/tutorials/memory-management.md +126 -0
- package/dist/docs/cli/tutorials/session-management.md +105 -0
- package/dist/docs/cli/tutorials/shell-commands.md +107 -0
- package/dist/docs/cli/tutorials/skills-getting-started.md +36 -31
- package/dist/docs/cli/tutorials/task-planning.md +93 -0
- package/dist/docs/cli/tutorials/web-tools.md +78 -0
- package/dist/docs/core/concepts.md +137 -0
- package/dist/docs/core/policy-engine.md +4 -2
- package/dist/docs/extensions/best-practices.md +102 -53
- package/dist/docs/extensions/index.md +37 -21
- package/dist/docs/extensions/reference.md +148 -216
- package/dist/docs/extensions/releasing.md +93 -122
- package/dist/docs/extensions/writing-extensions.md +87 -76
- package/dist/docs/get-started/configuration.md +37 -5
- package/dist/docs/get-started/examples.md +39 -119
- package/dist/docs/get-started/index.md +6 -4
- package/dist/docs/get-started/installation.md +110 -77
- package/dist/docs/index.md +133 -108
- package/dist/docs/releases.md +2 -2
- package/dist/docs/sidebar.json +96 -60
- package/dist/docs/tools/activate-skill.md +43 -0
- package/dist/docs/tools/ask-user.md +1 -1
- package/dist/docs/tools/file-system.md +43 -133
- package/dist/docs/tools/index.md +92 -91
- package/dist/docs/tools/internal-docs.md +46 -0
- package/dist/docs/tools/mcp-server.md +2 -2
- package/dist/docs/tools/memory.md +21 -40
- package/dist/docs/tools/shell.md +39 -84
- package/dist/docs/tools/todos.md +22 -44
- package/dist/docs/tools/web-fetch.md +22 -46
- package/dist/docs/tools/web-search.md +19 -29
- package/dist/src/agents/codebase-investigator.js +5 -5
- package/dist/src/agents/codebase-investigator.js.map +1 -1
- package/dist/src/agents/local-executor.js +3 -1
- package/dist/src/agents/local-executor.js.map +1 -1
- package/dist/src/agents/local-executor.test.js +3 -2
- package/dist/src/agents/local-executor.test.js.map +1 -1
- package/dist/src/code_assist/codeAssist.js +1 -1
- package/dist/src/code_assist/codeAssist.js.map +1 -1
- package/dist/src/code_assist/codeAssist.test.js +2 -2
- package/dist/src/code_assist/codeAssist.test.js.map +1 -1
- package/dist/src/code_assist/oauth2.test.js +7 -0
- package/dist/src/code_assist/oauth2.test.js.map +1 -1
- package/dist/src/code_assist/server.d.ts +3 -2
- package/dist/src/code_assist/server.js +6 -2
- package/dist/src/code_assist/server.js.map +1 -1
- package/dist/src/code_assist/server.test.js +6 -5
- package/dist/src/code_assist/server.test.js.map +1 -1
- package/dist/src/code_assist/setup.d.ts +2 -1
- package/dist/src/code_assist/setup.js +2 -2
- package/dist/src/code_assist/setup.js.map +1 -1
- package/dist/src/code_assist/setup.test.js +13 -0
- package/dist/src/code_assist/setup.test.js.map +1 -1
- package/dist/src/config/config.d.ts +7 -1
- package/dist/src/config/config.js +19 -7
- package/dist/src/config/config.js.map +1 -1
- package/dist/src/config/config.test.js +9 -3
- package/dist/src/config/config.test.js.map +1 -1
- package/dist/src/config/defaultModelConfigs.js +13 -0
- package/dist/src/config/defaultModelConfigs.js.map +1 -1
- package/dist/src/config/models.d.ts +15 -0
- package/dist/src/config/models.js +22 -0
- package/dist/src/config/models.js.map +1 -1
- package/dist/src/config/models.test.js +38 -1
- package/dist/src/config/models.test.js.map +1 -1
- package/dist/src/config/storage.d.ts +3 -1
- package/dist/src/config/storage.js +12 -1
- package/dist/src/config/storage.js.map +1 -1
- package/dist/src/config/storage.test.js +12 -1
- package/dist/src/config/storage.test.js.map +1 -1
- package/dist/src/confirmation-bus/types.d.ts +3 -3
- package/dist/src/core/baseLlmClient.d.ts +9 -0
- package/dist/src/core/baseLlmClient.js +7 -6
- package/dist/src/core/baseLlmClient.js.map +1 -1
- package/dist/src/core/baseLlmClient.test.js +17 -6
- package/dist/src/core/baseLlmClient.test.js.map +1 -1
- package/dist/src/core/client.d.ts +2 -1
- package/dist/src/core/client.js +6 -3
- package/dist/src/core/client.js.map +1 -1
- package/dist/src/core/client.test.js +16 -14
- package/dist/src/core/client.test.js.map +1 -1
- package/dist/src/core/contentGenerator.d.ts +12 -2
- package/dist/src/core/contentGenerator.js +20 -0
- package/dist/src/core/contentGenerator.js.map +1 -1
- package/dist/src/core/coreToolScheduler.js +89 -66
- package/dist/src/core/coreToolScheduler.js.map +1 -1
- package/dist/src/core/coreToolScheduler.test.js +122 -55
- package/dist/src/core/coreToolScheduler.test.js.map +1 -1
- package/dist/src/core/fakeContentGenerator.d.ts +3 -2
- package/dist/src/core/fakeContentGenerator.js +6 -2
- package/dist/src/core/fakeContentGenerator.js.map +1 -1
- package/dist/src/core/fakeContentGenerator.test.js +8 -7
- package/dist/src/core/fakeContentGenerator.test.js.map +1 -1
- package/dist/src/core/geminiChat.d.ts +2 -1
- package/dist/src/core/geminiChat.js +6 -6
- package/dist/src/core/geminiChat.js.map +1 -1
- package/dist/src/core/geminiChat.test.js +54 -49
- package/dist/src/core/geminiChat.test.js.map +1 -1
- package/dist/src/core/geminiChat_network_retry.test.js +8 -7
- package/dist/src/core/geminiChat_network_retry.test.js.map +1 -1
- package/dist/src/core/loggingContentGenerator.d.ts +3 -2
- package/dist/src/core/loggingContentGenerator.js +19 -19
- package/dist/src/core/loggingContentGenerator.js.map +1 -1
- package/dist/src/core/loggingContentGenerator.test.js +9 -9
- package/dist/src/core/loggingContentGenerator.test.js.map +1 -1
- package/dist/src/core/prompts.test.js +9 -1
- package/dist/src/core/prompts.test.js.map +1 -1
- package/dist/src/core/recordingContentGenerator.d.ts +3 -2
- package/dist/src/core/recordingContentGenerator.js +4 -4
- package/dist/src/core/recordingContentGenerator.js.map +1 -1
- package/dist/src/core/recordingContentGenerator.test.js +5 -4
- package/dist/src/core/recordingContentGenerator.test.js.map +1 -1
- package/dist/src/core/turn.d.ts +2 -1
- package/dist/src/core/turn.js +3 -2
- package/dist/src/core/turn.js.map +1 -1
- package/dist/src/core/turn.test.js +2 -1
- package/dist/src/core/turn.test.js.map +1 -1
- package/dist/src/generated/git-commit.d.ts +2 -2
- package/dist/src/generated/git-commit.js +2 -2
- package/dist/src/generated/git-commit.js.map +1 -1
- package/dist/src/hooks/hookRunner.js +12 -18
- package/dist/src/hooks/hookRunner.js.map +1 -1
- package/dist/src/index.d.ts +6 -0
- package/dist/src/index.js +5 -0
- package/dist/src/index.js.map +1 -1
- package/dist/src/mcp/token-storage/hybrid-token-storage.js +4 -0
- package/dist/src/mcp/token-storage/hybrid-token-storage.js.map +1 -1
- package/dist/src/mcp/token-storage/hybrid-token-storage.test.js +12 -0
- package/dist/src/mcp/token-storage/hybrid-token-storage.test.js.map +1 -1
- package/dist/src/mcp/token-storage/keychain-token-storage.js +5 -0
- package/dist/src/mcp/token-storage/keychain-token-storage.js.map +1 -1
- package/dist/src/mcp/token-storage/keychain-token-storage.test.js +10 -5
- package/dist/src/mcp/token-storage/keychain-token-storage.test.js.map +1 -1
- package/dist/src/output/json-formatter.test.js +2 -0
- package/dist/src/output/json-formatter.test.js.map +1 -1
- package/dist/src/output/stream-json-formatter.test.js +4 -0
- package/dist/src/output/stream-json-formatter.test.js.map +1 -1
- package/dist/src/policy/config.d.ts +5 -3
- package/dist/src/policy/config.js +27 -12
- package/dist/src/policy/config.js.map +1 -1
- package/dist/src/policy/config.test.js +110 -6
- package/dist/src/policy/config.test.js.map +1 -1
- package/dist/src/policy/policies/plan.toml +1 -1
- package/dist/src/policy/policy-engine.js +3 -1
- package/dist/src/policy/policy-engine.js.map +1 -1
- package/dist/src/policy/policy-engine.test.js +105 -8
- package/dist/src/policy/policy-engine.test.js.map +1 -1
- package/dist/src/policy/toml-loader.d.ts +5 -5
- package/dist/src/policy/toml-loader.js +28 -18
- package/dist/src/policy/toml-loader.js.map +1 -1
- package/dist/src/policy/toml-loader.test.js +31 -8
- package/dist/src/policy/toml-loader.test.js.map +1 -1
- package/dist/src/policy/types.d.ts +1 -0
- package/dist/src/policy/types.js.map +1 -1
- package/dist/src/prompts/promptProvider.js +9 -11
- package/dist/src/prompts/promptProvider.js.map +1 -1
- package/dist/src/prompts/snippets.d.ts +0 -2
- package/dist/src/prompts/snippets.js +67 -96
- package/dist/src/prompts/snippets.js.map +1 -1
- package/dist/src/routing/strategies/classifierStrategy.js +2 -0
- package/dist/src/routing/strategies/classifierStrategy.js.map +1 -1
- package/dist/src/routing/strategies/numericalClassifierStrategy.js +2 -0
- package/dist/src/routing/strategies/numericalClassifierStrategy.js.map +1 -1
- package/dist/src/scheduler/confirmation.d.ts +1 -1
- package/dist/src/scheduler/confirmation.js +2 -1
- package/dist/src/scheduler/confirmation.js.map +1 -1
- package/dist/src/scheduler/confirmation.test.js +22 -37
- package/dist/src/scheduler/confirmation.test.js.map +1 -1
- package/dist/src/scheduler/scheduler.js +37 -26
- package/dist/src/scheduler/scheduler.js.map +1 -1
- package/dist/src/scheduler/scheduler.test.js +61 -45
- package/dist/src/scheduler/scheduler.test.js.map +1 -1
- package/dist/src/scheduler/state-manager.d.ts +7 -6
- package/dist/src/scheduler/state-manager.js +34 -24
- package/dist/src/scheduler/state-manager.js.map +1 -1
- package/dist/src/scheduler/state-manager.test.js +45 -41
- package/dist/src/scheduler/state-manager.test.js.map +1 -1
- package/dist/src/scheduler/tool-executor.js +5 -4
- package/dist/src/scheduler/tool-executor.js.map +1 -1
- package/dist/src/scheduler/tool-executor.test.js +14 -13
- package/dist/src/scheduler/tool-executor.test.js.map +1 -1
- package/dist/src/scheduler/tool-modifier.test.js +2 -1
- package/dist/src/scheduler/tool-modifier.test.js.map +1 -1
- package/dist/src/scheduler/types.d.ts +27 -7
- package/dist/src/scheduler/types.js +14 -0
- package/dist/src/scheduler/types.js.map +1 -1
- package/dist/src/services/chatCompressionService.js +3 -0
- package/dist/src/services/chatCompressionService.js.map +1 -1
- package/dist/src/services/chatRecordingService.test.js +6 -5
- package/dist/src/services/chatRecordingService.test.js.map +1 -1
- package/dist/src/services/loopDetectionService.js +18 -1
- package/dist/src/services/loopDetectionService.js.map +1 -1
- package/dist/src/services/loopDetectionService.test.js +14 -0
- package/dist/src/services/loopDetectionService.test.js.map +1 -1
- package/dist/src/services/modelConfigService.d.ts +1 -0
- package/dist/src/services/modelConfigService.js +13 -2
- package/dist/src/services/modelConfigService.js.map +1 -1
- package/dist/src/services/modelConfigService.test.js +59 -0
- package/dist/src/services/modelConfigService.test.js.map +1 -1
- package/dist/src/services/sessionSummaryService.js +2 -0
- package/dist/src/services/sessionSummaryService.js.map +1 -1
- package/dist/src/services/test-data/resolved-aliases-retry.golden.json +11 -0
- package/dist/src/services/test-data/resolved-aliases.golden.json +11 -0
- package/dist/src/skills/skillManager.d.ts +4 -0
- package/dist/src/skills/skillManager.js +6 -0
- package/dist/src/skills/skillManager.js.map +1 -1
- package/dist/src/telemetry/clearcut-logger/clearcut-logger.d.ts +6 -2
- package/dist/src/telemetry/clearcut-logger/clearcut-logger.js +52 -0
- package/dist/src/telemetry/clearcut-logger/clearcut-logger.js.map +1 -1
- package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js +74 -0
- package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js.map +1 -1
- package/dist/src/telemetry/clearcut-logger/event-metadata-key.d.ts +8 -1
- package/dist/src/telemetry/clearcut-logger/event-metadata-key.js +20 -1
- package/dist/src/telemetry/clearcut-logger/event-metadata-key.js.map +1 -1
- package/dist/src/telemetry/file-exporters.js +2 -1
- package/dist/src/telemetry/file-exporters.js.map +1 -1
- package/dist/src/telemetry/file-exporters.test.d.ts +6 -0
- package/dist/src/telemetry/file-exporters.test.js +142 -0
- package/dist/src/telemetry/file-exporters.test.js.map +1 -0
- package/dist/src/telemetry/index.d.ts +1 -0
- package/dist/src/telemetry/index.js +1 -0
- package/dist/src/telemetry/index.js.map +1 -1
- package/dist/src/telemetry/llmRole.d.ts +18 -0
- package/dist/src/telemetry/llmRole.js +20 -0
- package/dist/src/telemetry/llmRole.js.map +1 -0
- package/dist/src/telemetry/loggers.d.ts +3 -1
- package/dist/src/telemetry/loggers.js +25 -1
- package/dist/src/telemetry/loggers.js.map +1 -1
- package/dist/src/telemetry/loggers.test.circular.js +3 -2
- package/dist/src/telemetry/loggers.test.circular.js.map +1 -1
- package/dist/src/telemetry/loggers.test.js +93 -14
- package/dist/src/telemetry/loggers.test.js.map +1 -1
- package/dist/src/telemetry/metrics.d.ts +26 -1
- package/dist/src/telemetry/metrics.js +41 -0
- package/dist/src/telemetry/metrics.js.map +1 -1
- package/dist/src/telemetry/metrics.test.js +52 -1
- package/dist/src/telemetry/metrics.test.js.map +1 -1
- package/dist/src/telemetry/sdk.js +24 -0
- package/dist/src/telemetry/sdk.js.map +1 -1
- package/dist/src/telemetry/types.d.ts +36 -11
- package/dist/src/telemetry/types.js +77 -7
- package/dist/src/telemetry/types.js.map +1 -1
- package/dist/src/telemetry/uiTelemetry.d.ts +16 -0
- package/dist/src/telemetry/uiTelemetry.js +39 -0
- package/dist/src/telemetry/uiTelemetry.js.map +1 -1
- package/dist/src/telemetry/uiTelemetry.test.js +29 -0
- package/dist/src/telemetry/uiTelemetry.test.js.map +1 -1
- package/dist/src/tools/activate-skill.d.ts +1 -0
- package/dist/src/tools/activate-skill.js +9 -20
- package/dist/src/tools/activate-skill.js.map +1 -1
- package/dist/src/tools/ask-user.d.ts +6 -0
- package/dist/src/tools/ask-user.js +43 -60
- package/dist/src/tools/ask-user.js.map +1 -1
- package/dist/src/tools/ask-user.test.js +108 -11
- package/dist/src/tools/ask-user.test.js.map +1 -1
- package/dist/src/tools/definitions/base-declarations.d.ts +26 -0
- package/dist/src/tools/definitions/base-declarations.js +30 -0
- package/dist/src/tools/definitions/base-declarations.js.map +1 -0
- package/dist/src/tools/definitions/coreTools.d.ts +25 -18
- package/dist/src/tools/definitions/coreTools.js +113 -235
- package/dist/src/tools/definitions/coreTools.js.map +1 -1
- package/dist/src/tools/definitions/coreToolsModelSnapshots.test.js +27 -1
- package/dist/src/tools/definitions/coreToolsModelSnapshots.test.js.map +1 -1
- package/dist/src/tools/definitions/dynamic-declaration-helpers.d.ts +30 -0
- package/dist/src/tools/definitions/dynamic-declaration-helpers.js +135 -0
- package/dist/src/tools/definitions/dynamic-declaration-helpers.js.map +1 -0
- package/dist/src/tools/definitions/model-family-sets/default-legacy.d.ts +11 -0
- package/dist/src/tools/definitions/model-family-sets/default-legacy.js +575 -0
- package/dist/src/tools/definitions/model-family-sets/default-legacy.js.map +1 -0
- package/dist/src/tools/definitions/model-family-sets/gemini-3.d.ts +14 -0
- package/dist/src/tools/definitions/model-family-sets/gemini-3.js +578 -0
- package/dist/src/tools/definitions/model-family-sets/gemini-3.js.map +1 -0
- package/dist/src/tools/definitions/modelFamilyService.d.ts +14 -0
- package/dist/src/tools/definitions/modelFamilyService.js +29 -0
- package/dist/src/tools/definitions/modelFamilyService.js.map +1 -0
- package/dist/src/tools/definitions/types.d.ts +27 -0
- package/dist/src/tools/edit.d.ts +1 -0
- package/dist/src/tools/edit.js +9 -54
- package/dist/src/tools/edit.js.map +1 -1
- package/dist/src/tools/enter-plan-mode.d.ts +1 -0
- package/dist/src/tools/enter-plan-mode.js +6 -9
- package/dist/src/tools/enter-plan-mode.js.map +1 -1
- package/dist/src/tools/exit-plan-mode.d.ts +1 -0
- package/dist/src/tools/exit-plan-mode.js +8 -10
- package/dist/src/tools/exit-plan-mode.js.map +1 -1
- package/dist/src/tools/get-internal-docs.d.ts +1 -0
- package/dist/src/tools/get-internal-docs.js +6 -9
- package/dist/src/tools/get-internal-docs.js.map +1 -1
- package/dist/src/tools/glob.js +2 -2
- package/dist/src/tools/glob.js.map +1 -1
- package/dist/src/tools/memoryTool.d.ts +1 -0
- package/dist/src/tools/memoryTool.js +6 -20
- package/dist/src/tools/memoryTool.js.map +1 -1
- package/dist/src/tools/read-file.js +2 -2
- package/dist/src/tools/read-file.js.map +1 -1
- package/dist/src/tools/read-many-files.d.ts +1 -0
- package/dist/src/tools/read-many-files.js +6 -58
- package/dist/src/tools/read-many-files.js.map +1 -1
- package/dist/src/tools/ripGrep.d.ts +1 -0
- package/dist/src/tools/ripGrep.js +6 -62
- package/dist/src/tools/ripGrep.js.map +1 -1
- package/dist/src/tools/tool-names.d.ts +7 -14
- package/dist/src/tools/tool-names.js +10 -16
- package/dist/src/tools/tool-names.js.map +1 -1
- package/dist/src/tools/web-fetch.d.ts +1 -0
- package/dist/src/tools/web-fetch.js +10 -12
- package/dist/src/tools/web-fetch.js.map +1 -1
- package/dist/src/tools/web-search.d.ts +1 -0
- package/dist/src/tools/web-search.js +8 -11
- package/dist/src/tools/web-search.js.map +1 -1
- package/dist/src/tools/write-file.js +2 -2
- package/dist/src/tools/write-file.js.map +1 -1
- package/dist/src/tools/write-todos.d.ts +1 -30
- package/dist/src/tools/write-todos.js +5 -123
- package/dist/src/tools/write-todos.js.map +1 -1
- package/dist/src/utils/editCorrector.js +5 -0
- package/dist/src/utils/editCorrector.js.map +1 -1
- package/dist/src/utils/environmentContext.js +3 -1
- package/dist/src/utils/environmentContext.js.map +1 -1
- package/dist/src/utils/environmentContext.test.js +13 -0
- package/dist/src/utils/environmentContext.test.js.map +1 -1
- package/dist/src/utils/events.d.ts +20 -1
- package/dist/src/utils/events.js +13 -0
- package/dist/src/utils/events.js.map +1 -1
- package/dist/src/utils/fastAckHelper.d.ts +30 -0
- package/dist/src/utils/fastAckHelper.js +142 -0
- package/dist/src/utils/fastAckHelper.js.map +1 -0
- package/dist/src/utils/fastAckHelper.test.d.ts +6 -0
- package/dist/src/utils/fastAckHelper.test.js +115 -0
- package/dist/src/utils/fastAckHelper.test.js.map +1 -0
- package/dist/src/utils/getPty.js +3 -0
- package/dist/src/utils/getPty.js.map +1 -1
- package/dist/src/utils/headless.js +2 -2
- package/dist/src/utils/headless.js.map +1 -1
- package/dist/src/utils/headless.test.js +3 -3
- package/dist/src/utils/headless.test.js.map +1 -1
- package/dist/src/utils/llm-edit-fixer.js +2 -0
- package/dist/src/utils/llm-edit-fixer.js.map +1 -1
- package/dist/src/utils/nextSpeakerChecker.js +2 -0
- package/dist/src/utils/nextSpeakerChecker.js.map +1 -1
- package/dist/src/utils/paths.d.ts +10 -11
- package/dist/src/utils/paths.js +33 -34
- package/dist/src/utils/paths.js.map +1 -1
- package/dist/src/utils/paths.test.js +161 -118
- package/dist/src/utils/paths.test.js.map +1 -1
- package/dist/src/utils/summarizer.js +2 -1
- package/dist/src/utils/summarizer.js.map +1 -1
- package/dist/src/utils/tool-utils.d.ts +26 -0
- package/dist/src/utils/tool-utils.js +35 -0
- package/dist/src/utils/tool-utils.js.map +1 -1
- package/dist/src/utils/tool-utils.test.js +68 -2
- package/dist/src/utils/tool-utils.test.js.map +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +1 -1
- package/dist/docs/cli/authentication.md +0 -3
- package/dist/docs/cli/tutorials.md +0 -87
- package/dist/google-gemini-cli-core-0.30.0-nightly.20260210.a2174751d.tgz +0 -0
package/README.md
CHANGED
|
@@ -29,10 +29,9 @@ Learn all about Gemini CLI in our [documentation](https://geminicli.com/docs/).
|
|
|
29
29
|
|
|
30
30
|
## 📦 Installation
|
|
31
31
|
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
- macOS, Linux, or Windows
|
|
32
|
+
See
|
|
33
|
+
[Gemini CLI installation, execution, and releases](./docs/get-started/installation.md)
|
|
34
|
+
for recommended system specifications and a detailed installation guide.
|
|
36
35
|
|
|
37
36
|
### Quick Install
|
|
38
37
|
|
|
@@ -408,12 +408,13 @@ On macOS, `gemini` uses Seatbelt (`sandbox-exec`) under a `permissive-open`
|
|
|
408
408
|
profile (see `packages/cli/src/utils/sandbox-macos-permissive-open.sb`) that
|
|
409
409
|
restricts writes to the project folder but otherwise allows all other operations
|
|
410
410
|
and outbound network traffic ("open") by default. You can switch to a
|
|
411
|
-
`
|
|
412
|
-
`packages/cli/src/utils/sandbox-macos-
|
|
413
|
-
|
|
414
|
-
`SEATBELT_PROFILE=
|
|
415
|
-
Available built-in profiles are `
|
|
416
|
-
(see below for proxied
|
|
411
|
+
`strict-open` profile (see
|
|
412
|
+
`packages/cli/src/utils/sandbox-macos-strict-open.sb`) that restricts both reads
|
|
413
|
+
and writes to the working directory while allowing outbound network traffic by
|
|
414
|
+
setting `SEATBELT_PROFILE=strict-open` in your environment or `.env` file.
|
|
415
|
+
Available built-in profiles are `permissive-{open,proxied}`,
|
|
416
|
+
`restrictive-{open,proxied}`, and `strict-{open,proxied}` (see below for proxied
|
|
417
|
+
networking). You can also switch to a custom profile
|
|
417
418
|
`SEATBELT_PROFILE=<profile>` if you also create a file
|
|
418
419
|
`.gemini/sandbox-macos-<profile>.sb` under your project settings directory
|
|
419
420
|
`.gemini`.
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
# Enterprise Admin Controls
|
|
2
|
+
|
|
3
|
+
Gemini CLI empowers enterprise administrators to manage and enforce security
|
|
4
|
+
policies and configuration settings across their entire organization. Secure
|
|
5
|
+
defaults are enabled automatically for all enterprise users, but can be
|
|
6
|
+
customized via the [Management Console](https://goo.gle/manage-gemini-cli).
|
|
7
|
+
|
|
8
|
+
**Enterprise Admin Controls are enforced globally and cannot be overridden by
|
|
9
|
+
users locally**, ensuring a consistent security posture.
|
|
10
|
+
|
|
11
|
+
## Admin Controls vs. System Settings
|
|
12
|
+
|
|
13
|
+
While [System-wide settings](../cli/settings.md) act as convenient configuration
|
|
14
|
+
overrides, they can still be modified by users with sufficient privileges. In
|
|
15
|
+
contrast, admin controls are immutable at the local level, making them the
|
|
16
|
+
preferred method for enforcing policy.
|
|
17
|
+
|
|
18
|
+
## Available Controls
|
|
19
|
+
|
|
20
|
+
### Strict Mode
|
|
21
|
+
|
|
22
|
+
**Enabled/Disabled** | Default: enabled
|
|
23
|
+
|
|
24
|
+
If enabled, users will not be able to enter yolo mode.
|
|
25
|
+
|
|
26
|
+
### Extensions
|
|
27
|
+
|
|
28
|
+
**Enabled/Disabled** | Default: disabled
|
|
29
|
+
|
|
30
|
+
If disabled, users will not be able to use or install extensions. See
|
|
31
|
+
[Extensions](../extensions/index.md) for more details.
|
|
32
|
+
|
|
33
|
+
### MCP
|
|
34
|
+
|
|
35
|
+
#### Enabled/Disabled
|
|
36
|
+
|
|
37
|
+
**Enabled/Disabled** | Default: disabled
|
|
38
|
+
|
|
39
|
+
If disabled, users will not be able to use MCP servers. See
|
|
40
|
+
[MCP Server Integration](../tools/mcp-server.md) for more details.
|
|
41
|
+
|
|
42
|
+
#### MCP Servers (preview)
|
|
43
|
+
|
|
44
|
+
**Default**: empty
|
|
45
|
+
|
|
46
|
+
Allows administrators to define an explicit allowlist of MCP servers. This
|
|
47
|
+
guarantees that users can only connect to trusted MCP servers defined by the
|
|
48
|
+
organization.
|
|
49
|
+
|
|
50
|
+
**Allowlist Format:**
|
|
51
|
+
|
|
52
|
+
```json
|
|
53
|
+
{
|
|
54
|
+
"mcpServers": {
|
|
55
|
+
"external-provider": {
|
|
56
|
+
"url": "https://api.mcp-provider.com",
|
|
57
|
+
"type": "sse",
|
|
58
|
+
"trust": true,
|
|
59
|
+
"includeTools": ["toolA", "toolB"],
|
|
60
|
+
"excludeTools": []
|
|
61
|
+
},
|
|
62
|
+
"internal-corp-tool": {
|
|
63
|
+
"url": "https://mcp.internal-tool.corp",
|
|
64
|
+
"type": "http",
|
|
65
|
+
"includeTools": [],
|
|
66
|
+
"excludeTools": ["adminTool"]
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
**Supported Fields:**
|
|
73
|
+
|
|
74
|
+
- `url`: (Required) The full URL of the MCP server endpoint.
|
|
75
|
+
- `type`: (Required) The connection type (e.g., `sse` or `http`).
|
|
76
|
+
- `trust`: (Optional) If set to `true`, the server is trusted and tool execution
|
|
77
|
+
will not require user approval.
|
|
78
|
+
- `includeTools`: (Optional) An explicit list of tool names to allow. If
|
|
79
|
+
specified, only these tools will be available.
|
|
80
|
+
- `excludeTools`: (Optional) A list of tool names to hide. These tools will be
|
|
81
|
+
blocked.
|
|
82
|
+
|
|
83
|
+
**Client Enforcement Logic:**
|
|
84
|
+
|
|
85
|
+
- **Empty Allowlist**: If the admin allowlist is empty, the client uses the
|
|
86
|
+
user’s local configuration as is (unless the MCP toggle above is disabled).
|
|
87
|
+
- **Active Allowlist**: If the allowlist contains one or more servers, **all
|
|
88
|
+
locally configured servers not present in the allowlist are ignored**.
|
|
89
|
+
- **Configuration Merging**: For a server to be active, it must exist in
|
|
90
|
+
**both** the admin allowlist and the user’s local configuration (matched by
|
|
91
|
+
name). The client merges these definitions as follows:
|
|
92
|
+
- **Override Fields**: The `url`, `type`, & `trust` are always taken from the
|
|
93
|
+
admin allowlist, overriding any local values.
|
|
94
|
+
- **Tools Filtering**: If `includeTools` or `excludeTools` are defined in the
|
|
95
|
+
allowlist, the admin’s rules are used exclusively. If both are undefined in
|
|
96
|
+
the admin allowlist, the client falls back to the user’s local tool
|
|
97
|
+
settings.
|
|
98
|
+
- **Cleared Fields**: To ensure security and consistency, the client
|
|
99
|
+
automatically clears local execution fields (`command`, `args`, `env`,
|
|
100
|
+
`cwd`, `httpUrl`, `tcp`). This prevents users from overriding the connection
|
|
101
|
+
method.
|
|
102
|
+
- **Other Fields**: All other MCP fields are pulled from the user’s local
|
|
103
|
+
configuration.
|
|
104
|
+
- **Missing Allowlisted Servers**: If a server appears in the admin allowlist
|
|
105
|
+
but is missing from the local configuration, it will not be initialized. This
|
|
106
|
+
ensures users maintain final control over which permitted servers are actually
|
|
107
|
+
active in their environment.
|
|
108
|
+
|
|
109
|
+
### Unmanaged Capabilities
|
|
110
|
+
|
|
111
|
+
**Enabled/Disabled** | Default: disabled
|
|
112
|
+
|
|
113
|
+
If disabled, users will not be able to use certain features. Currently, this
|
|
114
|
+
control disables Agent Skills. See [Agent Skills](../cli/skills.md) for more
|
|
115
|
+
details.
|
|
@@ -2,9 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
The Gemini CLI includes a Checkpointing feature that automatically saves a
|
|
4
4
|
snapshot of your project's state before any file modifications are made by
|
|
5
|
-
AI-powered tools. This
|
|
6
|
-
|
|
7
|
-
run.
|
|
5
|
+
AI-powered tools. This lets you safely experiment with and apply code changes,
|
|
6
|
+
knowing you can instantly revert back to the state before the tool was run.
|
|
8
7
|
|
|
9
8
|
## How it works
|
|
10
9
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# CLI cheatsheet
|
|
1
|
+
# Gemini CLI cheatsheet
|
|
2
2
|
|
|
3
3
|
This page provides a reference for commonly used Gemini CLI commands, options,
|
|
4
4
|
and parameters.
|
|
@@ -9,8 +9,7 @@ and parameters.
|
|
|
9
9
|
| ---------------------------------- | ---------------------------------- | --------------------------------------------------- |
|
|
10
10
|
| `gemini` | Start interactive REPL | `gemini` |
|
|
11
11
|
| `gemini "query"` | Query non-interactively, then exit | `gemini "explain this project"` |
|
|
12
|
-
| `
|
|
13
|
-
| `cat file \| gemini -p "query"` | Process piped content | `cat logs.txt \| gemini -p "explain"` |
|
|
12
|
+
| `cat file \| gemini` | Process piped content | `cat logs.txt \| gemini` |
|
|
14
13
|
| `gemini -i "query"` | Execute and continue interactively | `gemini -i "What is the purpose of this project?"` |
|
|
15
14
|
| `gemini -r "latest"` | Continue most recent session | `gemini -r "latest"` |
|
|
16
15
|
| `gemini -r "latest" "query"` | Continue session with a new prompt | `gemini -r "latest" "Check for type errors"` |
|
|
@@ -53,8 +52,8 @@ and parameters.
|
|
|
53
52
|
|
|
54
53
|
## Model selection
|
|
55
54
|
|
|
56
|
-
The `--model` (or `-m`) flag
|
|
57
|
-
|
|
55
|
+
The `--model` (or `-m`) flag lets you specify which Gemini model to use. You can
|
|
56
|
+
use either model aliases (user-friendly names) or concrete model names.
|
|
58
57
|
|
|
59
58
|
### Model aliases
|
|
60
59
|
|