File Tagging

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

Application	Supported
Cursor	Yes
Windsurf	Yes
Claude Code	No
Codex	No
Cline	Yes
VSCode (AI Sidebar)	No
Antigravity	Yes

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.

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.

Do you support File Tagging in other tools like Loveable, Bolt, Replit, etc?

Aqua will still format the file name correctly and works great with them. We've tested Aqua in depth with these tools and more. See our in-depth comparison here.