Skip to main content

Improve with AI — rewrite annotation text

Updated Oct 15, 2026

Improve with AI — rewrite annotation text

Overview​

Improve with AI is an inline text-writer that lives on your guide-step annotations. When you're editing a guide step and want to tighten the copy, punch up the tone, or start from a rough sentence you'd rather not ship, click Compose with AI on the annotation and Walnut rewrites the text in place.

It replaces the older docked "Nutty" panel with a compact popover attached to the annotation you're editing, so you don't lose your place in the flow.

Before You Start​

  • AI must be enabled for your workspace. Turn it on from AI Control Center → Settings → Enable AI feature access.
  • Improve with AI is being rolled out gradually. If you don't see the Compose with AI button on your annotations, reach out to your Walnut CSM.

Rewrite Guide Text​

  1. In the editor, open a guide step's annotation.
  2. Click Compose with AI on the annotation (or the spark icon in the annotation's text toolbar).
  3. Walnut writes a first rewrite straight away and shows it in the annotation itself.
  4. To steer it, use the controls in the popover:
    • Pick a Voice — Default, Concise, Informative, or Your voice.
    • Type in Add instructions — for example, "make this shorter" or "match the tone of the earlier steps" — and press Enter.
    • Click the Regenerate icon for another take. If the step has narration, the Regenerate audio icon re-narrates it in the same voice.
  5. Click away from the popover to keep the rewrite that's showing.

If you don't like the result, use Undo to return to your original text.

What It's Good At​

  • Tightening long or wordy steps
  • Adjusting tone (friendlier, more technical, punchier)
  • Fixing awkward phrasing
  • Adapting a first-draft sentence to your product voice

For net-new content generation — writing a whole demo from scratch — see AI Mode instead.

FAQs​

Does Improve with AI work in dark mode?​

Yes. The popover and its inputs render correctly in both light and dark themes.

Can I undo a "Compose with AI" rewrite?​

Yes. The rewrite is applied like any other text edit, so standard Undo reverts it.

Does it use my company's brand voice?​

Improve with AI reads from the shared Knowledge & context configured in the AI Control Center. Add your brand-voice guidance there and every AI feature (including Improve with AI) will pick it up.

Was this helpful?