Skip to main content

Working With a Group

Group mode is the default. When it's active, the AI only sees the token group you have open in the editor. Nothing else is in scope.

Getting started​

Open a group from the sidebar, then open the AI Assistant panel. The scope selector will already show Group. Type what you need and hit send.

The AI reads all the tokens in that group: names, values, types, structure. It can create tokens, update values, rename things, and reorganize within the group. You'll see changes show up in the table as they happen.

Some things worth trying​

  • "Add a few more spacing steps between 4 and 8"
  • "The radius values feel too sharp, round them up a bit"
  • "Rename these to follow the base.border.radius naming pattern"
  • "What's the difference between radius-sm and radius-md here?"

When to use this vs Global​

Group mode is the right call most of the time. It's focused and predictable, and you won't accidentally touch parts of your project you weren't thinking about. If you're working on a specific set of tokens, whether that's color, spacing, or typography, keep it in Group mode.

Switch to Global mode when the task genuinely needs the AI to see across multiple groups, or when you're making a change that touches the whole project.