From b38dc26a114d5c8bacbd872cd3998d024d1b6a28 Mon Sep 17 00:00:00 2001 From: Emily Hedlund Date: Thu, 23 Apr 2026 13:44:12 -0400 Subject: [PATCH 1/3] update error message to point to README --- packages/cli/src/utils/userStartupWarnings.ts | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/packages/cli/src/utils/userStartupWarnings.ts b/packages/cli/src/utils/userStartupWarnings.ts index 78627df3e5a..9a57a044a36 100644 --- a/packages/cli/src/utils/userStartupWarnings.ts +++ b/packages/cli/src/utils/userStartupWarnings.ts @@ -96,7 +96,9 @@ const folderTrustCheck: WarningCheck = { if (isHeadlessMode()) { throw new FatalUntrustedWorkspaceError( - 'Gemini CLI is not running in a trusted directory. To proceed, either use `--skip-trust`, set the `GEMINI_CLI_TRUST_WORKSPACE=true` environment variable, or trust this directory in interactive mode.', + 'Gemini CLI is not running in a trusted directory. To proceed, either use `--skip-trust`, ' + + 'set the `GEMINI_CLI_TRUST_WORKSPACE=true` environment variable, or trust this directory in interactive mode. ' + + 'For more details, see https://github.com/google-gemini/gemini-cli/blob/main/README.md', ); } From f5de31980365eac297723ee414fec6918d8c3b15 Mon Sep 17 00:00:00 2001 From: Emily Hedlund Date: Thu, 23 Apr 2026 18:49:27 -0400 Subject: [PATCH 2/3] update URL to trusted folders doc --- packages/cli/src/utils/userStartupWarnings.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/cli/src/utils/userStartupWarnings.ts b/packages/cli/src/utils/userStartupWarnings.ts index 9a57a044a36..549b62f859d 100644 --- a/packages/cli/src/utils/userStartupWarnings.ts +++ b/packages/cli/src/utils/userStartupWarnings.ts @@ -98,7 +98,7 @@ const folderTrustCheck: WarningCheck = { throw new FatalUntrustedWorkspaceError( 'Gemini CLI is not running in a trusted directory. To proceed, either use `--skip-trust`, ' + 'set the `GEMINI_CLI_TRUST_WORKSPACE=true` environment variable, or trust this directory in interactive mode. ' + - 'For more details, see https://github.com/google-gemini/gemini-cli/blob/main/README.md', + 'For more details, see https://geminicli.com/docs/cli/trusted-folders/#headless-and-automated-environments', ); } From 1f034e8fcc65970d9c8a3852e5a7921ea590af43 Mon Sep 17 00:00:00 2001 From: Emily Hedlund Date: Thu, 23 Apr 2026 18:56:30 -0400 Subject: [PATCH 3/3] update docs to point to run-gemini-cli docs --- docs/cli/trusted-folders.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/cli/trusted-folders.md b/docs/cli/trusted-folders.md index efb99ea397a..cbcf5b7fd09 100644 --- a/docs/cli/trusted-folders.md +++ b/docs/cli/trusted-folders.md @@ -117,6 +117,10 @@ the following methods: These methods will trust the current workspace for the duration of the session without prompting. +For detailed instructions on managing folder trust within CI/CD workflows, +review the +[Gemini CLI trust guidance for GitHub Actions](https://github.com/google-github-actions/run-gemini-cli/blob/main/docs/trust-guidance.md). + ## Overriding the trust file location By default, trust settings are saved to `~/.gemini/trustedFolders.json`. If you