# File Mentions



<DocVideo src="features/file-mention/mention-file" alt="Typing @ in the chat input, filtering files, and picking CardItem.tsx to mention it" width="960" height="640" />

You can scope the agent's context with **`@file` mentions**. Type `@` in the chat input and start typing a name — Ideavo shows matching files and folders from your project, and picking one adds it to your prompt.

## Why Use It [#why-use-it]

Without a mention, the agent has to go looking: searching your codebase, guessing at names, opening files to check whether they're the right ones. A mention removes that step — it hands over the exact path, so the agent reads the file straight away and spends its effort on the actual work.

That means less back-and-forth when several files share a name, and a lot less wasted context on a large project.

## How To Use It [#how-to-use-it]

* Type `@` followed by part of a file or folder name.
* Pick from the list — mention a folder to point at everything inside it.
* Mention as many files as you need — mentions aren't capped like uploads are.

<Callout type="info">
  Mentioned files show up like [attachments](/docs/features/attachments) on
  your message. They already live in your project, so nothing is uploaded —
  the agent just reads them where they are.
</Callout>

## Good To Know [#good-to-know]

* The menu searches your whole project, not just open files.
* An email address like `hey@ideavo.ai` won't trigger the menu.
* Edit your prompt freely — a mention sticks around as long as you leave the `@path` intact.

## FAQ [#faq]

<Accordions>
  <Accordion title="Does mentioning a file upload it?">
    No. Mentioned files are already in your project, so nothing is uploaded —
    the agent reads them in place. They still show up on your message like
    attachments do, but they don't count towards the five-file limit on
    [uploads](/docs/features/attachments).
  </Accordion>

  <Accordion title="Can I mention a folder?">
    Yes. Mention a folder to point the agent at what's inside it, rather than
    listing each file yourself.
  </Accordion>

  <Accordion title="Do mentions work inside a task?">
    Yes. The menu searches the files of whichever task you're working in.
  </Accordion>
</Accordions>
