Annotate

Sometimes the fastest way to say what you want changed is to point at it. Annotate lets you mark up your live, running app, selecting the exact element you mean, so the agent knows precisely what you're talking about without you describing where it is in words.

What is Annotate

When you annotate, Glaze lets you pick an element directly in your running app: a button, a heading, a list row, a whole panel. Glaze captures exactly what you pointed at and sends that to the agent along with your message. Instead of "the small button in the top-right of the second card," you just point at it.

Because the agent receives precisely which element you selected, it spends less effort guessing and more on the change itself. It also helps with credit usage since it has more context for the change you'd like to make.

Start an Annotation

With your app running, start annotating from the Agent Chat composer:

1. Start the tool: Click the Annotate button next to the composer, or press ⌘ .. The button highlights to show annotating is active.
2. Point at what you mean: Move your pointer over your running app. Glaze highlights the element under it. Click the one you want to talk about.
3. Say what to change: Add your instruction, such as "make this bigger" or "use the accent color here," and send it. The agent gets your words plus the exact element you picked.

To leave annotating without selecting anything, press ⌘ . again or click the button to turn it off.

When Annotating Beats Words

Reach for annotation whenever the change is about a specific spot on screen and pointing is clearer than describing:

• Hard-to-name elements: The third icon in a row, one cell in a grid, a label buried in a dense layout.
• Visual tweaks: Spacing, size, color, or alignment of one particular thing.
• "This, not that": When several parts of the app look similar and you need to be sure the agent changes the right one.

Plain prompts are still best for changes that aren't tied to one place, like adding a feature, changing behavior, or describing the app as a whole. Annotation and a written prompt work together: point at the element, then type what you want done to it.