bug: `vp dlx` not working inside `package.json` script command

[toddeTV]

Describe the bug

Running the following directly works as intended:

• ✅ vpx wrangler
• ✅ vp dlx wrangler
• ✅ vp exec wrangler

When extracting it into a package.json script it does not work anymore as intended.

Extracting as the following:

{
  "scripts": {
    "wrangler": "vp dlx wrangler"
  }
}

Results in:

$> vp run wrangler
VITE+ - The Unified Toolchain for the Web

$ vp dlx wrangler ⊘ cache disabled
error: Command 'dlx' not found

Using vpx wrangler or vp exec wrangler on the other hand works when inside a package.json script.

This leads to the following when wrapped inside a script command in package.json:

• ✅ vpx wrangler
• ❌ vp dlx wrangler
• ✅ vp exec wrangler

Reproduction

https://github.com/voidzero-dev/vite-plus

Steps to reproduce

1. Add "wrangler": "vp dlx wrangler" to the script commands inside the package.json file.
2. Open the terminal and run vp run wrangler.
3. Verify the error: Command 'dlx' not found output in the terminal.

System Info

$> vp env current
VITE+ - The Unified Toolchain for the Web

Environment:
  Version       24.14.0
  Source        engines.node

Tool Paths:
  node  /home/toddeTV/.vite-plus/js_runtime/node/24.14.0/bin/node
  npm   /home/toddeTV/.vite-plus/js_runtime/node/24.14.0/bin/npm
  npx   /home/toddeTV/.vite-plus/js_runtime/node/24.14.0/bin/npx



$> vp --version
VITE+ - The Unified Toolchain for the Web

vp v0.1.12

Local vite-plus:
  vite-plus  v0.1.12

Tools:
  vite             v8.0.0
  rolldown         v1.0.0-rc.9
  vitest           v4.1.0
  oxfmt            v0.40.0
  oxlint           v1.55.0
  oxlint-tsgolint  v0.17.0
  tsdown           v0.21.3

Environment:
  Package manager  pnpm v10.32.1
  Node.js          v24.x (engines.node)

Used Package Manager

pnpm

Logs

Validations

• Read the Contributing Guidelines.
• Check that there isn't already an issue for the same bug.
• Confirm this is a Vite+ issue and not an upstream issue (Vite, Vitest, tsdown, Rolldown, or Oxc).
• The provided reproduction is a minimal reproducible example.

[fengmk2]

This is a known functional difference. Currently, package manager related functionality only exists in the Global CLI, and is not included in the Local CLI installed through the vite-plus package.

[toddeTV]

This is a known functional difference. Currently, package manager related functionality only exists in the Global CLI, and is not included in the Local CLI installed through the vite-plus package.

Interesting - thanks for the clarification.
So this is an expected behavior then? If so, please feel free to just close this issue if not needed.

[fengmk2]

@toddeTV In the long run, the local CLI should include package manager functionality as well. I’ll keep this issue open to track it.

[jacobhillock]

I don't know if this relates, but after npm i -g vite-plus@latest and doing a vp migrate in a next project, I get the following:

$ vp dlx @oxlint/migrate --merge --type-aware --with-nursery --details
error: Command 'dlx' not found

Edit: I saw in the docs I should have done irm https://vite.plus/ps1 | iex, I ran that command in powershell 7, and running vp migrate in git bash I still see that same error:

$ vp migrate
VITE+ - The Unified Toolchain for the Web

◇ Set up pre-commit hooks to run formatting, linting, and type checking with auto-fixes?
  Yes

◇ Which agents are you using?
  ChatGPT (Codex)

◇ Which editor are you using?
  VSCode

◇ .vscode/settings.json already exists.
  Skip

◇ Migrate ESLint rules to Oxlint using @oxlint/migrate?
  Yes

◇ Migrate Prettier to Oxfmt?
  Yes

◐  Migrating ESLint (13s)
⚠ error: Command 'dlx' not found

You can run `vp dlx @oxlint/migrate --merge --type-aware --with-nursery --details` manually later
▲ Migration failed (0s)

ESLint migration failed. Fix the issue and re-run `vp migrate`.

[fengmk2]

@jacobhillock What you installed via npm i -g is the Local CLI, which lacks package manager related functionality. Please check #975 (comment)

[jacobhillock]

@jacobhillock What you installed via npm i -g is the Local CLI, which lacks package manager related functionality. Please check #975 (comment)

Thank you @fengmk2 , do I need to uninstall through npm before running irm https://vite.plus/ps1 | iex? If not, where can I find the steps to do a global install? Thank you again in advance!

Edit: after doing those actions:

npm uninstall -g vite-plus
irm https://vite.plus/ps1 | iex

It works as expected. Thank you!

[esafak]

This breaks compatibility with mise when vite+ is installed through its npm registry.

[fengmk2]

After the PR #1495 is merged, all package manager related commands can be run in the local CLI.