DEV Community

Cover image for Output that fits the run
VX
VX

Posted on Edited on Originally published at vznjs.github.io

Output that fits the run

vx prints as much as the run needs. Ten tasks, one edit, and you see
three lines:

$ vx run build test --all
 ⏺︎    14ms success no-cache packages/e#codegen
 ⏺︎     9ms success miss     packages/b#build
 ⏺︎    15ms success miss     packages/b#test

─ vx 0.0.0 ───────────────────────────────────────────────────
  projects  5 affected · 6 total
  tasks     10 success · 10 total
  cache     local 3✓ 1∅ 4↓ 2↑
  time      61ms · max 15ms · avg 13ms · min 9ms
Enter fullscreen mode Exit fullscreen mode

The seven cache hits print nothing.

Demo workspace · vx 69617eb · 2026-10-23

You ask vx prints
one task its full output, live, like running it directly
many tasks one line per task that ran; failures replay in full above the summary
CI is truthy every frame

Pick a mode yourself

--output-logs sets it: full, errors-only, hash-only or none.
hash-only gives a script each task's cache key:

$ vx run build --all --force --output-logs=hash-only
success packages/e#codegen 7e5a9912933413c4
success packages/a#build 6802a43d515f6017
success packages/d#build 9f1cef08a2fd4006
success packages/b#build e8c0e9d5b1f5d0c9
…
Enter fullscreen mode Exit fullscreen mode

The status and cache words that start a line say how the task ended
and where its result came from. The status word's colour carries the
outcome.

Words Result
success miss ran (cache miss)
success fresh up to date, nothing to restore
success local restored from the local cache
success remote restored from the remote cache
failed miss failed
skipped skipped, with the failure that blocked it
running persistent, like a dev server

A report for the pull request

Add github() from @vzn/vx-ci to
.vx/workspace.ts. Each run on GitHub Actions then writes a job summary
and a check on the commit.

The run as a timeline

--profile writes the run as a Chrome trace. Open it in
Perfetto to see which task held up the rest.

$ vx run build --all --force --profile=prof.json
Enter fullscreen mode Exit fullscreen mode
$ jq -c '.traceEvents[0]' prof.json
{"name":"packages/e#codegen","cat":"success","ph":"X","ts":10028,"dur":10853,"pid":1,"tid":1,"args":{"exitCode":0,"hash":"7e5a9912933413c4","cpuMs":2.543}}
Enter fullscreen mode Exit fullscreen mode

Every flag is in the CLI reference. More at
vznjs.github.io/vx.


Originally published on the vx blog. vx is open-source (MIT) task orchestration with a build cache: vznjs.github.io/vx · GitHub.

Written with AI assistance.

Top comments (0)