CLI

Command summary

Section titled Command summary

• biome↴
• biome version↴
• biome rage↴
• biome start↴
• biome stop↴
• biome check↴
• biome lint↴
• biome format↴
• biome ci↴
• biome init↴
• biome lsp-proxy↴
• biome migrate↴
• biome migrate prettier↴
• biome migrate eslint↴
• biome explain↴

biome

Section titled biome

Biome official CLI. Use it to check the health of your project or run it to check single files.

Usage: biome COMMAND ...

Available options:

• -h, --help — Prints help information
• -V, --version — Prints version information

Available commands:

• version — Shows the Biome version information and quit
• rage — Prints information for debugging
• start — Start the Biome daemon server process
• stop — Stop the Biome daemon server process
• check — Runs formatter, linter and import sorting to the requested files.
• lint — Run various checks on a set of files.
• format — Run the formatter on a set of files.
• ci — Command to use in CI environments. Runs formatter, linter and import sorting to the requested files.
• init — Bootstraps a new biome project. Creates a configuration file with some defaults.
• lsp-proxy — Acts as a server for the Language Server Protocol over stdin/stdout
• migrate — It updates the configuration when there are breaking changes
• explain — A command to retrieve the documentation of various aspects of the CLI.

biome version

Section titled biome version

Shows the Biome version information and quit

Usage: biome version

Global options applied to all commands

• --colors=<off|force> — Set the formatting mode for markup: “off” prints everything as plain text, “force” forces the formatting of markup using ANSI even if the console output is determined to be incompatible

• --use-server — Connect to a running instance of the Biome daemon server.

• --verbose — Print additional diagnostics, and some diagnostics show more information.

• --config-path=PATH — Set the file path to the configuration file, or the directory path to find biome.json or biome.jsonc. If used, it disables the default configuration file resolution.

• --max-diagnostics=NUMBER — Cap the amount of diagnostics displayed.

  [default: 20]

• --skip-errors — Skip over files containing syntax errors instead of emitting an error diagnostic.

• --no-errors-on-unmatched — Silence errors that would be emitted in case no files were processed during the execution of the command.

• --error-on-warnings — Tell Biome to exit with an error code if some diagnostics emit warnings.

• --reporter=<json|json-pretty> — Allows to change how diagnostics and summary are reported.

• --log-level=<none|debug|info|warn|error> — The level of logging. In order, from the most verbose to the least verbose: debug, info, warn, error.

  The value none won’t show any logging.

  [default: none]

• --log-kind=<pretty|compact|json> — How the log should look like.

  [default: pretty]

• --diagnostic-level=<info|warn|error> — The level of diagnostics to show. In order, from the lowest to the most important: info, warn, error. Passing --diagnostic-level=error will cause Biome to print only diagnostics that contain only errors.

  [default: info]

Available options:

• -h, --help — Prints help information

biome rage

Section titled biome rage

Prints information for debugging

Usage: biome rage [--daemon-logs] [--formatter] [--linter]

Global options applied to all commands

• --colors=<off|force> — Set the formatting mode for markup: “off” prints everything as plain text, “force” forces the formatting of markup using ANSI even if the console output is determined to be incompatible

• --use-server — Connect to a running instance of the Biome daemon server.

• --verbose — Print additional diagnostics, and some diagnostics show more information.

• --config-path=PATH — Set the file path to the configuration file, or the directory path to find biome.json or biome.jsonc. If used, it disables the default configuration file resolution.

• --max-diagnostics=NUMBER — Cap the amount of diagnostics displayed.

  [default: 20]

• --skip-errors — Skip over files containing syntax errors instead of emitting an error diagnostic.

• --no-errors-on-unmatched — Silence errors that would be emitted in case no files were processed during the execution of the command.

• --error-on-warnings — Tell Biome to exit with an error code if some diagnostics emit warnings.

• --reporter=<json|json-pretty> — Allows to change how diagnostics and summary are reported.

• --log-level=<none|debug|info|warn|error> — The level of logging. In order, from the most verbose to the least verbose: debug, info, warn, error.

  The value none won’t show any logging.

  [default: none]

• --log-kind=<pretty|compact|json> — How the log should look like.

  [default: pretty]

• --diagnostic-level=<info|warn|error> — The level of diagnostics to show. In order, from the lowest to the most important: info, warn, error. Passing --diagnostic-level=error will cause Biome to print only diagnostics that contain only errors.

  [default: info]

Available options:

• --daemon-logs — Prints the Biome daemon server logs
• --formatter — Prints the Biome configuration that the applied formatter configuration
• --linter — Prints the Biome configuration that the applied linter configuration
• -h, --help — Prints help information

biome start

Section titled biome start

Start the Biome daemon server process

Usage: biome start [--config-path=PATH]

Available options:

• --config-path=PATH — Allows to set a custom file path to the configuration file, or a custom directory path to find biome.json or biome.jsonc

  Uses environment variable BIOME_CONFIG_PATH

• -h, --help — Prints help information

biome stop

Section titled biome stop

Stop the Biome daemon server process

Usage: biome stop

Available options:

• -h, --help — Prints help information

biome check

Section titled biome check

Runs formatter, linter and import sorting to the requested files.

Usage: biome check [--apply] [--apply-unsafe] [--staged] [--changed] [--since=REF] [PATH]…

The configuration that is contained inside the file biome.json

• --vcs-client-kind=<git> — The kind of client.

• --vcs-enabled=<true|false> — Whether Biome should integrate itself with the VCS client

• --vcs-use-ignore-file=<true|false> — Whether Biome should use the VCS ignore file. When [true], Biome will ignore the files specified in the ignore file.

• --vcs-root=PATH — The folder where Biome should check for VCS files. By default, Biome will use the same folder where biome.json was found.

  If Biome can’t find the configuration, it will attempt to use the current working directory. If no current working directory can’t be found, Biome won’t use the VCS integration, and a diagnostic will be emitted

• --vcs-default-branch=BRANCH — The main branch of the project

• --files-max-size=NUMBER — The maximum allowed size for source code files in bytes. Files above this limit will be ignored for performance reasons. Defaults to 1 MiB

• --files-ignore-unknown=<true|false> — Tells Biome to not emit diagnostics when handling files that doesn’t know

• --indent-style=<tab|space> — The indent style.

• --indent-size=NUMBER — The size of the indentation, 2 by default (deprecated, use indent-width)

• --indent-width=NUMBER — The size of the indentation, 2 by default

• --line-ending=<lf|crlf|cr> — The type of line ending.

• --line-width=NUMBER — What’s the max width of a line. Defaults to 80.

• --attribute-position=<multiline|auto> — The attribute position style in HTMLish languages. By default auto.

• --jsx-quote-style=<double|single> — The type of quotes used in JSX. Defaults to double.

• --quote-properties=<preserve|as-needed> — When properties in objects are quoted. Defaults to asNeeded.

• --trailing-comma=<all|es5|none> — Print trailing commas wherever possible in multi-line comma-separated syntactic structures. Defaults to “all”.

• --semicolons=<always|as-needed> — Whether the formatter prints semicolons for all statements or only in for statements where it is necessary because of ASI.

• --arrow-parentheses=<always|as-needed> — Whether to add non-necessary parentheses to arrow functions. Defaults to “always”.

• --bracket-spacing=<true|false> — Whether to insert spaces around brackets in object literals. Defaults to true.

• --bracket-same-line=<true|false> — Whether to hug the closing bracket of multiline HTML/JSX tags to the end of the last line, rather than being alone on the following line. Defaults to false.

• --javascript-formatter-enabled=<true|false> — Control the formatter for JavaScript (and its super languages) files.

• --javascript-formatter-indent-style=<tab|space> — The indent style applied to JavaScript (and its super languages) files.

• --javascript-formatter-indent-size=NUMBER — The size of the indentation applied to JavaScript (and its super languages) files. Default to 2.

• --javascript-formatter-indent-width=NUMBER — The size of the indentation applied to JavaScript (and its super languages) files. Default to 2.

• --javascript-formatter-line-ending=<lf|crlf|cr> — The type of line ending applied to JavaScript (and its super languages) files.

• --javascript-formatter-line-width=NUMBER — What’s the max width of a line applied to JavaScript (and its super languages) files. Defaults to 80.

• --quote-style=<double|single> — The type of quotes used in JavaScript code. Defaults to double.

• --javascript-attribute-position=<multiline|auto> — The attribute position style in jsx elements. Defaults to auto.

• --json-formatter-enabled=<true|false> — Control the formatter for JSON (and its super languages) files.

• --json-formatter-indent-style=<tab|space> — The indent style applied to JSON (and its super languages) files.

• --json-formatter-indent-width=NUMBER — The size of the indentation applied to JSON (and its super languages) files. Default to 2.

• --json-formatter-indent-size=NUMBER — The size of the indentation applied to JSON (and its super languages) files. Default to 2.

• --json-formatter-line-ending=<lf|crlf|cr> — The type of line ending applied to JSON (and its super languages) files.

• --json-formatter-line-width=NUMBER — What’s the max width of a line applied to JSON (and its super languages) files. Defaults to 80.

• --json-formatter-trailing-commas=<none|all> — Print trailing commas wherever possible in multi-line comma-separated syntactic structures. Defaults to “none”.

Global options applied to all commands

• --colors=<off|force> — Set the formatting mode for markup: “off” prints everything as plain text, “force” forces the formatting of markup using ANSI even if the console output is determined to be incompatible

• --use-server — Connect to a running instance of the Biome daemon server.

• --verbose — Print additional diagnostics, and some diagnostics show more information.

• --config-path=PATH — Set the file path to the configuration file, or the directory path to find biome.json or biome.jsonc. If used, it disables the default configuration file resolution.

• --max-diagnostics=NUMBER — Cap the amount of diagnostics displayed.

  [default: 20]

• --skip-errors — Skip over files containing syntax errors instead of emitting an error diagnostic.

• --no-errors-on-unmatched — Silence errors that would be emitted in case no files were processed during the execution of the command.

• --error-on-warnings — Tell Biome to exit with an error code if some diagnostics emit warnings.

• --reporter=<json|json-pretty> — Allows to change how diagnostics and summary are reported.

• --log-level=<none|debug|info|warn|error> — The level of logging. In order, from the most verbose to the least verbose: debug, info, warn, error.

  The value none won’t show any logging.

  [default: none]

• --log-kind=<pretty|compact|json> — How the log should look like.

  [default: pretty]

• --diagnostic-level=<info|warn|error> — The level of diagnostics to show. In order, from the lowest to the most important: info, warn, error. Passing --diagnostic-level=error will cause Biome to print only diagnostics that contain only errors.

  [default: info]

Available positional items:

• PATH — Single file, single path or list of paths

Available options:

• --apply — Apply safe fixes, formatting and import sorting

• --apply-unsafe — Apply safe fixes and unsafe fixes, formatting and import sorting

• --formatter-enabled=<true|false> — Allow to enable or disable the formatter check.

• --linter-enabled=<true|false> — Allow to enable or disable the linter check.

• --organize-imports-enabled=<true|false> — Allow to enable or disable the organize imports.

• --stdin-file-path=PATH — Use this option when you want to format code piped from stdin, and print the output to stdout.

  The file doesn’t need to exist on disk, what matters is the extension of the file. Based on the extension, Biome knows how to check the code.

  Example: echo 'let a;' | biome check --stdin-file-path=file.js

• --staged — When set to true, only the files that have been staged (the ones prepared to be committed) will be linted.

• --changed — When set to true, only the files that have been changed compared to your defaultBranch configuration will be linted.

• --since=REF — Use this to specify the base branch to compare against when you’re using the —changed flag and the defaultBranch is not set in your biome.json

• -h, --help — Prints help information

biome lint

Section titled biome lint

Run various checks on a set of files.

Usage: biome lint [--apply] [--apply-unsafe] [--staged] [--changed] [--since=REF] [PATH]…

Set of properties to integrate Biome with a VCS software.

• --vcs-client-kind=<git> — The kind of client.

• --vcs-enabled=<true|false> — Whether Biome should integrate itself with the VCS client

• --vcs-use-ignore-file=<true|false> — Whether Biome should use the VCS ignore file. When [true], Biome will ignore the files specified in the ignore file.

• --vcs-root=PATH — The folder where Biome should check for VCS files. By default, Biome will use the same folder where biome.json was found.

  If Biome can’t find the configuration, it will attempt to use the current working directory. If no current working directory can’t be found, Biome won’t use the VCS integration, and a diagnostic will be emitted

• --vcs-default-branch=BRANCH — The main branch of the project

The configuration of the filesystem

• --files-max-size=NUMBER — The maximum allowed size for source code files in bytes. Files above this limit will be ignored for performance reasons. Defaults to 1 MiB
• --files-ignore-unknown=<true|false> — Tells Biome to not emit diagnostics when handling files that doesn’t know

Global options applied to all commands

• --colors=<off|force> — Set the formatting mode for markup: “off” prints everything as plain text, “force” forces the formatting of markup using ANSI even if the console output is determined to be incompatible

• --use-server — Connect to a running instance of the Biome daemon server.

• --verbose — Print additional diagnostics, and some diagnostics show more information.

• --config-path=PATH — Set the file path to the configuration file, or the directory path to find biome.json or biome.jsonc. If used, it disables the default configuration file resolution.

• --max-diagnostics=NUMBER — Cap the amount of diagnostics displayed.

  [default: 20]

• --skip-errors — Skip over files containing syntax errors instead of emitting an error diagnostic.

• --no-errors-on-unmatched — Silence errors that would be emitted in case no files were processed during the execution of the command.

• --error-on-warnings — Tell Biome to exit with an error code if some diagnostics emit warnings.

• --reporter=<json|json-pretty> — Allows to change how diagnostics and summary are reported.

• --log-level=<none|debug|info|warn|error> — The level of logging. In order, from the most verbose to the least verbose: debug, info, warn, error.

  The value none won’t show any logging.

  [default: none]

• --log-kind=<pretty|compact|json> — How the log should look like.

  [default: pretty]

• --diagnostic-level=<info|warn|error> — The level of diagnostics to show. In order, from the lowest to the most important: info, warn, error. Passing --diagnostic-level=error will cause Biome to print only diagnostics that contain only errors.

  [default: info]

Available positional items:

• PATH — Single file, single path or list of paths

Available options:

• --apply — Apply safe fixes, formatting and import sorting

• --apply-unsafe — Apply safe fixes and unsafe fixes, formatting and import sorting

• --stdin-file-path=PATH — Use this option when you want to format code piped from stdin, and print the output to stdout.

  The file doesn’t need to exist on disk, what matters is the extension of the file. Based on the extension, Biome knows how to lint the code.

  Example: echo 'let a;' | biome lint --stdin-file-path=file.js

• --staged — When set to true, only the files that have been staged (the ones prepared to be committed) will be linted.

• --changed — When set to true, only the files that have been changed compared to your defaultBranch configuration will be linted.

• --since=REF — Use this to specify the base branch to compare against when you’re using the —changed flag and the defaultBranch is not set in your biome.json

• -h, --help — Prints help information

biome format

Section titled biome format

Run the formatter on a set of files.

Usage: biome format [--write] [--staged] [--changed] [--since=REF] [PATH]…

Generic options applied to all files

• --indent-style=<tab|space> — The indent style.
• --indent-size=NUMBER — The size of the indentation, 2 by default (deprecated, use indent-width)
• --indent-width=NUMBER — The size of the indentation, 2 by default
• --line-ending=<lf|crlf|cr> — The type of line ending.
• --line-width=NUMBER — What’s the max width of a line. Defaults to 80.
• --attribute-position=<multiline|auto> — The attribute position style in HTMLish languages. By default auto.

Formatting options specific to the JavaScript files

• --jsx-quote-style=<double|single> — The type of quotes used in JSX. Defaults to double.
• --quote-properties=<preserve|as-needed> — When properties in objects are quoted. Defaults to asNeeded.
• --trailing-comma=<all|es5|none> — Print trailing commas wherever possible in multi-line comma-separated syntactic structures. Defaults to “all”.
• --semicolons=<always|as-needed> — Whether the formatter prints semicolons for all statements or only in for statements where it is necessary because of ASI.
• --arrow-parentheses=<always|as-needed> — Whether to add non-necessary parentheses to arrow functions. Defaults to “always”.
• --bracket-spacing=<true|false> — Whether to insert spaces around brackets in object literals. Defaults to true.
• --bracket-same-line=<true|false> — Whether to hug the closing bracket of multiline HTML/JSX tags to the end of the last line, rather than being alone on the following line. Defaults to false.
• --javascript-formatter-enabled=<true|false> — Control the formatter for JavaScript (and its super languages) files.
• --javascript-formatter-indent-style=<tab|space> — The indent style applied to JavaScript (and its super languages) files.
• --javascript-formatter-indent-size=NUMBER — The size of the indentation applied to JavaScript (and its super languages) files. Default to 2.
• --javascript-formatter-indent-width=NUMBER — The size of the indentation applied to JavaScript (and its super languages) files. Default to 2.
• --javascript-formatter-line-ending=<lf|crlf|cr> — The type of line ending applied to JavaScript (and its super languages) files.
• --javascript-formatter-line-width=NUMBER — What’s the max width of a line applied to JavaScript (and its super languages) files. Defaults to 80.
• --quote-style=<double|single> — The type of quotes used in JavaScript code. Defaults to double.
• --javascript-attribute-position=<multiline|auto> — The attribute position style in jsx elements. Defaults to auto.

Set of properties to integrate Biome with a VCS software.

• --vcs-client-kind=<git> — The kind of client.

• --vcs-enabled=<true|false> — Whether Biome should integrate itself with the VCS client

• --vcs-use-ignore-file=<true|false> — Whether Biome should use the VCS ignore file. When [true], Biome will ignore the files specified in the ignore file.

• --vcs-root=PATH — The folder where Biome should check for VCS files. By default, Biome will use the same folder where biome.json was found.

  If Biome can’t find the configuration, it will attempt to use the current working directory. If no current working directory can’t be found, Biome won’t use the VCS integration, and a diagnostic will be emitted

• --vcs-default-branch=BRANCH — The main branch of the project

The configuration of the filesystem

• --files-max-size=NUMBER — The maximum allowed size for source code files in bytes. Files above this limit will be ignored for performance reasons. Defaults to 1 MiB
• --files-ignore-unknown=<true|false> — Tells Biome to not emit diagnostics when handling files that doesn’t know

Global options applied to all commands

• --colors=<off|force> — Set the formatting mode for markup: “off” prints everything as plain text, “force” forces the formatting of markup using ANSI even if the console output is determined to be incompatible

• --use-server — Connect to a running instance of the Biome daemon server.

• --verbose — Print additional diagnostics, and some diagnostics show more information.

• --config-path=PATH — Set the file path to the configuration file, or the directory path to find biome.json or biome.jsonc. If used, it disables the default configuration file resolution.

• --max-diagnostics=NUMBER — Cap the amount of diagnostics displayed.

  [default: 20]

• --skip-errors — Skip over files containing syntax errors instead of emitting an error diagnostic.

• --no-errors-on-unmatched — Silence errors that would be emitted in case no files were processed during the execution of the command.

• --error-on-warnings — Tell Biome to exit with an error code if some diagnostics emit warnings.

• --reporter=<json|json-pretty> — Allows to change how diagnostics and summary are reported.

• --log-level=<none|debug|info|warn|error> — The level of logging. In order, from the most verbose to the least verbose: debug, info, warn, error.

  The value none won’t show any logging.

  [default: none]

• --log-kind=<pretty|compact|json> — How the log should look like.

  [default: pretty]

• --diagnostic-level=<info|warn|error> — The level of diagnostics to show. In order, from the lowest to the most important: info, warn, error. Passing --diagnostic-level=error will cause Biome to print only diagnostics that contain only errors.

  [default: info]

Available positional items:

• PATH — Single file, single path or list of paths.

Available options:

• --json-formatter-enabled=<true|false> — Control the formatter for JSON (and its super languages) files.

• --json-formatter-indent-style=<tab|space> — The indent style applied to JSON (and its super languages) files.

• --json-formatter-indent-width=NUMBER — The size of the indentation applied to JSON (and its super languages) files. Default to 2.

• --json-formatter-indent-size=NUMBER — The size of the indentation applied to JSON (and its super languages) files. Default to 2.

• --json-formatter-line-ending=<lf|crlf|cr> — The type of line ending applied to JSON (and its super languages) files.

• --json-formatter-line-width=NUMBER — What’s the max width of a line applied to JSON (and its super languages) files. Defaults to 80.

• --json-formatter-trailing-commas=<none|all> — Print trailing commas wherever possible in multi-line comma-separated syntactic structures. Defaults to “none”.

• --stdin-file-path=PATH — Use this option when you want to format code piped from stdin, and print the output to stdout.

  The file doesn’t need to exist on disk, what matters is the extension of the file. Based on the extension, Biome knows how to format the code.

  Example: echo 'let a;' | biome format --stdin-file-path=file.js

• --write — Writes formatted files to file system.

• --staged — When set to true, only the files that have been staged (the ones prepared to be committed) will be linted.

• --changed — When set to true, only the files that have been changed compared to your defaultBranch configuration will be linted.

• --since=REF — Use this to specify the base branch to compare against when you’re using the —changed flag and the defaultBranch is not set in your biome.json

• -h, --help — Prints help information

biome ci

Section titled biome ci

Command to use in CI environments. Runs formatter, linter and import sorting to the requested files.

Files won’t be modified, the command is a read-only operation.

Usage: biome ci [--formatter-enabled=<true|false>] [--linter-enabled=<true|false>] [--organize-imports-enabled=<true|false>] [--changed] [--since=REF] [PATH]…

The configuration that is contained inside the file biome.json

• --vcs-client-kind=<git> — The kind of client.

• --vcs-enabled=<true|false> — Whether Biome should integrate itself with the VCS client

• --vcs-use-ignore-file=<true|false> — Whether Biome should use the VCS ignore file. When [true], Biome will ignore the files specified in the ignore file.

• --vcs-root=PATH — The folder where Biome should check for VCS files. By default, Biome will use the same folder where biome.json was found.

  If Biome can’t find the configuration, it will attempt to use the current working directory. If no current working directory can’t be found, Biome won’t use the VCS integration, and a diagnostic will be emitted

• --vcs-default-branch=BRANCH — The main branch of the project

• --files-max-size=NUMBER — The maximum allowed size for source code files in bytes. Files above this limit will be ignored for performance reasons. Defaults to 1 MiB

• --files-ignore-unknown=<true|false> — Tells Biome to not emit diagnostics when handling files that doesn’t know

• --indent-style=<tab|space> — The indent style.

• --indent-size=NUMBER — The size of the indentation, 2 by default (deprecated, use indent-width)

• --indent-width=NUMBER — The size of the indentation, 2 by default

• --line-ending=<lf|crlf|cr> — The type of line ending.

• --line-width=NUMBER — What’s the max width of a line. Defaults to 80.

• --attribute-position=<multiline|auto> — The attribute position style in HTMLish languages. By default auto.

• --jsx-quote-style=<double|single> — The type of quotes used in JSX. Defaults to double.

• --quote-properties=<preserve|as-needed> — When properties in objects are quoted. Defaults to asNeeded.

• --trailing-comma=<all|es5|none> — Print trailing commas wherever possible in multi-line comma-separated syntactic structures. Defaults to “all”.

• --semicolons=<always|as-needed> — Whether the formatter prints semicolons for all statements or only in for statements where it is necessary because of ASI.

• --arrow-parentheses=<always|as-needed> — Whether to add non-necessary parentheses to arrow functions. Defaults to “always”.

• --bracket-spacing=<true|false> — Whether to insert spaces around brackets in object literals. Defaults to true.

• --bracket-same-line=<true|false> — Whether to hug the closing bracket of multiline HTML/JSX tags to the end of the last line, rather than being alone on the following line. Defaults to false.

• --javascript-formatter-enabled=<true|false> — Control the formatter for JavaScript (and its super languages) files.

• --javascript-formatter-indent-style=<tab|space> — The indent style applied to JavaScript (and its super languages) files.

• --javascript-formatter-indent-size=NUMBER — The size of the indentation applied to JavaScript (and its super languages) files. Default to 2.

• --javascript-formatter-indent-width=NUMBER — The size of the indentation applied to JavaScript (and its super languages) files. Default to 2.

• --javascript-formatter-line-ending=<lf|crlf|cr> — The type of line ending applied to JavaScript (and its super languages) files.

• --javascript-formatter-line-width=NUMBER — What’s the max width of a line applied to JavaScript (and its super languages) files. Defaults to 80.

• --quote-style=<double|single> — The type of quotes used in JavaScript code. Defaults to double.

• --javascript-attribute-position=<multiline|auto> — The attribute position style in jsx elements. Defaults to auto.

• --json-formatter-enabled=<true|false> — Control the formatter for JSON (and its super languages) files.

• --json-formatter-indent-style=<tab|space> — The indent style applied to JSON (and its super languages) files.

• --json-formatter-indent-width=NUMBER — The size of the indentation applied to JSON (and its super languages) files. Default to 2.

• --json-formatter-indent-size=NUMBER — The size of the indentation applied to JSON (and its super languages) files. Default to 2.

• --json-formatter-line-ending=<lf|crlf|cr> — The type of line ending applied to JSON (and its super languages) files.

• --json-formatter-line-width=NUMBER — What’s the max width of a line applied to JSON (and its super languages) files. Defaults to 80.

• --json-formatter-trailing-commas=<none|all> — Print trailing commas wherever possible in multi-line comma-separated syntactic structures. Defaults to “none”.

Global options applied to all commands

• --colors=<off|force> — Set the formatting mode for markup: “off” prints everything as plain text, “force” forces the formatting of markup using ANSI even if the console output is determined to be incompatible

• --use-server — Connect to a running instance of the Biome daemon server.

• --verbose — Print additional diagnostics, and some diagnostics show more information.

• --config-path=PATH — Set the file path to the configuration file, or the directory path to find biome.json or biome.jsonc. If used, it disables the default configuration file resolution.

• --max-diagnostics=NUMBER — Cap the amount of diagnostics displayed.

  [default: 20]

• --skip-errors — Skip over files containing syntax errors instead of emitting an error diagnostic.

• --no-errors-on-unmatched — Silence errors that would be emitted in case no files were processed during the execution of the command.

• --error-on-warnings — Tell Biome to exit with an error code if some diagnostics emit warnings.

• --reporter=<json|json-pretty> — Allows to change how diagnostics and summary are reported.

• --log-level=<none|debug|info|warn|error> — The level of logging. In order, from the most verbose to the least verbose: debug, info, warn, error.

  The value none won’t show any logging.

  [default: none]

• --log-kind=<pretty|compact|json> — How the log should look like.

  [default: pretty]

• --diagnostic-level=<info|warn|error> — The level of diagnostics to show. In order, from the lowest to the most important: info, warn, error. Passing --diagnostic-level=error will cause Biome to print only diagnostics that contain only errors.

  [default: info]

Available positional items:

• PATH — Single file, single path or list of paths

Available options:

• --formatter-enabled=<true|false> — Allow to enable or disable the formatter check.
• --linter-enabled=<true|false> — Allow to enable or disable the linter check.
• --organize-imports-enabled=<true|false> — Allow to enable or disable the organize imports.
• --changed — When set to true, only the files that have been changed compared to your defaultBranch configuration will be linted.
• --since=REF — Use this to specify the base branch to compare against when you’re using the —changed flag and the defaultBranch is not set in your biome.json
• -h, --help — Prints help information

biome init

Section titled biome init

Bootstraps a new biome project. Creates a configuration file with some defaults.

Usage: biome init [--jsonc]

Available options:

• --jsonc — Tells Biome to emit a biome.jsonc file.
• -h, --help — Prints help information

biome lsp-proxy

Section titled biome lsp-proxy

Acts as a server for the Language Server Protocol over stdin/stdout

Usage: biome lsp-proxy [--config-path=PATH]

Available options:

• --config-path=PATH — Allows to set a custom file path to the configuration file, or a custom directory path to find biome.json or biome.jsonc

  Uses environment variable BIOME_CONFIG_PATH

• -h, --help — Prints help information

biome migrate

Section titled biome migrate

It updates the configuration when there are breaking changes

Usage: biome migrate [--write] [COMMAND ...]

Global options applied to all commands

• --colors=<off|force> — Set the formatting mode for markup: “off” prints everything as plain text, “force” forces the formatting of markup using ANSI even if the console output is determined to be incompatible

• --use-server — Connect to a running instance of the Biome daemon server.

• --verbose — Print additional diagnostics, and some diagnostics show more information.

• --config-path=PATH — Set the file path to the configuration file, or the directory path to find biome.json or biome.jsonc. If used, it disables the default configuration file resolution.

• --max-diagnostics=NUMBER — Cap the amount of diagnostics displayed.

  [default: 20]

• --skip-errors — Skip over files containing syntax errors instead of emitting an error diagnostic.

• --no-errors-on-unmatched — Silence errors that would be emitted in case no files were processed during the execution of the command.

• --error-on-warnings — Tell Biome to exit with an error code if some diagnostics emit warnings.

• --reporter=<json|json-pretty> — Allows to change how diagnostics and summary are reported.

• --log-level=<none|debug|info|warn|error> — The level of logging. In order, from the most verbose to the least verbose: debug, info, warn, error.

  The value none won’t show any logging.

  [default: none]

• --log-kind=<pretty|compact|json> — How the log should look like.

  [default: pretty]

• --diagnostic-level=<info|warn|error> — The level of diagnostics to show. In order, from the lowest to the most important: info, warn, error. Passing --diagnostic-level=error will cause Biome to print only diagnostics that contain only errors.

  [default: info]

Available options:

• --write — Writes the new configuration file to disk
• -h, --help — Prints help information

Available commands:

• prettier — It attempts to find the files .prettierrc/prettier.json and .prettierignore, and map the Prettier’s configuration into Biome’s configuration file.
• eslint — It attempts to find the ESLint configuration file in the working directory, and update the Biome’s configuration file as a result.

biome migrate prettier

Section titled biome migrate prettier

It attempts to find the files .prettierrc/prettier.json and .prettierignore, and map the Prettier’s configuration into Biome’s configuration file.

Usage: biome migrate prettier

Available options:

• -h, --help — Prints help information

biome migrate eslint

Section titled biome migrate eslint

It attempts to find the ESLint configuration file in the working directory, and update the Biome’s configuration file as a result.

Usage: biome migrate eslint [--include-inspired] [--include-nursery]

Available options:

• --include-inspired — Includes rules inspired from an eslint rule in the migration
• --include-nursery — Includes nursery rules in the migration
• -h, --help — Prints help information

biome explain

Section titled biome explain

A command to retrieve the documentation of various aspects of the CLI.

Examples

Section titled Examples

biome explain noDebugger

biome explain daemon-logs

Usage: biome explain NAME

Available positional items:

• NAME — Single name to display documentation for.

Available options:

• -h, --help — Prints help information

Environment Variables

Section titled Environment Variables

BIOME_BINARY

Section titled BIOME_BINARY

Overrides the Biome binary being used. This allows you, for example, to use a system-wide Biome binary.

If you don’t define this variable, Biome will automatically detect the correct binary for your platform.

# Nix derivation example; the binary path comes from "${pkgs.biome}/bin/biome"
BIOME_BINARY=/nix/store/68fyfw1hidsqkal1839whi3nzgvqv4pa-biome-1.0.0/bin/biome npx @biomejs/biome format .

Useful information

Section titled Useful information

• When encountering symbolic links, the CLI will expand them until three levels deep. Deeper levels will result into an error diagnostic.