{"name":"EnterWorktree","slug":"enterworktree","family":"tool","title":"Tools","noun":"tool","description":"A `worktree.location` setting tells the desktop app where to create worktrees for SSH sessions; the CLI ignores it.","description_source":"entry","described_by":{"version":"2.1.239","anchor":"worktree-location-setting-for-desktop-ssh-sessions"},"presence":{"first_seen":"2.1.138","removed_in":null,"in_current_build":true,"newest_mined":"2.1.308","builds":149,"mined_builds":149,"first_cited":{"version":"2.1.239","released_at":"2026-08-21 17:18:54","spans":1}},"aliases":[],"entries":[{"version":"2.1.302","anchor":"enterworktree-result-message-uses-a-shortened-path","heading":"Worktree entry message formats its folder path for display","line":"The message shown after entering a worktree now runs the folder path through a display formatter instead of printing it raw","released_at":"2026-10-16 16:48:28","reason":"found in this entry's text"},{"version":"2.1.290","anchor":"enterworktree-refuses-switches-that-would-lose-write-access","heading":"Switching into a worktree is refused if it would leave Claude unable to edit","line":"`EnterWorktree` now checks first and refuses to switch into an existing worktree where the agent would not have write access","released_at":"2026-10-05 18:12:44","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"enterworktree-can-resolve-a-repo-root-from-a-non-git-working","heading":"EnterWorktree can resolve a repo root from a non-git working copy (code path compiled out)","line":"EnterWorktree gained a fallback for folders that are not git repositories, but it never runs, so behaviour is unchanged","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.239","anchor":"worktree-location-setting-for-desktop-ssh-sessions","heading":"worktree.location setting for Desktop SSH sessions","line":"A `worktree.location` setting tells the desktop app where to create worktrees for SSH sessions; the CLI ignores it.","released_at":"2026-08-21 17:18:54","reason":"found in this entry's text"},{"version":"2.1.203","anchor":"enterworktree-multi-repo-workspace-support","heading":"EnterWorktree: Multi-Repo Workspace Support","line":null,"released_at":"2026-07-07 17:40:17","reason":"found in this entry's text"},{"version":"2.1.133","anchor":"worktree-base-ref-setting","heading":"Worktree Base Ref Setting","line":null,"released_at":"2026-05-07 20:19:32","reason":"found in this entry's text"},{"version":"2.1.119","anchor":"spawn-mode-for-worktree-isolation","heading":"Spawn Mode for Worktree Isolation","line":null,"released_at":"2026-04-23 21:36:46","reason":"found in this entry's text"},{"version":"2.1.108","anchor":"exitworktree-and-enterworktree-subagent-validation","heading":"ExitWorktree and EnterWorktree Subagent Validation","line":null,"released_at":"2026-04-14 18:35:26","reason":"found in this entry's text"},{"version":"2.1.105","anchor":"enter-existing-worktrees","heading":"Enter Existing Worktrees","line":null,"released_at":"2026-04-13 19:51:19","reason":"found in this entry's text"},{"version":"2.1.105","anchor":"bug-fixes","heading":"","line":null,"released_at":"2026-04-13 19:51:19","reason":"found in this entry's text"}],"entries_total":11,"docs":[{"source":"claude-code","path":"agent-sdk\/typescript","title":"Agent SDK reference - TypeScript","documented":false},{"source":"claude-code","path":"claude-directory","title":"Explore the .claude directory","documented":false},{"source":"claude-code","path":"hooks","title":"Hooks reference","documented":false},{"source":"claude-code","path":"settings","title":"Claude Code settings","documented":false},{"source":"claude-code","path":"sub-agents","title":"Create custom subagents","documented":false},{"source":"claude-code","path":"tools-reference","title":"Tools reference","documented":false},{"source":"claude-code","path":"whats-new\/2026-w19","title":"Week 19 \u00b7 May 4\u20138, 2026","documented":false},{"source":"claude-code","path":"whats-new\/2026-w21","title":"Week 21 \u00b7 May 18\u201322, 2026","documented":false},{"source":"claude-code","path":"whats-new\/2026-w28","title":"Week 28 \u00b7 July 6\u201310, 2026","documented":false},{"source":"claude-code","path":"worktrees","title":"Run parallel sessions with worktrees","documented":false}],"docs_total":10,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/tool\/enterworktree","family_url":"https:\/\/changelogs.core-directive.com\/reference\/tool.json"}