CLI Reference

vp run

Run tasks defined in vite.config.ts or package.json scripts.

vp run [options] [task] [additional-args]

If task is omitted, an interactive selector is shown:

Select a task (↑/↓, Enter to run, Esc to clear):

  › build: vp build
    lint: vp lint

Task Argument

The [task] argument can be:

• build — runs the build task in the current package
• @my/app#build — runs the build task in a specific package

Options

Flag	Short	Description
--recursive	-r	Run in all workspace packages, in topological order
--transitive	-t	Run in the current package and its transitive dependencies
--workspace-root	-w	Run in the workspace root package
--filter <pattern>	-F	Select packages by name, directory, or glob (repeatable)
--cache	—	Enable caching for all tasks and scripts
--no-cache	—	Disable caching entirely
--ignore-depends-on	—	Skip explicit dependsOn dependencies
--verbose	-v	Show detailed execution summary
--last-details	—	Display the summary from the last run

Additional Arguments

Arguments after the task name are passed through to the task command:

vp run test --reporter verbose

Filter Patterns

Pattern	Description
@my/app	Exact package name
@my/*	Glob matching
./packages/app	By directory
{./packages/app}	By directory (braced form)
@my/app...	Package and its dependencies
...@my/core	Package and its dependents
@my/app^...	Dependencies only (exclude package itself)
...^@my/core	Dependents only (exclude package itself)
!@my/utils	Exclude a package

Multiple --filter flags are combined as a union. Exclusion filters (!) are applied after all inclusions.

vp cache clean

Delete all cached task results:

vp cache clean

Tasks will run fresh on the next invocation.