Skip to content
← Back to release · 2.1.309
Improvements / v2.1.309

Require workspace trust for ultrareview

CHANGELOG · original

Changed claude ultrareview to require workspace trust: it asks on a terminal, else refuses; scripts pass --trust-workspace, which takes no value (put a PR number or base branch before it), or set CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1
Open official changelog ↗

Documentation

Documentation excerpt

Workspace not trusted when running claude ultrareview

In a folder you haven't trusted, when claude ultrareview can't ask whether you trust it, the run exits with code 1 before the review starts:

Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog. Or, in a script or CI job, pass `--trust-workspace` to trust the folder for this run only.

For example, the subcommand can't ask when its standard input or standard output isn't a terminal. Sending the output to a file, as in claude ultrareview --json > findings.json, means standard output isn't a terminal.

What to do:

  • In a script or CI job, append --trust-workspace to trust the folder for that run: claude ultrareview --trust-workspace. Append it only for code you trust, because git and Claude Code can then run programs named in the folder's git configuration and project settings. For a pull request whose code you don't trust, run the review from a branch you trust.
  • On your own machine, run claude in that folder and accept the workspace trust dialog, then run your original command again

In a session, /ultrareview and /code-review ultra can stop with Ultrareview did not start: "<folder>" is not trusted, and this session started without asking whether you trust it. Start claude in that folder without IS_DEMO set, accept the workspace trust dialog, and run the command in the new session.

Each of these messages from claude ultrareview means that no review started and the exit code is 1:

  • Error: Workspace not trusted. This terminal ...: the terminal reported no row and column count, or can't fit the trust question and its warnings. Enlarge it or use a terminal that reports its size, then run claude ultrareview again. Outside your home directory, you can also run claude in that folder once and accept the trust dialog, so later runs there don't ask.
  • Error: Workspace not trusted. <folder> is your home directory: because trust for your home directory is never saved, running claude there first can't help. Run claude ultrareview from a project directory instead, after running claude there once to accept the trust dialog, or append --trust-workspace.
  • No answer in time. followed by Error: Workspace not trusted: the Trust <folder>? [y/N] question went unanswered for 5 minutes. Run claude ultrareview again and answer it.
  • Ultrareview did not start: <folder> is not trusted: you declined at the Trust <folder>? [y/N] question, for example by answering n or pressing Enter. To start the review, run claude ultrareview again and answer y.
  • Ultrareview did not start: `--trust-workspace` takes no value: something other than a flag follows --trust-workspace, such as a PR number or false. If you don't trust the folder, leave the flag out. To trust it for this run, put the PR number or base branch before the flag: claude ultrareview 1234 --trust-workspace.

Before v2.1.309, claude ultrareview didn't accept --trust-workspace.

Documentation snapshot · 2026-11-20

Change details