# Selection Mode and Annotate

Source: [Selection Mode and Annotate](<https://pr-995-preview.chatcut.dev/docs/selection-mode>)

Documentation index: [llms.txt](<https://pr-995-preview.chatcut.dev/docs/llms.txt>)

Last updated: 2026-11-19

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](https://pr-995-preview.chatcut.dev/docs/prompt-composer#upload-attachments). For reusable project media, import it into the **Media Pool**.
