[ ABORT TO HUD ]
SEQ. 1
SEQ. 2

Chat Panel & @Mentions

💬 Chat & Context Management 15 min 200 BASE XP

The @ Symbol is Everything

Cursor's Agent pane (Ctrl+L / Ctrl+I) becomes exponentially more powerful when you provide precise context using the @ mention system. Instead of pasting code manually, you reference exactly what the AI needs to see. You can also select code in the editor and press Ctrl+Shift+L to add the selection straight to the conversation.

Available @ Mentions

MentionWhat It DoesBest For
@fileReferences a specific fileTargeted questions about one file
@folderReferences an entire directoryUnderstanding module architecture
@codeReferences specific symbols (functions, classes)Debugging specific functions
@webLive web search during chatFinding documentation, latest APIs
@docsSearch external documentationFramework docs, library references
@gitGit history, diffs, branchesUnderstanding recent changes

Whatever Happened to @codebase?

Older guides lean on @codebase for project-wide questions. Modern Cursor agents ship with a built-in semantic codebase search tool and use it automatically whenever a question spans the project — so you rarely need to attach everything manually anymore.

Token Economy: Only include the files necessary for the current task. Attaching huge folders wastes tokens and can confuse the AI with irrelevant context — trust the agent's own search for broad questions.
SYNAPSE VERIFICATION
QUERY 1 // 3
How does the modern Cursor agent answer project-wide questions?
You must @mention every file
It uses a built-in semantic codebase search tool automatically
It reads only open tabs
It asks you to paste code
Chat Panel & @Mentions Tutorial | Chat & Context Management — Cursor Academy