{"version":"2.1.299","anchor":"git-worktree-base-resolution-gives-specific-errors","canonical_anchor":"git-worktree-base-resolution-gives-specific-errors","heading":"Clearer errors when Claude Code can't find where to start a worktree","tier":"notice","area":"Worktrees","scope":"individual","heads_up":false,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.299\/e\/git-worktree-base-resolution-gives-specific-errors","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.299","markdown":"### Clearer errors when Claude Code can't find where to start a worktree\n\nWhen creating a git worktree fails to find its starting point, Claude Code now explains why and how to fix it\n\n**What**\n\nA git worktree is an extra working copy of a repository that Claude Code can create to work in. When Claude Code cannot work out which commit a new worktree should start from, it now shows a detailed error with the cause and advice. For example, it may suggest setting `worktree.baseRef` to `\"head\"` in Claude Code settings, so worktrees start from your current commit.\n\n**Why**\n\nIf worktree creation fails, the message now tells you what went wrong and what setting to change.\n\n- Area: Worktrees\n- Names: `worktree.baseRef`\n- Tier: You'll notice\n- Useful: 2\/5\n- Signal: 1\/5\n- Scope: individual\n- Heads-up: no"}