ZVM-ALIAS(1)

💅 ZVM-ALIAS(1) 💅

okay bestie, welcome to zvm-alias, the part of the zvm manual that's literally just about giving your installed Zig versions cute little nicknames 🎀 this page lives in the User Commands section of the manual, and honestly? it's giving main character energy.

---

✨ NAME ✨

zvm-alias — name installed Zig versions 🌸

like, you know how your Zig versions all have boring numbers? yeah. we're fixing that. no cap.

---

🦋 SYNOPSIS 🦋

zvm alias
zvm alias name
zvm alias name version
zvm alias --delete name
zvm alias --clear

look at all those forms, we love a versatile icon 👑

---

💖 DESCRIPTION 💖

Create, inspect, list, or delete aliases for installed Zig versions. periodt. and here's a lil bonus: kv is an alias for the alias command itself — so you can be lazy and type fewer letters, which is honestly so valid of you 😌

here's the vibe check on how it works:

• with no arguments, it lists every alias you've got. the whole roster.
• with only name, it prints that one alias. just the one. she's the main character now.
• with name and version, it creates or replaces an alias. 🫶

⚠️ heads up bestie: the target version must already be installed before you can alias it. no making promises to versions that aren't even here yet 😭. also, version shorthand is accepted, so you can be a little loose with it.

and the best part? aliases may be used as version arguments to install, use, run, and uninstall. literally everywhere. they're stored in aliases.json under the ZVM base directory, as a JSON object of name to version. so clean. so organized. we stan 🧚

---

💅 OPTIONS 💅

• -d, --delete — delete the named alias. and here's the iconic part: deleting an alias that does not exist succeeds. no drama, no error, no crying. it's just fine 💀✨
• --clear — delete all aliases. every single one. scorched earth, but make it cute 🔥

---

🌈 EXAMPLES 🌈

okay here's the whole group chat in action:

zvm alias work 0.14.1

→ makes an alias called work pointing at 0.14.1. slay 💼

zvm kv play .13

→ uses the kv shorthand and version shorthand together, because why type more than you have to 🎮

zvm alias work

→ prints what work is pointing at. quick lil check-in 🔍

zvm alias

→ lists every alias. the full lineup 👑

zvm alias --delete work

→ bye bye work 👋😭

---

🍓 FILES 🍓

• ~/.zvm/aliases.json — the alias file 💖. if ZVM_PATH is set, the file is $ZVM_PATH/aliases.json instead. either way, that's where all your nicknames live.

---

🧚 SEE ALSO 🧚

zvm(1), zvm-use(1), zvm-run(1), zvm-uninstall(1) — go read those too, iykyk 🦋

---

💜 and that's the whole page, bestie! this one's from ZVM v0.9.4, dated August 2026 — so go forth and name your Zig versions something unserious. mwah 💋✨