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

akx · 2026-01-27T07:22:43Z

Summary

The docs currently say you can do e.g. bunx --bun biome format ./src to format some files:

However, if you do this without having installed Biome in your project first, you end up running this Biome instead, which does a whole lot of nothing in this case (but thankfully nothing destructive either).

This PR fixes the bunx and pnpx commands to refer to the correct package, so the instructions here (and in other places) mirror how the npx instructions would just download-and-use the correct package, installed in the current project or not.

netlify · 2026-01-27T07:22:49Z

✅ Deploy Preview for biomejs ready!

Name	Link
🔨 Latest commit	`599dad2`
🔍 Latest deploy log	https://app.netlify.com/projects/biomejs/deploys/697867c722fa5c00085bd5b5
😎 Deploy Preview	https://deploy-preview-3886--biomejs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

coderabbitai · 2026-01-27T07:25:52Z

Walkthrough

This pull request updates CLI command examples across documentation and a component file to use the explicit @biomejs/biome package name when invoking Biome via package managers. Changes include updating pnpm examples from pnpm exec biome to pnpx @biomejs/biome, and bun examples from `bunx biome` to `bunx --bun `@biomejs/biome. The updates are applied consistently across the main documentation and localized versions in Polish, Portuguese (Brazil), and Russian, alongside minor text reflowing in sections covering editor integrations and CI usage.

Suggested labels

A-Documentation

Suggested reviewers

dyc3
arendjr

🚥 Pre-merge checks | ✅ 2

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately describes the main change: updating bunx/pnpx commands to reference the correct Biome package name (`@biomejs/biome`) instead of the local binary.
Description check	✅ Passed	The description clearly explains the issue, provides context via screenshot, and describes the fix applied across documentation files.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

coderabbitai

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@src/content/docs/pl/guides/getting-started.mdx`:
- Around line 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.

coderabbitai · 2026-01-27T07:25:55Z

src/content/docs/pl/guides/getting-started.mdx

 :::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].


⚠️ 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.

ematipico · 2026-01-27T08:14:37Z

src/components/PackageManagerBiomeCommand.astro

 		<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" />


This is actually correct, why was this changed?

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. [...]

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

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?

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

599dad2

github-actions bot added the A-Documentation label Jan 27, 2026

coderabbitai bot reviewed Jan 27, 2026

View reviewed changes

ematipico reviewed Jan 27, 2026

View reviewed changes

akx requested a review from ematipico February 2, 2026 13:50

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

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

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

akx commented Jan 27, 2026

Uh oh!

netlify bot commented Jan 27, 2026 •

edited

Loading

Uh oh!

coderabbitai bot commented Jan 27, 2026

Uh oh!

coderabbitai bot left a comment

Uh oh!

coderabbitai bot Jan 27, 2026

Uh oh!

ematipico Jan 27, 2026

Uh oh!

akx Jan 27, 2026

Uh oh!

ematipico Jan 27, 2026

Uh oh!

akx Jan 27, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

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

Are you sure you want to change the base?

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

Conversation

akx commented Jan 27, 2026

Summary

Uh oh!

netlify bot commented Jan 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for biomejs ready!

Uh oh!

coderabbitai bot commented Jan 27, 2026

Walkthrough

Suggested labels

Suggested reviewers

Uh oh!

coderabbitai bot left a comment

Choose a reason for hiding this comment

Uh oh!

coderabbitai bot Jan 27, 2026

Choose a reason for hiding this comment

Uh oh!

ematipico Jan 27, 2026

Choose a reason for hiding this comment

Uh oh!

akx Jan 27, 2026

Choose a reason for hiding this comment

Uh oh!

ematipico Jan 27, 2026

Choose a reason for hiding this comment

Uh oh!

akx Jan 27, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

netlify bot commented Jan 27, 2026 •

edited

Loading