Say what a task needs
One short syntax for upstream, cross-project and pattern edges.
^build means every workspace dependency’s build first. build alone is this project’s. @demo/api#build names another project’s task, and lint.* matches every task whose name starts that way.
The edges are checked as you type in a typed config, and an edge that matches nothing is an error, not a silent no-op.
// config
// packages/web/vx.config.ts
import { defineProject } from '@vzn/vx/config'
export default defineProject({
tasks: {
build: { exec: { command: 'vite build' }, dependsOn: ['^build'] },
test: { exec: { command: 'vitest run' }, dependsOn: ['build'] },
e2e: { exec: { command: 'playwright test' }, dependsOn: ['@demo/api#build'] },
},
})More in Run what you mean
Run just the task
Skip the dependency chain when you know it is already built.
Timeouts
A hung task is killed and reported as a timeout, not left to stall the run.
Pass arguments through
Arguments after -- reach the task, and the cache keeps each set apart.
Group tasks
Name a set of tasks once and run them with one word.
Source-only packages still count
A package with no build step still moves its dependants’ cache keys when its files change.
A typo never runs half the graph
Ask for a task no project has and vx stops before anything starts.
Filter by tag
Tag projects once, then run a task across every project with that tag.
Filter by folder
Pick projects by where they live, or the root project alone.
Remote pools at their own width
Send work to a remote pool and vx fills the pool, not your laptop’s core count.
Runs take turns
Two runs in one checkout wait for each other instead of fighting over files.