ZVM-RUN(1)

✨ zvm-run(1) ✨

okay so bestie, welcome to the zvm-run page 💖 this is the zvm run subcommand from the ZVM manual — it's giving "try a Zig version without committing to it" energy and honestly? iconic 🎀

---

🌸 NAME 🌸

zvm-run — run Zig without changing the active version, no cap 🦋

---

✨ SYNOPSIS ✨

zvm run [version] [zig-arguments...]

---

💅 DESCRIPTION 💅

So what it does is it runs the Zig executable from version with the remaining arguments. That's it, that's the vibe 🫶

Key thing to know: running an already installed version leaves the selected version unchanged ✨ like, your current default stays your current default, we're just visiting.

If the requested version is not installed, ZVM offers to install it. And heads up — accepting this prompt installs it as the global default before running it 👑 so yeah, that one does move your default. Be aware, bestie.

Version shorthand and aliases are accepted; see zvm(1) for the deets 🌈.

When no version is supplied, ZVM reads .minimum_zig_version from build.zig.zon in the current directory and passes all arguments to Zig 🍓. For example, zvm run build --help uses the project's minimum Zig version. Very main character of it.

Arguments after version are passed directly to Zig 💀 including arguments beginning with a hyphen. Yes, even the hyphens. They don't get eaten. Slay.

---

🔥 EXAMPLES 🔥

zvm run 0.13.0 version
zvm run .14 build test
zvm run master build run -- --port 8080
zvm run build --help

look at all those little version shorthand moments ✨ .14 bestie, we love a shorthand.

---

👀 SEE ALSO 👀

• zvm(1)
• zig(1)
• zvm-install(1)
• zvm-use(1)

---

and that's the whole page, periodt 💅 ZVM v0.9.4, dated August 2026 — go run some Zig, bestie, iykyk 🧚💜