ZVM-UNINSTALL(1)

🗑️✨ NAME ✨🗑️

okay so this is the manual for zvm-uninstall (that's ZVM-UNINSTALL(1) if you're being formal 💅) and honestly? it does exactly what it says on the tin, bestie — it removes an installed Zig version. goodbye, begone, no cap 🫶

---

🌸 SYNOPSIS 🌸

zvm uninstall version
zvm rm version

two ways in, same energy — uninstall or the lil shortcut rm, your call 🎀

---

💖 DESCRIPTION 💖

so what happens is: you ask, and it removes the requested Zig installation from the ZVM base directory. that's the whole vibe ✨

and before you even worry about typing the full version string — version shorthand and aliases are resolved against locally installed versions, so it'll figure out what you meant from the versions you've actually got. iykyk 😌

now for the rules, and bestie, there ARE rules 🚨:

• only a top-level installation directory containing a zig or zig.exe file can be removed, periodt
• paths? rejected. reserved ZVM state names? also rejected. symbolic links? rejected, sorry not sorry 💀
• got links pointing at local builds? those are your problem — remove links to local builds yourself 🫡

🦋 the global + per-shell tea 🦋

here's the part where you gotta pay attention 👀 — if you remove the globally active installation, that also removes the bin link. so use zvm use to select another installed version afterwards, otherwise you're just standing there with no bin link like 😭

and per-shell links pointing at the removed installation must also be switched to an installed version — don't leave them ghosting the version you just yeeted 🙈

🧚 the dedupe-store situation 🧚

after removal, unreferenced dedupe-store files are pruned — like, cleaned up automatically, slay 💅 but! files still shared by other installations remain available, so nothing else breaks. we love a considerate icon 👑

🍓 heads up: if the requested version is not installed, ZVM reports that fact and lists the installed versions for you. very "here's what you could have deleted" of it ngl 💜

---

🔥 EXAMPLES 🔥

zvm uninstall 0.13.0
zvm rm .13
zvm rm stable

three lil icons of examples: full version, shorthand (.13), and the stable alias doing its thing ⭐

---

🌈 SEE ALSO 🌈

• zvm(1)
• zvm-install(1)
• zvm-list(1)
• zvm-alias(1)
• zvm-use(1)
• zvm-dedupe(1)

go read the whole squad, they're all linked 💖

---

okay and finally the cute sign-off: this gorgeous little page is ZVM v0.9.4, dated August 2026, and it lives as the ZVM-UNINSTALL(1) manual page 🎀 bye bestie, go delete something (safely) 💜✨