Skip to main content
Two ways to put a file in front of your coworker, depending on whether it’s already in the session.

Attaching

The paperclip in the message box, or drag a file onto the conversation. Attached files appear above the box before you send, so you can check you grabbed the right one and remove it if not.
Two attached spreadsheets shown above the message box before sending

Attachments sit above the box until you send, each with its size and a way to remove it.

Attach when the file is new to the session.

Mentioning

Type @ and a menu of the files already in the session appears. Your other coworkers come first, each with its role and a delegate hint. Keep typing to filter, pick one, and it’s referenced in your message.
The mention menu offering Ivy and Sam first, each with its role and a delegate hint, then the task's files by folder

With Work with coworkers on, your other coworkers come first. Then the files already in the task, by folder and name, so you can tell two similar exports apart.

Mention when the file is already there and you want to be unambiguous:
That says exactly which two files, with no room for your coworker to pick the wrong one. Picking a coworker from the menu does something else: it asks your coworker to hand that part of the job to that coworker. The menu offers coworkers only while Work with coworkers is on. See Working with coworkers.

Mention a file from Workspace files

A file in Workspace files is mentioned as @files/ and its path, like @files/Reports/2026/Q3 summary.md. Every coworker can open it.
  • From an agent’s Files. Choose Mention in chat… on the file. Pick one of your sessions to put the mention in its message box, a coworker under New session with… to start a session with the file in its message, or Ask the Concierge.
The Mention dialog for Q3 summary.md showing @files/Reports/2026/Q3 summary.md, one of your tasks, a new task with Nora, Sam or Ivy, and Ask the Concierge

Mention in chat: the mention, and where it can go.

The @ menu in a session’s message box offers your other coworkers and the session’s and coworker’s files. To mention a Workspace file, use Mention in chat… in an agent’s Files.

When mentioning is worth it

  • More than one file in the session could plausibly be the one you mean
  • Filenames are similar — export.csv and export-final.csv
  • You’re referring back to something from earlier in a long conversation
  • The session has a lot of files and you want to be precise
Otherwise, just describe it. “The sales export” works fine when there’s only one.
Mention rather than re-upload. Uploading the same file twice gives your coworker two copies and a decision to make about which is current.

Good to know

Attaching a file adds it to the session’s files, so it stays available for the rest of the conversation. You attach once, then mention it afterwards.
Attach several at once when they belong together. “Reconcile these two” with both attached is clearer than two messages.

Common questions

Yes. Whether your coworker can look at it depends on the model — the picker marks the ones that accept images. See Effort and model.
It reads what it needs for the job. Saying what you want from the file — “just the totals row” — keeps it efficient on a large one.
Files saved to the coworker are available in every session automatically, so there’s usually nothing to point at. Naming it in words is enough.
Remove it from the strip above the box before sending. After sending, just say so — your coworker won’t quietly use the wrong one.

Next steps

Files in a session

What’s already in the session.

The conversation

Everything else in the message box.

Previewing files

Check what you attached.

Files overview

Where files live.