Use mentions in chat and notes
Use this guide to add @ mentions in chat or notes to point Atlas at specific sources, notes, or other project items.
What this page covers
Exact mention syntax and controls, supported targets, context-selection effects, and unresolved mention behavior.
When to use mentions
Use a mention when you want a chat answer or a note to refer to a specific item rather than searching the whole project. Mentions are most useful in large projects where broad search returns too much material.
How to add a mention
- In the chat input or note editor, type @.
- Start typing the name of the source, note, or chat you want to reference.
- Select the correct item from the suggestion list.
- Write the instruction or context around the mention.
Select the exact item you mean. Items with similar names can produce weak or off-topic answers.
Use mentions in chat to narrow the scope
Instead of asking Atlas to search everything in the project, name the specific items you want it to use.
Example:
Compare @Paper A and @Paper B on their evaluation methods. Include citations from both.
This is faster than broad project search when you already know which sources are relevant.
Use mentions in notes to connect ideas
In the note editor, a mention creates a link from the note to the referenced item. Use mentions to:
- Connect a finding to the source it came from.
- Link a note to a related note that provides context.
- Reference a chat thread that contains useful evidence.
Each mention adds a connection to the project knowledge graph.
If a mention does not appear in the list
The item must exist in the current project. Mentions are scoped to the project you have open. Items in other projects do not appear.