AI Workspace

Selection Mode and Annotate

View as Markdown

Selection Mode turns something you select in the editor into a precise reference in the current Agent draft. Use it when a request such as “change this,” “start here,” or “remove these words” would otherwise be ambiguous. In ChatCut Desktop, the same feature is called Annotate.

Turn on Selection Mode

On the web:

  1. Open the AI panel and keep the composer in Agent mode.
  2. Select the pointer button labeled Selection Mode below the Prompt field. The tooltip also shows the shortcut Option-S.
  3. Select the project content you want ChatCut to understand.
  4. Confirm that a reference chip appears in the Prompt field, then describe the requested change and select Send message.

Select the button again to leave Selection Mode. Leaving the mode does not remove reference chips already attached to the draft.

Turn on Annotate in ChatCut Desktop

  1. Open the AI panel and keep the composer in Agent mode.
  2. Select the Annotate button below the Prompt field, or press Option-S (Alt+S on Windows). Its tooltip reads “Point AI at things in the Viewer, timeline or transcript.” You can also right-click the Viewer and choose Annotate for AI.
  3. The Viewer opens if it was hidden, with two tools above the picture: Select region to drag a box, and Pen to draw a mark on the frame.
  4. Select or mark the content you want ChatCut to understand, confirm that a reference chip appears in the Prompt field, then describe the requested change and send it.

While Annotate is on, the button stays highlighted. Select it again to finish annotating.

What can I select?

  • Select a clip or other item on the Timeline.
  • Select media in the Media Pool.
  • Drag a box over a region in the Viewer. In ChatCut Desktop, you can also draw on the frame with Pen.
  • Select a point on the Timeline ruler to reference a specific time.
  • Select words or a passage in the Transcript panel.

The resulting chip records the kind of reference and enough project context for the Agent to resolve it when the message is sent.

Selection Mode versus normal editor selection

Normal selection chooses an item for manual editing in the Inspector or Timeline. Selection Mode additionally inserts that selection into the AI draft. Turning it on does not ask the Agent to do anything by itself; the Prompt still needs an instruction.

If a reference is stale

Before sending, reselect the content when you have switched Timelines, deleted or replaced a referenced asset, or substantially changed the referenced Transcript passage. If ChatCut says the reference can no longer be resolved, remove that chip, select the current content again, and resend the request.

For files that are not yet in the project, use Prompt Composer → Upload attachments. For reusable project media, import it into the Media Pool.