Cursor cannot be used on a git worktree

Support Bug Reports
, ,
1

Where does the bug appear (feature/product)?

Cursor IDE

Describe the Bug

when opening on a worktree directory, it fails to index the project correctly

Steps to Reproduce

create worktree directory, open cursor ide on it, try to “@” a file from the project

Expected Behavior

to behave just as when opening from the main worktree

Operating System

Linux

Version Information

Version: 3.1.15
VSCode Version: 1.105.1
Commit: 3a67af7b780e0bfc8d32aefa96b8ff1cb8817f80
Date: 2026-04-15T01:46:06.515Z
Layout: editor
Build Type: Stable
Release Track: Default
Electron: 39.8.1
Chromium: 142.0.7444.265
Node.js: 22.22.1
V8: 14.2.231.22-electron.0
OS: Linux x64 6.14.0-37-generic

Does this stop you from using Cursor

Sometimes - I can sometimes use Cursor

4

https://forum.cursor.com/t/cursor-ide-fails-to-detect-git-worktrees/148121/5

7

Thanks for reporting this, and for linking to the earlier thread — you’re right that this is the same underlying issue. When Cursor opens a worktree directory, it doesn’t properly recognize the .git pointer file (since it’s a file, not a directory), which prevents the project from being indexed and breaks @ file context.

This is a known issue that our engineering team is actively working on rebuilding proper worktree support. There’s no workaround for the indexing gap at the moment, but the fix is in progress.

We’ll link your report internally to help track demand. I’ll keep this thread updated when there’s progress to share.