Allow Cursor to work with existing worktrees

Ideas Feature Requests
1

Where does the bug appear (feature/product)?

Cursor IDE

Describe the Bug

I want legible Git worktree names when I’m using Parallel Agents so I know what agent is doing what. Therefore, I create a worktree via cmd + shift + P, type Create Worktree and it allows me to name the worktree as expected.

Now in a new agent file where I want an agent attached to a certain git worktree and I choose said worktree I created, it ends up creating a random one with random characters.

Steps to Reproduce

  1. Create Worktree via cmd+shift+p, name the branch, attach location to where Cursor adds a their worktree, typically /Users/<you>/.cursor/worktrees/<repo>/feat-1.
  2. Click on New Agent, choose Worktree below the chat and choose the branch.
  3. write any prompt.

You will see it generates a new worktree with some random characters like

Expected Behavior

If I create a new agent and choosing an existing worktree, it should work under that same worktree path, not generate a new one unless not specified.

Operating System

MacOS

Current Cursor Version (Menu → About Cursor → Copy)

Version: 2.3.10
VSCode Version: 1.105.1
Commit: af6d64e4848e6185e482a2de5bac040191c8d790
Date: 2025-12-29T03:56:22.219Z
Electron: 37.7.0
Chromium: 138.0.7204.251
Node.js: 22.20.0
V8: 13.8.258.32-electron.0
OS: Darwin arm64 25.2.0

Does this stop you from using Cursor

No - Cursor works, but with this issue

2

Hey, thanks for the report.

This is the current expected behavior. Cursor automatically creates worktrees with unique suffixes to keep each agent isolated. Per the docs (Parallel Agents | Cursor Docs), we have a 1:1 mapping between agents and worktrees.

Your request to reuse existing worktrees with custom names is a good feature request. I’m moving this thread to Feature Requests so the team can consider adding an option for that.