Claude Code v2.1.133 ·
Worktree Base Ref Setting
EntryKind: in v2.1.133,
ChangesSection of the release
What
You can now choose whether new worktrees start from a clean remote default branch or from your current local HEAD.
Usage
{
"worktree": {
"baseRef": "head"
}
}
Details
fresh remains the default and branches from origin/<default-branch>.head branches from the current local HEAD, so unpushed commits and feature-branch state are present.- The setting applies to
--worktree, EnterWorktree, and agent isolation. - The setting is also exposed in the config UI as “Worktree base ref”.
Evidence
Worktree setting schema and UI were added (search for "Which ref new worktrees branch from" and "Worktree base ref").
Strings lifted out of the shipped bundle, so the claim above can be checked against them.
One source agreesOne thing we can check says the same as this entry.
Anthropic's release notes agreeAdded worktree.baseRef setting (fresh | head) to choose whether --worktree, EnterWorktree, and agent-isolation worktrees branch from…
See this entry in the whole of v2.1.133 →
