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:

MentionWhat it does
@vaultSearch your vault notes for relevant information
@websearch or @webSearch the internet
@composerCreate or edit a note
@memoryAccess 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 TypeChatVault QAPaid Quick ChatAgent Mode
Active noteYes (auto)Yes (auto)Yes (auto)Yes (toggle)
Selected textYes (auto)Yes (auto)Yes (auto)Yes
Note / folder mentionsYesYesYesNotes
URL processingLicense requiredLicense requiredYesNative agent or skill
@vault searchYes (explicit)AutoAutoNot shown
@websearchNoNoYesNot shown
Images (vision)YesYesYesYes
Active web tabDesktop onlyDesktop onlyDesktop onlyDesktop only