Biome Inspector
Review and manage diagnostics from your project's own Biome installation in a focused bottom panel.
Biome Inspector works entirely within your local workspace and does not collect telemetry.
Features
- View all diagnostics or filter by Errors, Warnings, and Info.
- Scan manually, when the panel opens, or after saving a file.
- Scan the active folder, a selected folder, or every folder in a multi-root workspace.
- Group related diagnostics and see how many times each issue occurs.
- Open any diagnostic at its exact source location.
- Change a Biome rule to Info, Warning, Error, or Off.
- Optionally show the latest results in the Problems panel.
- Navigate the panel using the keyboard.
Requirements
Biome Inspector needs:
- A trusted local workspace.
- A Biome configuration such as
biome.json, biome.jsonc, .biome.json, or .biome.jsonc.
@biomejs/biome version 2.4 or later installed in the workspace.
Biome Inspector uses the Biome installation owned by your project. It does not download Biome or use a global installation.
Getting started
- Open a workspace that meets the requirements above.
- Open the Command Palette.
- Run Biome Inspector: Open.
- Select Refresh to scan the workspace.
- Select a diagnostic to open its source location.
You can also open the panel from View → Open View… → Biome Inspector: Diagnostics.
By default, Biome Inspector scans when the panel is opened for the first time. You can change this behavior using the Mode control or the biomeInspector.scanMode setting.
Panel controls
| Control |
What it does |
| Refresh |
Starts a new scan. |
| Cancel |
Stops the current scan. |
| Clear |
Removes the current results. |
| Mode |
Chooses Manual, On view open, or On save scanning. |
| Scope |
Chooses which workspace folder or folders to scan. |
| View |
Switches between a flat list and grouped results. |
| Publish to Problems |
Mirrors the latest results in the Problems panel. |
Changing a rule severity
For diagnostics associated with a Biome lint rule:
- Select Set severity….
- Choose Info, Warning, Error, or Off.
- Choose the applicable Biome configuration.
- Choose the top-level rules or a matching override.
- Confirm the change if prompted.
Biome Inspector keeps existing comments and formatting. If the configuration already contains unsaved changes, the update remains unsaved so you can review it first.
Commands
Open the Command Palette and search for Biome Inspector:
| Command |
Description |
| Biome Inspector: Open |
Opens the diagnostics panel. |
| Biome Inspector: Refresh |
Starts a new scan. |
| Biome Inspector: Cancel Scan |
Stops the current scan. |
| Biome Inspector: Clear Results |
Clears the current results. |
Settings
| Setting |
Default |
Description |
biomeInspector.scanMode |
onView |
Controls whether scans run manually, when the panel opens, or after saving. |
biomeInspector.scanScope |
activeWorkspaceFolder |
Chooses the active folder or all workspace folders as the default scope. |
biomeInspector.publishToProblems |
false |
Shows the latest results in the Problems panel when enabled. |
Troubleshooting
- No Biome configuration found: Add a supported Biome configuration to the workspace.
- No project-local Biome installation found: Install
@biomejs/biome in the workspace.
- Unsupported Biome version: Update the workspace to Biome 2.4 or later.
- Biome Inspector is unavailable: Make sure the workspace is local and trusted.
- A configuration cannot be updated: Fix any syntax errors in the configuration and try again.
Privacy
Biome Inspector does not transmit your source code, diagnostics, configuration, or usage data. It does not include telemetry.
License
MIT
