[wrangler] fix: use unscoped binary name for OpenNext autoconfig commands

[MattieTK]

Fixes the wrangler deploy --x-autoconfig failure for Next.js (OpenNext) projects when the package manager is pnpm.

Description

When running wrangler deploy --x-autoconfig on a Next.js project that uses pnpm, the deploy fails because wrangler constructs an invalid build command. The OpenNext migration step completes successfully, but the subsequent build command pnpm @opennextjs/cloudflare build is not valid pnpm syntax.

Root cause

The command overrides in the Next.js autoconfig handler used the scoped package name @opennextjs/cloudflare:

buildCommandOverride: `${npx} @opennextjs/cloudflare build`,
deployCommandOverride: `${npx} @opennextjs/cloudflare deploy`,
versionCommandOverride: `${npx} @opennextjs/cloudflare upload`,

For pnpm, npx resolves to "pnpm" (from PnpmPackageManager), producing pnpm @opennextjs/cloudflare build. pnpm interprets @scope/name as a workspace filter rather than a binary name, failing with:

ERR_PNPM_RECURSIVE_EXEC_FIRST_FAIL  Command "@opennextjs/cloudflare" not found

Fix

Changed the command overrides to use the unscoped binary name opennextjs-cloudflare, which is the actual binary installed into node_modules/.bin/ by the @opennextjs/cloudflare package. This is consistent with:

• The deploy delegation in open-next.ts (line 33), which already uses opennextjs-cloudflare
• The packageJsonScriptsOverrides in the same file (lines 52–53), which also use opennextjs-cloudflare
• The Qwik handler's existing pnpm workaround, which documents this as a known class of issue

The unscoped binary name resolves correctly across all package managers: npx opennextjs-cloudflare build, pnpm opennextjs-cloudflare build, yarn opennextjs-cloudflare build, and bunx opennextjs-cloudflare build.

---

• Tests
  • Tests included/updated
  • Automated tests not possible - manual testing has been completed as follows:
  • Additional testing not necessary because: the change is a string substitution in command construction; the existing autoconfig test suite (53 tests) passes, and there are no unit tests that exercise the Next.js handler's configure() method directly (it requires a real Next.js project with @opennextjs/cloudflare installed)
• Public documentation
  • Cloudflare docs PR(s):
  • Documentation not necessary because: this is a bug fix with no user-facing API change

---

[changeset-bot]

🦋 Changeset detected

Latest commit: e3927fb

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[claude]

Claude finished @MattieTK's task —— View job

---

Changeset Review Complete

• Read changeset guidelines
• Read changeset file
• Validate changeset
• Post review findings

---

✅ All changesets look good

The changeset .changeset/fix-opennext-pnpm-scoped-binary.md is well-formatted and follows all guidelines:

• Version Type: ✅ Correctly classified as patch (bug fix)
• Changelog Quality: ✅ Clear, detailed description explaining the root cause (pnpm workspace filter interpretation) and the solution (using unscoped binary name)
• Markdown Headers: ✅ No h1/h2/h3 headers used
• Package Coverage: ✅ Correctly targets wrangler only
• Format: ✅ Follows the title + body structure with imperative description

The changeset provides excellent context about the pnpm-specific failure and clearly explains why the fix works across all package managers.

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 3 additional findings.

[pkg-pr-new]

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@12476

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@12476

miniflare

npm i https://pkg.pr.new/miniflare@12476

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@12476

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@12476

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@12476

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@12476

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@12476

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@12476

wrangler

npm i https://pkg.pr.new/wrangler@12476

commit: e3927fb

[MattieTK]

Wait for this to be merged and for tests to pass when rebased to that before merging.

[dario-piotrowicz]

Thanks Matt 🙂