Mentions

Use @ to mention files, folders, integrations, and docs in the chat input.

Mentions let you quickly attach project context to a message so the assistant knows exactly which files, folders, docs, or integrations you are talking about.

Typing @ in the chat input opens the mentions picker above the editor, grouped into three categories:

• Files & Folders – project files and directories
• Integrations – connected tools and services
• Docs – framework and language documentation

Files & Folders mentions

Use the Files & Folders tab to point the assistant at specific parts of your codebase.

When you:

1. Type @ in the chat input.
2. Choose Files & Folders.
3. Scroll or type to filter for the file or folder you want.
4. Press Enter on an item.

Cursor inserts a mention token into your message that links directly to that file or folder, and the assistant can read it while answering.

Some example prompts using file and folder mentions:

• “@App.tsx Refactor this component to use a layout component rather than inline styles.”
• “@/src/components/ui Review these components for accessibility issues.”

You can add multiple file or folder mentions to the same message if you want the assistant to consider several locations together.

Docs mentions

Docs mentions let you pull in external documentation sources so the assistant can answer with up‑to‑date, framework‑specific guidance.

From the @ picker, switch to the Docs tab to see available documentation sets, such as:

• React
• TypeScript
• Next.js
• Tailwind CSS
• Node.js
• Python

Select one or more docs sources to insert them as mentions in your message. The assistant will then ground its answer in those docs when possible.

Example prompts:

• “@React @TypeScript Show an example of a strongly‑typed React context for theme settings.”
• “@Next.js Help me convert this API route to the new app router style.”

Integrations mentions

The Integrations tab in the mentions picker surfaces any tools and services you have connected to Cursor (for example, design tools or other external systems, depending on your setup).

Mentioning an integration:

• Inserts a token for that integration into your message.
• Tells the assistant to use that tool or data source when formulating its response, when supported.

You can mix integration mentions with files and docs in the same message to combine multiple sources of context.

Behavior and shortcuts

Mentions are designed to be fast to add from the keyboard:

• Open picker: type @ in the chat input.
• Filter: keep typing to narrow the list by name or path.
• Navigate: use ↑ / ↓ to move through results.
• Select: press Enter to insert the highlighted mention.
• Close: press Esc to dismiss the picker.

Notes:

• Mentions only apply to the current message; add them again if you start a new thread or follow‑up message that needs the same context.
• You can insert multiple mentions (files, folders, docs, and integrations) in a single message.

See also

• Commands