Biome assist: Source Actions Beyond Linting

The assist section, new in Biome v2, configures source actions such as organizing imports and sorting object or JSON keys.

assist is the v2 home for editor-style "source actions" that are neither pure formatting nor diagnostics. Import sorting moved here from its old top-level key.

What it does

assist groups source actions you can turn on. Each action is set to "on" or "off". Examples include source.organizeImports and useSortedKeys for object and JSON key ordering. assist actions are applied by check --write and reported by biome ci when files do not match.

Common usage

biome.json

{
  "assist": {
    "enabled": true,
    "actions": {
      "source": {
        "organizeImports": "on",
        "useSortedKeys": "on"
      }
    }
  }
}

Options

Key	What it does
assist.enabled	Master switch for assist actions
actions.source.organizeImports	Sort and group imports
actions.source.useSortedKeys	Sort object / JSON keys
"on" \| "off"	Per-action level

In CI

assist actions surface in biome ci as diagnostics when a file is not in the desired state, so they can fail the build like a lint rule. Enable only the actions you actually want enforced; useSortedKeys, for example, will reorder object literals and can be disruptive if turned on mid-project.

Common errors in CI

assist is a v2 concept; on v1 there is no assist section and these keys error. If an enabled action never applies, check assist.enabled is true. useSortedKeys can cause large diffs the first time it runs; introduce it with a single biome check --write commit so later CI runs stay clean.