Skip to main content

​
@Mentions

Type @ in the chat composer to search for files and folders in your workspace. Select a file to insert a mention chip — a clickable reference that tells the AI exactly which document to work with.

​
How It Works

  1. Type @ to open the file search dropdown
  2. Search by file name — results are scoped to your workspace
  3. Click a result to insert a draggable mention chip
  4. The chip shows the file name with an X button to remove it
  5. When you send the message, mentioned files are made available to the AI agent

​
Pending File Uploads

You can also drag and drop files directly onto the chat composer before uploading them:
  • Dropped files appear in the @ dropdown marked as “TO BE UPLOADED”
  • Files are only uploaded when you actually mention them in your message
  • Unmentioned pending files are cleaned up automatically (no orphans)

​
What Happens on Send

When you send a message with file mentions:
  1. Any pending files are uploaded to your staging workspace
  2. The backend validates that all referenced artifacts exist
  3. Each file’s workspace path is resolved to a sandbox path
  4. The AI receives a system context block mapping each file to its location:
User uploaded these artifacts to your computer:
/root/workspace/Reports/Q1_Report.pdf
/root/workspace/Data/Budget.xlsx
The agent can then use the view tool to read these files and work with them directly.

​
Inline Attachments

You can also attach files without @ mentions by using the attachment button in the composer. This uploads the file to your workspace and attaches it to the message in one step.

​
Tips

  • Mention specific files when you want the AI to focus on particular documents
  • Use folder references to give the AI context about a group of related files
  • File mentions survive page refreshes — pending uploads are stored in the session metadata