Context and Mentions
Context is the material Copilot gives an AI with your request. Choose the shortest lifetime that fits the job:
Clicking a PDF page citation in a chat opens the target page at its top while keeping your current zoom. Citations to selected text, annotations, or an explicit position keep their original destination.
| Context type | How long it lasts |
|---|---|
| Agent Chat attachment or mention | The next message |
| Project context | Every new chat started in that Project |
Vault or Project AGENTS.md | Every Agent Chat started in that vault or Project |
| Quick Chat attachment | The next Quick Chat message |
Add context to Agent Chat
Section titled “Add context to Agent Chat”Select + beside the Agent Chat composer to open Add context. Depending on what is open, you can add the Active Note, other Notes, Folders, the Active Web Tab, other Web tabs, or Files from your computer. Web tabs come from Copilot’s desktop Web Viewer.
You can also select the Copilot icon in a note’s header. Agent Chat opens with that specific note attached to the current draft. The attachment stays with the draft if you switch notes before sending.
You can also add context while typing:
- Type
[[and select a note, PDF, or canvas to insert[[Note title]]. - Type
@to browse the available context categories. - Choose a folder to insert its path as
{Folder/path}. - Paste or drag an image into the composer. The selected model must support images.
- Drag any other file into the composer to attach it. A file from outside the vault is copied to the folder set in Settings → Files and links → Default location for new attachments, or into the Project’s
sources/folder when you are in a Project, and one notice lists the copies and their folder.
Context badges above the composer show what will be sent with the next message. Select the x on a badge to remove it. After the message is sent, one-turn attachments are cleared.
A note mention gives the agent the note’s vault path so it can read the current file when needed. A folder mention points to a folder to inspect. It does not paste every file in that folder into the prompt.
Active note and selected text
Section titled “Active note and selected text”A new Agent Chat starts with an Active Note badge unless Auto-attach active note is off in settings. The badge stays attached to every message. Each message tells the agent which note is active when you send it, so switching notes mid-chat points the agent at the new note. The agent gets the note’s path and opens the note only when it needs the contents. If you remove the badge, no active note is attached to later messages in that chat until you add the Active Note again from Add context or with @.
Active web tab
Section titled “Active web tab”When a page is open in the desktop Web Viewer, Agent Chat attaches it as an Active Web Tab badge on every message, so the agent sees the page you are reading, including pages you are signed in to. The page’s full content is sent the first time. While it stays the same, later messages do not send it again, because the agent already has it earlier in the chat. If you go to another page, or the content changes, the new content is sent in full. If you remove the badge, no web page is attached to later messages in that chat, even after you open another page, until you add the Active Web Tab again from Add context or with @.
Active Note and selected text are separate attachments in Agent Chat and Quick Chat. You can include either one or both, even when the excerpt comes from the active note. Removing one badge leaves the other attached. Selection badges show the start of the selected text. Hover over a badge to see the full excerpt and its source.
To attach an excerpt from a note:
- Select the text.
- Run Add selection to chat context from the command palette.
- Review the removable selection badge before sending.
The manual selection command is available from the command palette or an assigned hotkey. The editor’s Copilot menu contains Quick Ask, quick commands, and custom commands.
For text selected in the Web Viewer, run Add web selection to chat context. Copilot sends the selected excerpt together with the active web tab it came from.
Selected text in notes is automatically added to chat context as you select it in Reading or Edit view, and stays attached when you move to chat. Reading view selections show the note path without line numbers. On desktop, this also works with Web Viewer selections. Text selected in a PDF or in an agent turn’s diff tab, and shapes selected in an Excalidraw drawing, are attached the same way. Review or remove the selection badge before sending.
Reuse context with Projects
Section titled “Reuse context with Projects”For material that should be prepared for more than one chat, create a Project. Drag notes and folders onto the Project’s Files tab to link them, or select Link context beside Linked to link files, folders, tags, properties, or a web or YouTube link. Dropping on the message box attaches the item to that message only.
Project context is prepared for every new chat in that Project. If preparation is still running when you send a message, Copilot queues the message and starts it when the context is ready.
Saved context is a focus aid, not a permission boundary. The agent can still inspect other files available through its tools. To keep the agent away from a folder, say so in the Project’s instructions (AGENTS.md).
One-turn attachments remain one-turn attachments inside a Project. Start a new Project chat after changing saved context or Project instructions when you want the latest version applied.
Context in Quick Chat
Section titled “Context in Quick Chat”Quick Chat has a separate composer and context state. It can attach the active note and, on desktop, the active Web Viewer tab. Use Add context for a note, folder, web tab, or file. Quick Chat accepts images and Markdown, canvas, base, and PDF files. You can also type [[Note title]] for a note.
Editing a sent Quick Chat message keeps its original attachments. Switching the active note or changing the composer attachments does not add them to the edited message.
Quick Chat attachments apply to the next Quick Chat message. They do not become Agent Chat context, Project context, or AGENTS.md instructions.
For vault-wide semantic search and AI history that you own outside the plugin, use Miyo. Miyo provides the local-first search path for Copilot V4.