Cursor commands aren't able to pull context with "@Branch" symbol

Bug Reports
1

Where does the bug appear (feature/product)?

Cursor IDE

Describe the Bug

I’ve some cursor commands like “/review” and “/update-docs” that update a changelog and documentation files based on my changes. Normally when I call these commands I do “@Branch” so all my git changes are added to the context (Specially if I’m on a fresh chat window) and the LLM can make the corresponding updates more easily. However I would love to just do “/review” without having to keep repeating “@Branch” every time I call it.
I’ve added “@Branch” to my command “.md” file, but it seems cursor doesn’t know how to call the symbol from there.

Steps to Reproduce

  • Create a cursor command, ie “review.md”
  • From there add some instructions and include “@Branch” with the intention of allowing the agent to call that symbol and pull all the git changes to the context

Expected Behavior

  • The agent should be able to run/call the symbol, and add the code changes to the context

Screenshots / Screen Recordings

Screenshot 2025-11-29 at 7.04.46 AM.png
Screenshot 2025-11-29 at 7.04.46 AM.png1392×1322 93.7 KB

Operating System

MacOS

Current Cursor Version (Menu → About Cursor → Copy)

Version: 2.1.39
VSCode Version: 1.105.1
Commit: 60d42bed27e5775c43ec0428d8c653c49e58e260
Date: 2025-11-27T02:30:49.286Z
Electron: 37.7.0
Chromium: 138.0.7204.251
Node.js: 22.20.0
V8: 13.8.258.32-electron.0
OS: Darwin arm64 24.6.0

For AI issues: which model did you use?

Gemini 3 and Claude Opus 4.5

Does this stop you from using Cursor

No - Cursor works, but with this issue

2

Hey, thanks for the report. It looks like this isn’t a bug but a missing feature. Right now, @mentions (for example, @Branch) inside a command .md file are not added to the context and only work when you type them directly in a message (for example: “/review @Branch”).

As a temporary workaround, you can trigger “/review @Branch” directly in the message. If you’d like, you can create a feature request for supporting @mentions inside .md commands in Feature Requests so you don’t have to repeat @Branch every time.