Using @ mentions

When you give CoDirector an instruction like "shorten this clip" or "remove this section," the result depends on how precisely it can identify what you're referring to. The @ mention system removes ambiguity by letting you attach exact references — a specific clip, a point in time, a track, or a spoken phrase from the transcript — directly to your instruction.

The mention appears as a compact chip in your message, carrying all the context CoDirector needs to work on the right element.

How to use mentions

Type @ in the CoDirector input field to open the mention picker. A list of available references appears — organized by type. Select the one you want, and it appears as a chip embedded in your message. Write the rest of your instruction around it as usual.

You can include multiple mentions in a single instruction.

Mention types

Source files

Reference a specific file you've uploaded to the project — a video clip, audio file, or image. Source files appear with a small thumbnail or media type icon. This is useful when you want CoDirector to work with one particular uploaded asset rather than a clip that's been placed on the timeline.

Clips

Reference a clip that's been placed on the timeline. When you @ a clip, CoDirector knows its exact position, start and end points, and duration. Use this for instructions that apply to one specific segment rather than the whole video.

Example: @[Clip 00:09–00:22] cut this down to 10 seconds

Audio clips

Reference a music track, voiceover, sound effect, or custom audio file in your project. Audio clips are color-coded in the mention chip so you can tell them apart at a glance:

Music — green chip
Voiceover — violet chip
SFX — amber chip
Custom audio — blue chip

Example: Replace @[background music] with something more upbeat

Tracks

Reference an entire track on the timeline rather than a single clip. This is useful when you want an instruction to apply broadly — to all clips on a video track, or to the entire audio layer.

Example: Lower the volume on @[Audio Track 2] by 20%

Timestamps

Insert a specific point in time. A timestamp mention pins your instruction to an exact moment rather than a relative description like "near the beginning."

Example: Add a title card at @[00:05]

Transcript selections

This is the most precise way to target a section of your video by what's actually said. Highlight text in the Transcript panel, then click the CoDirector attachment button that appears. The selected phrase — along with the matching time range — is inserted as a mention chip in the input.

Example: Select "and that's why I believe in this product" in the transcript → attach as mention → Remove this line, it feels off-brand

Example instructions using mentions

@[Intro clip] trim the first 5 seconds
Remove the part at @[00:32] where I stumble over my words
Fade out @[background music] starting at @[01:45]
Select "let me just quickly" in the transcript → Remove this filler phrase

Tip: Transcript mentions are the most precise way to tell CoDirector exactly which moment you mean. If you're describing a section by what's spoken — rather than by its position — select it in the transcript panel first, then attach it as a mention rather than paraphrasing it in words.