Running Binaries

Use vpx, vp exec, and vp dlx to run binaries without switching between local installs, downloaded packages, and project-specific tools.

Overview

vpx executes a command from a local or remote npm package. It can run a package that is already available locally, download a package on demand, or target an explicit package version.

Use the other binary commands when you need stricter control:

• vpx looks for a binary in local node_modules/.bin directories, Vite+-managed global packages, and system PATH, in that order, then falls back to vp dlx. With pkg@version, --package/-p, or --shell-mode, it runs via vp dlx directly.
• vpx <file> runs a TypeScript or JavaScript file with the Vite+ script loader
• vp exec runs a command from local node_modules/.bin directories, falling back to PATH if not found
• vp dlx runs a package binary without adding it as a dependency

vpx

Use vpx for running any local or remote binary:

vpx <pkg[@version]> [args...]

Options

• -p, --package <name> installs one or more additional packages before running the command
• -c, --shell-mode executes the command inside a shell
• -s, --silent suppresses Vite+ output and only shows the command output
• --tsconfig <path> selects the tsconfig when running a script
• -v, --version prints the Vite+ version, like vp --version

Examples

vpx eslint .
vpx create-vue my-app
vpx oxlint@1.85.0 --version
vpx -p cowsay -c 'echo "hi" | cowsay'

Running Scripts

Experimental

Running script files with vpx is experimental. Its loader, oxc-node, is experimental too.

vpx also runs TypeScript and JavaScript files directly, without a tsx or ts-node dependency:

vpx ./scripts/seed.ts --dry-run
vpx scripts/build.mts
vpx --watch ./server.ts
vpx --env-file=.env ./scripts/migrate.ts
vpx --tsconfig tsconfig.scripts.json ./tools/gen.ts

When the command is a file ending in .ts, .mts, .cts, .tsx, .js, .mjs, .cjs, or .jsx, vpx runs it on the project's Node.js version, the same one vp node selects, with the oxc-node loader that ships with Vite+. The loader supports:

• TypeScript syntax that Node.js type stripping rejects: enums, namespaces, parameter properties, and JSX
• Decorators with "experimentalDecorators": true, including emitDecoratorMetadata; standard decorators are not supported yet
• tsconfig paths for import, .js imports that point at .ts files, and extensionless imports
• ESM and CommonJS, including require() of .ts files; a .cts file is CommonJS, so it uses import x = require('...') and export =, and import/export declarations there fail with an error that suggests renaming the file to .mts
• TypeScript published in node_modules
• tsconfig jsx, jsxImportSource, jsxFactory, jsxFragmentFactory, useDefineForClassFields, and verbatimModuleSyntax

Each file uses the nearest tsconfig that includes it, as tsc does. --tsconfig <path> applies one config to every file instead. Without --tsconfig, an OXC_TSCONFIG_PATH or TS_NODE_PROJECT environment variable does the same.

Options before the script, such as --watch, --inspect, --test, --env-file, --require, and --import, are passed to Node.js, and --require or --import preloads can be TypeScript too. Everything after the script, including --, is passed to the script. A missing script is an error; vpx never downloads a package for a path.

vpx does not type-check. Run vp check for that.

Scripts can also use vpx as their interpreter. Make the file executable and keep its extension:

#!/usr/bin/env vpx
// scripts/release.ts

The vpx bin of the vite-plus package runs scripts on its own, so "seed": "vpx ./scripts/seed.ts" works in package.json scripts without the global CLI. Running package binaries with vpx still needs the global CLI.

vp exec

Use vp exec to run tools already installed in your project or available in your environment.

vp exec <command> [args...]

Examples:

vp exec eslint .
vp exec tsc --noEmit

vp dlx

Use vp dlx for one-off package execution without adding the package to your project dependencies.

vp dlx <package> [args...]

Examples:

vp dlx create-vite
vp dlx oxlint@1.85.0 --version