Skip to content

Worktree trust

When you open a project Tyrn doesn’t know, it opens in Restricted Mode. This protects your Mac from settings and tools that a project’s files could start on their own.

What you see

Tyrn shows an Unrecognized Project dialog. It says untrusted projects open in Restricted Mode, and asks you to review .tyrn/settings.json for any extensions or commands the project configures.

Restricted Mode prevents:

  • Project settings from being applied.
  • Language servers from running.
  • MCP server integrations from installing.

Choose what to do

In the dialog, pick one:

  • Trust and Continue marks the project as trusted and unlocks all features.
  • Stay in Restricted Mode keeps the limits.

You can also tick Trust all projects in a parent folder to trust everything inside it.

Restricted Mode button

While a project is restricted, a Restricted Mode button shows in the title bar. Click it to open the dialog again and trust the project. The command workspace: toggle worktree security does the same.

Turn the check off

To skip trust checks for every project, set this. Only do it if you trust everything you open.

settings.json
{
"session": {
"trust_all_worktrees": true
}
}