Context and Mentions
Control the notes, selections, web content, images, and project context Copilot receives.
Copilot uses context to give the AI information about your notes, selected text, web content, and more. Quick Chat uses automatic context and @-mentions. The separate Agent Mode view has its own context controls and native agent tools.
Automatic Context
Active Note
By default, the content of your currently open note is automatically included in every message you send. This means you can ask things like:
- "Summarize this note"
- "What are the action items here?"
- "Add a conclusion section"
To disable automatic note context: Settings → Copilot → Basic → Auto-add active note to context (toggle off).
Active Web Tab (Desktop Only)
If you have the Copilot Web Viewer open alongside your notes, the content of the currently active web tab is automatically included as context (labeled {activeWebTab}). This lets you ask the AI to help you work with web content.
Selected Text
If you highlight text in a note and then type in the chat, the selected text is automatically included as context. This is useful for asking about or transforming a specific part of a note.
You can enable/disable automatic selection adding in Settings → Copilot → Basic → Auto-add selection to context.
Images in Markdown
If your note contains images (e.g., ![[screenshot.png]]), and you're using a model with Vision capability, those images are automatically included in the context. Copilot will pass the image data to the AI so it can see and describe the image.
To control this behavior: Settings → Copilot → Basic → Pass markdown images to AI.
@-Mentions
Type @ in the chat input to mention and include specific items as context.
@note — Include a Specific Note
Type @ followed by the note title to add a note to context:
@My Meeting Notes tell me what was decided in this meeting
The note's full content is included in the request.
@folder — Include a Folder of Notes
Type @ followed by a folder name to include all notes in that folder:
@Projects/ what tasks are still open?
@tags — Include Notes by Tag
Use # after @ to include all notes with a specific tag:
@#work/project summarize the status of the work project
@URL — Include a Web Page
Paste a URL or type @https://... to fetch and include a web page's content:
@https://example.com/article summarize this article
URL processing requires an active Copilot license. YouTube URLs are handled specially — Copilot will fetch the video transcript automatically.
Tool Mentions
These special @-mentions explicitly trigger paid Quick Chat tools:
| Mention | What it does |
|---|---|
@vault | Search your vault notes for relevant information |
@websearch or @web | Search the internet |
@composer | Create or edit a note |
@memory | Access or update your memory |
Example:
@vault what did I write about machine learning last month?
@websearch what are the latest changes to the Python packaging ecosystem?
These tool mentions do not appear in Agent Mode. There, OpenCode, Claude, or Codex decides when to use its own vault, web, and file tools.
Context in Agent Mode
In the dedicated desktop Agent Mode view, use the controls above the message box to add or remove:
- the active note;
- selected notes;
- selected text;
- the active Copilot web tab; and
- images when the selected model supports vision.
You can also mention a note with [[Note Title]], use / to expand a custom command or skill, and open an Agent Mode project to load reusable project context. Mentioning multiple agents with @ starts multi-agent work and requires a paid plan with multi-agent access.
Adding Context Manually
Add Selection to Chat Context
Use the command palette: Add selection to chat context
Highlights the selected text and adds it to the chat as context without sending a message. Useful when you want to build up context before sending.
Add Web Selection to Chat Context
Use the command palette: Add web selection to chat context
Works similarly but captures selected text from the Web Viewer. Available on desktop only.
Adding a PDF as Context (Copilot License)
Click the + Add context button above the chat input to attach a PDF file. The PDF is converted to text and included as context for your message.
Adding an Image as Context
Drag an image directly into the chat input box, or click the image button in the bottom-right corner of the chat input. The image is sent to the AI if your selected model supports Vision capability.
Context Indicators
When context items are added to your message, Copilot shows small pills or badges in the chat input area showing what's included (e.g., the note name, a URL, a tag). This helps you confirm exactly what the AI will see.
Context Behavior by Mode
| Context Type | Chat | Vault QA | Paid Quick Chat | Agent Mode |
|---|---|---|---|---|
| Active note | Yes (auto) | Yes (auto) | Yes (auto) | Yes (toggle) |
| Selected text | Yes (auto) | Yes (auto) | Yes (auto) | Yes |
| Note / folder mentions | Yes | Yes | Yes | Notes |
| URL processing | License required | License required | Yes | Native agent or skill |
@vault search | Yes (explicit) | Auto | Auto | Not shown |
@websearch | No | No | Yes | Not shown |
| Images (vision) | Yes | Yes | Yes | Yes |
| Active web tab | Desktop only | Desktop only | Desktop only | Desktop only |
Related
- Chat Interface — How the chat panel works
- Agent Mode and Tools — Agent context, permissions, skills, and tools
- Vault Search and Indexing — How vault search works