Skip to content

fix: fix bunx/pnpx commands to use correct Biome even when not installed #3886

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
akx wants to merge 1 commit into
base: main
Choose a base branch
from
Open

fix: fix bunx/pnpx commands to use correct Biome even when not installed #3886

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions src/components/PackageManagerBiomeCommand.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,10 +15,10 @@ const biomeBin = "biome";
<Code frame="none" code={`npx ${biomePackage} ${command}`} lang="bash" />
</TabItem>
<TabItem label="pnpm" icon="pnpm">
<Code frame="none" code={`pnpm exec ${biomeBin} ${command}`} lang="bash" />
Copy link
Member

@ematipico ematipico Jan 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is actually correct, why was this changed?

Copy link
Author

@akx akx Jan 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For parity with the other methods.

pnpm exec expects the package to be in the workspace, but bunx, npx, pnpx will download and run:

$ cd $(mktemp -d)
/v/f/n/6/T/tmp.xbjIqOsoMt $ pnpm exec biome --help
 ERR_PNPM_RECURSIVE_EXEC_NO_PACKAGE  No package found in this workspace

/v/f/n/6/T/tmp.xbjIqOsoMt $ bunx --bun @biomejs/biome --help
Biome official CLI. Use it to check the health of your project or run it to check single files.
[...]

/v/f/n/6/T/tmp.xbjIqOsoMt $ npx @biomejs/biome --help
Biome official CLI. Use it to check the health of your project or run it to check single files.
[...]

/v/f/n/6/T/tmp.xbjIqOsoMt $ pnpx @biomejs/biome --help
Packages: +2
++
Downloading @biomejs/[email protected]: 15.40 MB/15.40 MB, done
Progress: resolved 9, reused 0, downloaded 2, added 2, done
Biome official CLI. Use it to check the health of your project or run it to check single files.
[...]

Copy link
Member

@ematipico ematipico Jan 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok, however, pnpx has been deprecated in favour of pnpm dlx

Copy link
Author

@akx akx Jan 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to this SO answer by pnpm maintainer zkochan it's not deprecated anymore as of 2024.

Would you like me to change pnpxes to pnpm dlxes anyhow?

<Code frame="none" code={`pnpx ${biomePackage} ${command}`} lang="bash" />
</TabItem>
<TabItem label="bun" icon="bun">
<Code frame="none" code={`bunx --bun ${biomeBin} ${command}`} lang="bash" />
<Code frame="none" code={`bunx --bun ${biomePackage} ${command}`} lang="bash" />
</TabItem>
<TabItem label="deno" icon="deno">
<Code
Expand Down
32 changes: 16 additions & 16 deletions src/content/docs/guides/getting-started.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ also available as a [standalone executable] that doesn't require Node.js.

:::note[Version pinning]
`-E` ensures that the package manager pins the version of Biome. See the
[versioning page](/internals/versioning)
[versioning page](/internals/versioning)
for more information about [why pinning the version is important].
:::

Expand Down Expand Up @@ -73,43 +73,43 @@ npx @biomejs/biome check --write <files>
<TabItem label="pnpm" icon="pnpm">
<Code frame="none" code={`
# Format all files
pnpm exec biome format --write
pnpx @biomejs/biome format --write

# Format specific files
pnpm exec biome format --write <files>
pnpx @biomejs/biome format --write <files>

# Lint and apply safe fixes to all files
pnpm exec biome lint --write
pnpx @biomejs/biome lint --write

# Lint files and apply safe fixes to specific files
pnpm exec biome lint --write <files>
pnpx @biomejs/biome lint --write <files>

# Format, lint, and organize imports of all files
pnpm exec biome check --write
pnpx @biomejs/biome check --write

# Format, lint, and organize imports of specific files
pnpm exec biome check --write <files>
pnpx @biomejs/biome check --write <files>
`} lang="bash" />
</TabItem>
<TabItem label="bun" icon="bun">
<Code frame="none" code={`
# Format all files
bunx biome format --write
bunx --bun @biomejs/biome format --write

# Format specific files
bunx biome format --write <files>
bunx --bun @biomejs/biome format --write <files>

# Lint and apply safe fixes to all files
bunx biome lint --write
bunx --bun @biomejs/biome lint --write

# Lint files and apply safe fixes to specific files
bunx biome lint --write <files>
bunx --bun @biomejs/biome lint --write <files>

# Format, lint, and organize imports of all files
bunx biome check --write
bunx --bun @biomejs/biome check --write

# Format, lint, and organize imports of specific files
bunx biome check --write <files>
bunx --bun @biomejs/biome check --write <files>
Comment on lines +97 to +112
Copy link
Member

@Netail Netail Feb 4, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not don't think we should use the --bun flag here, as this sets bun as the specific runtime. You can also use bun as a package manager with the nodejs runtime

Copy link
Author

@akx akx Feb 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This mirrors what is in main:

website/src/components/PackageManagerBiomeCommand.astro

Line 21 in eddb498

<Code frame="none" code={`bunx --bun ${biomeBin} ${command}`} lang="bash" />

`} lang="bash" />
</TabItem>
<TabItem label="deno" icon="deno">
Expand Down Expand Up @@ -164,13 +164,13 @@ Biome is available as a first-party extension in your favorite editors.
- [IntelliJ](/guides/editors/first-party-extensions#intellij)
- [Zed](/guides/editors/first-party-extensions#zed)

There are also [community extensions](/guides/editors/third-party-extensions)
for other editors, such as **Vim**, **Neovim**, and **Sublime Text**, to name
There are also [community extensions](/guides/editors/third-party-extensions)
for other editors, such as **Vim**, **Neovim**, and **Sublime Text**, to name
a few.

### Continuous Integration

Run `biome ci` as part of your CI pipeline to enforce code quality and consistency
Run `biome ci` as part of your CI pipeline to enforce code quality and consistency
across your team. It works just like the `biome check` command, but is optimized for
CI environments.

Expand Down
32 changes: 16 additions & 16 deletions src/content/docs/pl/guides/getting-started.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ również dostępny jako [samodzielny plik wykonywalny], który nie wymaga Node.

:::note[Przypinanie wersji]
`-E` zapewnia, że menedżer pakietów przypnie wersję Biome. Zobacz
[stronę o wersjonowaniu](/internals/versioning)
[stronę o wersjonowaniu](/internals/versioning)
aby uzyskać więcej informacji o tym, [dlaczego przypinanie wersji jest ważne].
Comment on lines 25 to 28
Copy link
Contributor

@coderabbitai coderabbitai bot Jan 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Add the comma before “aby”.
This reads more naturally in Polish.

✍️ Suggested fix 
-`-E` zapewnia, że menedżer pakietów przypnie wersję Biome. Zobacz
-[stronę o wersjonowaniu](/internals/versioning)
-aby uzyskać więcej informacji o tym, [dlaczego przypinanie wersji jest ważne].
+`-E` zapewnia, że menedżer pakietów przypnie wersję Biome. Zobacz
+[stronę o wersjonowaniu](/internals/versioning),
+aby uzyskać więcej informacji o tym, [dlaczego przypinanie wersji jest ważne].
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
:::note[Przypinanie wersji]
`-E` zapewnia, że menedżer pakietów przypnie wersję Biome. Zobacz
[stronę o wersjonowaniu](/internals/versioning)
[stronę o wersjonowaniu](/internals/versioning)
aby uzyskać więcej informacji o tym, [dlaczego przypinanie wersji jest ważne].
:::note[Przypinanie wersji]
`-E` zapewnia, że menedżer pakietów przypnie wersję Biome. Zobacz
[stronę o wersjonowaniu](/internals/versioning),
aby uzyskać więcej informacji o tym, [dlaczego przypinanie wersji jest ważne].
🧰 Tools
🪛 LanguageTool

[typographical] ~27-~27: Przed tym spójnikiem stawiamy przecinek: "), aby".
Context: ...ję Biome. Zobacz stronę o wersjonowaniu aby uzyskać więcej informacji o tym, [dlacz...

(BRAK_PRZECINKA_ZEBY)

[typographical] ~28-~28: Znaków interpunkcyjnych nie stawia się na początku zdania.
Context: ...laczego przypinanie wersji jest ważne]. ::: [dlaczego przypinanie wersji jest waż...

(ZNAK_INTERPUNKCYJNY_NA_POCZATKU_ZDANIA)

🤖 Prompt for AI Agents 
In `@src/content/docs/pl/guides/getting-started.mdx` around lines 25 - 28, The
sentence inside the note block titled "Przypinanie wersji" is missing a comma
before the conjunction "aby"; update the sentence "`-E` zapewnia, że menedżer
pakietów przypnie wersję Biome. Zobacz [stronę o
wersjonowaniu](/internals/versioning) aby uzyskać więcej informacji o tym,
[dlaczego przypinanie wersji jest ważne]." by inserting a comma before "aby" so
it reads ".../versioning), aby uzyskać więcej informacji..." to improve natural
Polish punctuation.

:::

Expand Down Expand Up @@ -73,43 +73,43 @@ npx @biomejs/biome check --write <files>
<TabItem label="pnpm" icon="pnpm">
<Code frame="none" code={`
# Formatuj wszystkie pliki
pnpm exec biome format --write
pnpx @biomejs/biome format --write

# Formatuj określone pliki
pnpm exec biome format --write <files>
pnpx @biomejs/biome format --write <files>

# Lintuj i zastosuj bezpieczne poprawki do wszystkich plików
pnpm exec biome lint --write
pnpx @biomejs/biome lint --write

# Lintuj pliki i zastosuj bezpieczne poprawki do określonych plików
pnpm exec biome lint --write <files>
pnpx @biomejs/biome lint --write <files>

# Formatuj, lintuj i organizuj importy wszystkich plików
pnpm exec biome check --write
pnpx @biomejs/biome check --write

# Formatuj, lintuj i organizuj importy określonych plików
pnpm exec biome check --write <files>
pnpx @biomejs/biome check --write <files>
`} lang="bash" />
</TabItem>
<TabItem label="bun" icon="bun">
<Code frame="none" code={`
# Formatuj wszystkie pliki
bunx biome format --write
bunx --bun @biomejs/biome format --write

# Formatuj określone pliki
bunx biome format --write <files>
bunx --bun @biomejs/biome format --write <files>

# Lintuj i zastosuj bezpieczne poprawki do wszystkich plików
bunx biome lint --write
bunx --bun @biomejs/biome lint --write

# Lintuj pliki i zastosuj bezpieczne poprawki do określonych plików
bunx biome lint --write <files>
bunx --bun @biomejs/biome lint --write <files>

# Formatuj, lintuj i organizuj importy wszystkich plików
bunx biome check --write
bunx --bun @biomejs/biome check --write

# Formatuj, lintuj i organizuj importy określonych plików
bunx biome check --write <files>
bunx --bun @biomejs/biome check --write <files>
`} lang="bash" />
</TabItem>
<TabItem label="deno" icon="deno">
Expand Down Expand Up @@ -164,13 +164,13 @@ Biome jest dostępny jako oficjalne rozszerzenie w Twoich ulubionych edytorach.
- [IntelliJ](/guides/editors/first-party-extensions#intellij)
- [Zed](/guides/editors/first-party-extensions#zed)

Dostępne są również [rozszerzenia społeczności](/guides/editors/third-party-extensions)
dla innych edytorów, takich jak **Vim**, **Neovim** i **Sublime Text**, żeby wymienić
Dostępne są również [rozszerzenia społeczności](/guides/editors/third-party-extensions)
dla innych edytorów, takich jak **Vim**, **Neovim** i **Sublime Text**, żeby wymienić
tylko kilka.

### Ciągła integracja

Uruchom `biome ci` jako część swojego pipeline CI, aby wymuszać jakość kodu i spójność
Uruchom `biome ci` jako część swojego pipeline CI, aby wymuszać jakość kodu i spójność
w całym zespole. Działa tak samo jak polecenie `biome check`, ale jest zoptymalizowane dla
środowisk CI.

Expand Down
24 changes: 12 additions & 12 deletions src/content/docs/pt-BR/guides/getting-started.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,43 +69,43 @@ npx @biomejs/biome check --write <files>
<TabItem label="pnpm" icon="pnpm">
<Code frame="none" code={`
# Formatar todos os arquivos
pnpm exec biome format --write
pnpx @biomejs/biome format --write

# Formatar arquivos específicos
pnpm exec biome format --write <files>
pnpx @biomejs/biome format --write <files>

# Fazer lint e aplicar correções seguras a todos os arquivos
pnpm exec biome lint --write
pnpx @biomejs/biome lint --write

# Fazer lint nos arquivos e aplicar correções seguras a arquivos específicos
pnpm exec biome lint --write <files>
pnpx @biomejs/biome lint --write <files>

# Formatar, fazer lint e organizar importações de todos os arquivos
pnpm exec biome check --write
pnpx @biomejs/biome check --write

# Formatar, fazer lint e organizar importações de arquivos específicos
pnpm exec biome check --write <files>
pnpx @biomejs/biome check --write <files>
`} lang="bash" />
</TabItem>
<TabItem label="bun" icon="bun">
<Code frame="none" code={`
# Formatar todos os arquivos
bunx biome format --write
bunx --bun @biomejs/biome format --write

# Formatar arquivos específicos
bunx biome format --write <files>
bunx --bun @biomejs/biome format --write <files>

# Fazer lint e aplicar correções seguras a todos os arquivos
bunx biome lint --write
bunx --bun @biomejs/biome lint --write

# Fazer lint nos arquivos e aplicar correções seguras a arquivos específicos
bunx biome lint --write <files>
bunx --bun @biomejs/biome lint --write <files>

# Formatar, fazer lint e organizar importações de todos os arquivos
bunx biome check --write
bunx --bun @biomejs/biome check --write

# Formatar, fazer lint e organizar importações de arquivos específicos
bunx biome check --write <files>
bunx --bun @biomejs/biome check --write <files>
`} lang="bash" />
</TabItem>
<TabItem label="deno" icon="deno">
Expand Down
28 changes: 14 additions & 14 deletions src/content/docs/ru/guides/getting-started.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ Biome лучше всего устанавливать в качестве dev-

:::note[Фиксация версии]
`-E` гарантирует, что пакетный менеджер зафиксирует версию Biome. Посетите
[страницу о версионировании](/internals/versioning),
[страницу о версионировании](/internals/versioning),
чтобы узнать больше о том, [почему фиксация версии важна].
:::

Expand Down Expand Up @@ -74,43 +74,43 @@ npx @biomejs/biome check --write <файлы>
<TabItem label="pnpm" icon="pnpm">
<Code frame="none" code={`
# Отформатировать все файлы
pnpm exec biome format --write
pnpx @biomejs/biome format --write

# Отформатировать выбранные файлы
pnpm exec biome format --write <файлы>
pnpx @biomejs/biome format --write <файлы>

# Выполнить линтинг и применить безопасные исправления для всех файлов
pnpm exec biome lint --write
pnpx @biomejs/biome lint --write

# Выполнить линтинг и применить безопасные исправления для выбранных файлов
pnpm exec biome lint --write <файлы>
pnpx @biomejs/biome lint --write <файлы>

# Отформатировать, выполнить линтинг и организовать импорты всех файлов
pnpm exec biome check --write
pnpx @biomejs/biome check --write

# Отформатировать, выполнить линтинг и организовать импорты выбранных файлов
pnpm exec biome check --write <файлы>
pnpx @biomejs/biome check --write <файлы>
`} lang="bash" />
</TabItem>
<TabItem label="bun" icon="bun">
<Code frame="none" code={`
# Отформатировать все файлы
bunx biome format --write
bunx --bun @biomejs/biome format --write

# Отформатировать выбранные файлы
bunx biome format --write <файлы>
bunx --bun @biomejs/biome format --write <файлы>

# Выполнить линтинг и применить безопасные исправления для всех файлов
bunx biome lint --write
bunx --bun @biomejs/biome lint --write

# Выполнить линтинг и применить безопасные исправления для выбранных файлов
bunx biome lint --write <файлы>
bunx --bun @biomejs/biome lint --write <файлы>

# Отформатировать, выполнить линтинг и организовать импорты всех файлов
bunx biome check --write
bunx --bun @biomejs/biome check --write

# Отформатировать, выполнить линтинг и организовать импорты выбранных файлов
bunx biome check --write <файлы>
bunx --bun @biomejs/biome check --write <файлы>
`} lang="bash" />
</TabItem>
<TabItem label="deno" icon="deno">
Expand Down Expand Up @@ -165,7 +165,7 @@ Biome доступен в качестве официального дополн
- [IntelliJ](/guides/editors/first-party-extensions#intellij)
- [Zed](/guides/editors/first-party-extensions#zed)

Также существуют [дополнения от сообщества](/guides/editors/third-party-extensions)
Также существуют [дополнения от сообщества](/guides/editors/third-party-extensions)
для других редакторов, таких как **Vim**, **Neovim** и **Sublime Text**, например.

### Непрерывная интеграция
Expand Down
Loading