diffplug · lkoe · Jan 8, 2026 · Jan 8, 2026 · Jan 8, 2026 · Jan 8, 2026
diff --git a/lib/src/main/java/com/diffplug/spotless/biome/BiomeSettings.java b/lib/src/main/java/com/diffplug/spotless/biome/BiomeSettings.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023-2025 DiffPlug
+ * Copyright 2023-2026 DiffPlug
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -25,7 +25,7 @@ public final class BiomeSettings {
 	private static final Logger LOGGER = LoggerFactory.getLogger(BiomeSettings.class);
 
 	private static final String CONFIG_NAME = "biome.json";
-	private static final String DEFAULT_VERSION = "1.2.0";
+	private static final String DEFAULT_VERSION = "2.3.11";
 	private static final String DOWNLOAD_FILE_PATTERN = "biome-%s-%s-%s";
 	private static final String SHORT_NAME = "biome";
 	private static final String URL_PATTERN_1X = "https://github.com/biomejs/biome/releases/download/cli%%2Fv%s/biome-%s";
@@ -58,7 +58,7 @@ public static String getDownloadFilePattern() {
 	}
 
 	/**
-	 * @param version The biome version for which to get the URL pattern, e.g. 1.2.0 or 2.0.6.
+	 * @param version The biome version for which to get the URL pattern, e.g. 1.8.3 or 2.3.11.
 	 * @return The pattern for {@link String#formatted(Object...)
 	 *         String.format()} for the URL where the executables can be downloaded.
 	 *         The first parameter is the version, the second parameter is the OS /

diff --git a/lib/src/main/java/com/diffplug/spotless/biome/BiomeStep.java b/lib/src/main/java/com/diffplug/spotless/biome/BiomeStep.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2016-2025 DiffPlug
+ * Copyright 2016-2026 DiffPlug
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -393,7 +393,9 @@ private String[] buildBiomeCommand(File file) {
 			var fileName = resolveFileName(file);
 			var argList = new ArrayList<String>();
 			argList.add(pathToExe);
-			argList.add("format");
+			argList.add("check");
+			argList.add("--write");
+			argList.add("--linter-enabled=false");
 			argList.add("--stdin-file-path");
 			argList.add(fileName);
 			if (configPath != null) {

diff --git a/plugin-gradle/CHANGES.md b/plugin-gradle/CHANGES.md
@@ -10,6 +10,7 @@ We adhere to the [keepachangelog](https://keepachangelog.com/en/1.0.0/) format (
 ### Changes
 * Bump default `ktlint` version to latest `1.7.1` -> `1.8.0`. ([2763](https://github.com/diffplug/spotless/pull/2763))
 * Bump default `gherkin-utils` version to latest `9.2.0` -> `10.0.0`. ([#2619](https://github.com/diffplug/spotless/pull/2619))
+* Biome command changed to allow for configuring/running [Biome assists](https://biomejs.dev/assist/), such as `organizeImports`. ([#2801](https://github.com/diffplug/spotless/pull/2801))
 
 ## [8.1.0] - 2025-11-18
 ### Changes

diff --git a/plugin-gradle/README.md b/plugin-gradle/README.md
@@ -1543,7 +1543,7 @@ To download the Biome binary from the network, just specify a version:
 spotless {
   format 'biome', {
     target '**/*.js','**/*.ts','**/*.json'
-    biome('1.2.0')
+    biome('2.3.11')
   }
 }
 ```
@@ -1558,7 +1558,7 @@ spotless {
   format 'biome', {
     target '**/*.js','**/*.ts','**/*.json'
      // Relative paths are resolved against the project's base directory
-    biome('1.2.0').downloadDir("${project.gradle.gradleUserHomeDir}/biome")
+    biome('2.3.11').downloadDir("${project.gradle.gradleUserHomeDir}/biome")
   }
 }
 ```
@@ -1639,7 +1639,7 @@ you can force a certain language like this:
 spotless {
   format 'biome', {
     target 'src/**/typescript/**/*.mjson'
-    biome('1.2.0').language('json')
+    biome('2.3.11').language('json')
   }
 }
 ```

diff --git a/plugin-gradle/src/test/java/com/diffplug/gradle/spotless/BiomeIntegrationTest.java b/plugin-gradle/src/test/java/com/diffplug/gradle/spotless/BiomeIntegrationTest.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023-2025 DiffPlug
+ * Copyright 2023-2026 DiffPlug
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -95,7 +95,7 @@ void asGenericStep() throws Exception {
 				"spotless {",
 				"    format 'mybiome', {",
 				"        target '**/*.js'",
-				"        biome('1.2.0')",
+				"        biome('2.3.11')",
 				"    }",
 				"}");
 		setFile("biome_test.js").toResource("biome/js/fileBefore.js");
@@ -120,7 +120,7 @@ void asJavaScriptStep() throws Exception {
 				"spotless {",
 				"    javascript {",
 				"        target '**/*.js'",
-				"        biome('1.2.0')",
+				"        biome('2.3.11')",
 				"    }",
 				"}");
 		setFile("biome_test.js").toResource("biome/js/fileBefore.js");
@@ -145,7 +145,7 @@ void asJsonStep() throws Exception {
 				"spotless {",
 				"    json {",
 				"        target '**/*.json'",
-				"        biome('1.2.0')",
+				"        biome('2.3.11')",
 				"    }",
 				"}");
 		setFile("biome_test.json").toResource("biome/json/fileBefore.json");
@@ -170,7 +170,7 @@ void asTypeScriptStep() throws Exception {
 				"spotless {",
 				"    typescript {",
 				"        target '**/*.ts'",
-				"        biome('1.2.0')",
+				"        biome('2.3.11')",
 				"    }",
 				"}");
 		setFile("biome_test.ts").toResource("biome/ts/fileBefore.ts");
@@ -195,7 +195,7 @@ void canSetLanguageForGenericStep() throws Exception {
 				"spotless {",
 				"    format 'mybiome', {",
 				"        target '**/*.nosj'",
-				"        biome('1.2.0').language('json')",
+				"        biome('2.3.11').language('json')",
 				"    }",
 				"}");
 		setFile("biome_test.nosj").toResource("biome/json/fileBefore.json");
@@ -221,7 +221,7 @@ void configPathAbsolute() throws Exception {
 				"spotless {",
 				"    format 'mybiome', {",
 				"        target '**/*.js'",
-				"        biome('1.2.0').configPath('" + Encode.forJava(path) + "')",
+				"        biome('2.3.11').configPath('" + Encode.forJava(path) + "')",
 				"    }",
 				"}");
 		setFile("biome_test.js").toResource("biome/js/longLineBefore.js");
@@ -276,7 +276,7 @@ void configPathLineWidth120() throws Exception {
 				"spotless {",
 				"    format 'mybiome', {",
 				"        target '**/*.js'",
-				"        biome('1.2.0').configPath('configs')",
+				"        biome('2.3.11').configPath('configs')",
 				"    }",
 				"}");
 		setFile("biome_test.js").toResource("biome/js/longLineBefore.js");
@@ -303,7 +303,7 @@ void configPathLineWidth80() throws Exception {
 				"spotless {",
 				"    format 'mybiome', {",
 				"        target '**/*.js'",
-				"        biome('1.2.0').configPath('configs')",
+				"        biome('2.3.11').configPath('configs')",
 				"    }",
 				"}");
 		setFile("biome_test.js").toResource("biome/js/longLineBefore.js");
@@ -330,7 +330,7 @@ void downloadDirAbsolute() throws Exception {
 				"spotless {",
 				"    format 'mybiome', {",
 				"        target '**/*.js'",
-				"        biome('1.2.0').downloadDir('" + Encode.forJava(path) + "')",
+				"        biome('2.3.11').downloadDir('" + Encode.forJava(path) + "')",
 				"    }",
 				"}");
 		setFile("biome_test.js").toResource("biome/js/fileBefore.js");
@@ -358,7 +358,7 @@ void downloadDirRelative() throws Exception {
 				"spotless {",
 				"    format 'mybiome', {",
 				"        target '**/*.js'",
-				"        biome('1.2.0').downloadDir('target/bin/biome')",
+				"        biome('2.3.11').downloadDir('target/bin/biome')",
 				"    }",
 				"}");
 		setFile("biome_test.js").toResource("biome/js/fileBefore.js");
@@ -385,7 +385,7 @@ void failureWhenExeNotFound() throws Exception {
 				"spotless {",
 				"    format 'mybiome', {",
 				"        target '**/*.js'",
-				"        biome('1.2.0').pathToExe('biome/is/missing')",
+				"        biome('2.3.11').pathToExe('biome/is/missing')",
 				"    }",
 				"}");
 		setFile("biome_test.js").toResource("biome/js/fileBefore.js");
@@ -412,7 +412,7 @@ void failureWhenNotParseable() throws Exception {
 				"spotless {",
 				"    format 'mybiome', {",
 				"        target '**/*.js'",
-				"        biome('1.2.0').language('json')",
+				"        biome('2.3.11').language('json')",
 				"    }",
 				"}");
 		setFile("biome_test.js").toResource("biome/js/fileBefore.js");
@@ -445,7 +445,7 @@ void preservesIgnoredFiles() throws Exception {
 				"spotless {",
 				"    json {",
 				"        target '**/*.json'",
-				"        biome('1.5.0')",
+				"        biome('1.8.0')",
 				"    }",
 				"}");
 		setFile("package.json").toResource("biome/json/packageBefore.json");

diff --git a/plugin-maven/CHANGES.md b/plugin-maven/CHANGES.md
@@ -10,6 +10,8 @@ We adhere to the [keepachangelog](https://keepachangelog.com/en/1.0.0/) format (
 ### Changes
 * Bump default `ktlint` version to latest `1.7.1` -> `1.8.0`. ([2763](https://github.com/diffplug/spotless/pull/2763))
 * Bump default `gherkin-utils` version to latest `9.2.0` -> `10.0.0`. ([#2619](https://github.com/diffplug/spotless/pull/2619))
+* Biome command changed to allow for configuring/running [Biome assists](https://biomejs.dev/assist/), such as `organizeImports`. ([#2801](https://github.com/diffplug/spotless/pull/2801))
+
 
 ## [3.1.0] - 2025-11-18
 ### Changes

diff --git a/plugin-maven/README.md b/plugin-maven/README.md
@@ -1709,7 +1709,7 @@ you can force a certain language like this:
       </includes>
 
       <biome>
-        <version>1.2.0</version>
+        <version>2.3.11</version>
         <language>json</language>
       </biome>
     </format>

diff --git a/plugin-maven/src/test/java/com/diffplug/spotless/maven/biome/BiomeMavenTest.java b/plugin-maven/src/test/java/com/diffplug/spotless/maven/biome/BiomeMavenTest.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023-2025 DiffPlug
+ * Copyright 2023-2026 DiffPlug
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -67,7 +67,7 @@ void asCssStepStable() throws Exception {
 	 */
 	@Test
 	void asGenericStep() throws Exception {
-		writePomWithBiomeSteps("**/*.js", "<biome><version>1.2.0</version></biome>");
+		writePomWithBiomeSteps("**/*.js", "<biome><version>1.8.0</version></biome>");
 		setFile("biome_test.js").toResource("biome/js/fileBefore.js");
 		mavenRunner().withArguments("spotless:apply").runNoError();
 		assertFile("biome_test.js").sameAsResource("biome/js/fileAfter.js");
@@ -80,7 +80,7 @@ void asGenericStep() throws Exception {
 	 */
 	@Test
 	void asJavaScriptStep() throws Exception {
-		writePomWithJavascriptSteps("**/*.js", "<biome><version>1.2.0</version></biome>");
+		writePomWithJavascriptSteps("**/*.js", "<biome><version>1.8.0</version></biome>");
 		setFile("biome_test.js").toResource("biome/js/fileBefore.js");
 		mavenRunner().withArguments("spotless:apply").runNoError();
 		assertFile("biome_test.js").sameAsResource("biome/js/fileAfter.js");
@@ -93,7 +93,7 @@ void asJavaScriptStep() throws Exception {
 	 */
 	@Test
 	void asJsonStep() throws Exception {
-		writePomWithJsonSteps("**/*.json", "<biome><version>1.2.0</version></biome>");
+		writePomWithJsonSteps("**/*.json", "<biome><version>1.8.0</version></biome>");
 		setFile("biome_test.json").toResource("biome/json/fileBefore.json");
 		mavenRunner().withArguments("spotless:apply").runNoError();
 		assertFile("biome_test.json").sameAsResource("biome/json/fileAfter.json");
@@ -106,7 +106,7 @@ void asJsonStep() throws Exception {
 	 */
 	@Test
 	void asTypeScriptStep() throws Exception {
-		writePomWithTypescriptSteps("**/*.ts", "<biome><version>1.2.0</version></biome>");
+		writePomWithTypescriptSteps("**/*.ts", "<biome><version>1.8.0</version></biome>");
 		setFile("biome_test.ts").toResource("biome/ts/fileBefore.ts");
 		mavenRunner().withArguments("spotless:apply").runNoError();
 		assertFile("biome_test.ts").sameAsResource("biome/ts/fileAfter.ts");
@@ -119,7 +119,7 @@ void asTypeScriptStep() throws Exception {
 	 */
 	@Test
 	void canSetLanguageForGenericStep() throws Exception {
-		writePomWithBiomeSteps("**/*.nosj", "<biome><version>1.2.0</version><language>json</language></biome>");
+		writePomWithBiomeSteps("**/*.nosj", "<biome><version>1.8.0</version><language>json</language></biome>");
 		setFile("biome_test.nosj").toResource("biome/json/fileBefore.json");
 		mavenRunner().withArguments("spotless:apply").runNoError();
 		assertFile("biome_test.nosj").sameAsResource("biome/json/fileAfter.json");
@@ -134,7 +134,7 @@ void canSetLanguageForGenericStep() throws Exception {
 	void configPathAbsolute() throws Exception {
 		var path = newFile("configs").getAbsolutePath();
 		writePomWithBiomeSteps("**/*.js",
-				"<biome><version>1.2.0</version><configPath>" + forXml(path) + "</configPath></biome>");
+				"<biome><version>1.8.0</version><configPath>" + forXml(path) + "</configPath></biome>");
 		setFile("biome_test.js").toResource("biome/js/longLineBefore.js");
 		setFile("configs/biome.json").toResource("biome/config/line-width-120.json");
 		mavenRunner().withArguments("spotless:apply").runNoError();
@@ -166,7 +166,7 @@ void configPathFile() throws Exception {
 	 */
 	@Test
 	void configPathLineWidth120() throws Exception {
-		writePomWithBiomeSteps("**/*.js", "<biome><version>1.2.0</version><configPath>configs</configPath></biome>");
+		writePomWithBiomeSteps("**/*.js", "<biome><version>1.8.0</version><configPath>configs</configPath></biome>");
 		setFile("biome_test.js").toResource("biome/js/longLineBefore.js");
 		setFile("configs/biome.json").toResource("biome/config/line-width-120.json");
 		mavenRunner().withArguments("spotless:apply").runNoError();
@@ -181,7 +181,7 @@ void configPathLineWidth120() throws Exception {
 	 */
 	@Test
 	void configPathLineWidth80() throws Exception {
-		writePomWithBiomeSteps("**/*.js", "<biome><version>1.2.0</version><configPath>configs</configPath></biome>");
+		writePomWithBiomeSteps("**/*.js", "<biome><version>1.8.0</version><configPath>configs</configPath></biome>");
 		setFile("biome_test.js").toResource("biome/js/longLineBefore.js");
 		setFile("configs/biome.json").toResource("biome/config/line-width-80.json");
 		mavenRunner().withArguments("spotless:apply").runNoError();
@@ -197,7 +197,7 @@ void configPathLineWidth80() throws Exception {
 	void downloadDirAbsolute() throws Exception {
 		var path = newFile("target/bin/biome").getAbsoluteFile().toString();
 		writePomWithBiomeSteps("**/*.js",
-				"<biome><version>1.2.0</version><downloadDir>" + forXml(path) + "</downloadDir></biome>");
+				"<biome><version>1.8.0</version><downloadDir>" + forXml(path) + "</downloadDir></biome>");
 		setFile("biome_test.js").toResource("biome/js/fileBefore.js");
 		assertTrue(!newFile("target/bin/biome").exists() || newFile("target/bin/biome").list().length == 0);
 		mavenRunner().withArguments("spotless:apply").runNoError();
@@ -214,7 +214,7 @@ void downloadDirAbsolute() throws Exception {
 	@Test
 	void downloadDirRelative() throws Exception {
 		writePomWithBiomeSteps("**/*.js",
-				"<biome><version>1.2.0</version><downloadDir>target/bin/biome</downloadDir></biome>");
+				"<biome><version>1.8.0</version><downloadDir>target/bin/biome</downloadDir></biome>");
 		setFile("biome_test.js").toResource("biome/js/fileBefore.js");
 		assertTrue(!newFile("target/bin/biome").exists() || newFile("target/bin/biome").list().length == 0);
 		mavenRunner().withArguments("spotless:apply").runNoError();
@@ -229,7 +229,7 @@ void downloadDirRelative() throws Exception {
 	 */
 	@Test
 	void failureWhenExeNotFound() throws Exception {
-		writePomWithBiomeSteps("**/*.js", "<biome><version>1.2.0</version><pathToExe>biome/is/missing</pathToExe></biome>");
+		writePomWithBiomeSteps("**/*.js", "<biome><version>1.8.0</version><pathToExe>biome/is/missing</pathToExe></biome>");
 		setFile("biome_test.js").toResource("biome/js/fileBefore.js");
 		var result = mavenRunner().withArguments("spotless:apply").runHasError();
 		assertFile("biome_test.js").sameAsResource("biome/js/fileBefore.js");
@@ -243,7 +243,7 @@ void failureWhenExeNotFound() throws Exception {
 	 */
 	@Test
 	void failureWhenNotParseable() throws Exception {
-		writePomWithBiomeSteps("**/*.js", "<biome><version>1.2.0</version><language>json</language></biome>");
+		writePomWithBiomeSteps("**/*.js", "<biome><version>1.8.0</version><language>json</language></biome>");
 		setFile("biome_test.js").toResource("biome/js/fileBefore.js");
 		var result = mavenRunner().withArguments("spotless:apply").runHasError();
 		assertFile("biome_test.js").sameAsResource("biome/js/fileBefore.js");