DEV Community

Cover image for One command to know your workspace
VX
VX

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

One command to know your workspace

Every bug report starts with the same questions. vx info answers them
on one screen.

$ vx info

─ vx info ────────────────────────────────────────────────────
  vx                0.0.0
  bun               1.4.4
  git               2.43.0
  git status cache  core.fsmonitor, core.untrackedCache off
  projects          4 (18 tasks)
  plugins           none
  workers           4 — the CPU count
  memory            13 GB usable — cgroup limit; the machine has 16 GB
  cache dir         .vx/cache (242 KB, this workspace's run history)
  cache store       ~/.vx/3c8e043b65dcb173/cache (164 KB, shared by this repo's checkouts)
  cache versions    keys vx-cache-v48 · index schema v49
  cache entries     18 (5.8 KB)
  task runs (24h)   61 (40 cache hits: 40 up-to-date, 0 restored)
  flaky tasks       2 — packages/a#flip (2 of 4 runs failed on unchanged inputs); packages/a#e2e (1 of 2 runs failed)
  sandbox           available (1 task declares exec.sandbox)
  projects lock     yes
Enter fullscreen mode Exit fullscreen mode

Demo workspace · Linux x64 · vx 69617eb · 2026-10-23 · paths shortened

Where each answer comes from

diagram

Nothing is uploaded and nothing is recomputed. memory is the
container's limit, not the machine's. flaky tasks comes from your
local runs (flaky). --format json gives an agent
the same facts.

Keep the cache small

No run deletes cache entries. Trim it by hand or on a schedule, and
look first:

$ vx cache clean --max-size 4KB --dry-run
› vx cache clean  would free 1.9 KB (dry run)

  5 entries
Enter fullscreen mode Exit fullscreen mode

Reference: the CLI. 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)

Some comments may only be visible to logged-in visitors. Sign in to view all comments.