File tagging allows users to reference files in their code editor (Cursor or Windsurf) by speaking their names naturally. Aqua will convert spoken filenames like "main dot t s" into formatted tags like
@main.ts that trigger the editor's autocomplete.Â
How it works
In a supported editor, mention a file while using Aqua, and Aqua will pull in the file reference when you’re done.
Supported Formats:
- (filename) (extension)
- (filename) (dot) (extension)
Examples:
- "main ts" →
@main.ts
- "plates events ts" →
@plates.events.ts
- "settings pi" →
@settings.py
- “main dot pi” →
@main.py
- “cli dot go” →
@cli.go
Explicit Tagging
You can explicitly signal that they're about to say a filename by using trigger words:
@or "at"
- "tag" or "tagged"
Examples:
- "at main" →
@main.ts
- "tag user profile" →
@userProfile.tsx
- "at settings" →
@settings.tsx
- “main dot pi” →
@main.py
- “cli dot go” →
@cli.go
Â
Supported Editors
Â
What versions of Aqua support File Tagging?
File tagging is supported in Aqua v0.10 and up.
Many of my files have the same name. How does Aqua know which one to tag?
It’s common to have many files in a project with the same name. For example:
page.tsx, index.ts, main.py, Dockerfile , etc. File tagging uses the editor's built-in autocomplete, which tries to resolve to the most likely file taking many factors into account, like which files are currently open and which have been referenced recently.
Open the specific instance of a file you want to tag if the editor’s autocomplete isn’t picking the correct version.
I mentioned a file, but it wasn't tagged. What should I do?
File tagging is designed to work best with open files and files visible in the Explorer. Ensure the file is in one of those two places and try again.
Â