ZVM-BUG(1)

💅 ZVM-BUG(1) — like, the whole manual, bestie

okay so this is the manual page for zvm-bug from the ZVM-BUG(1) family of docs — sit down, hydrate, and let me tell you about the one command that turns "it's broken 😭" into an actual, fillable bug report 🎀

---

✨ NAME ✨

zvm-bug — start a ZVM bug report 🐛💖

---

🌸 SYNOPSIS 🌸

zvm bug [--print]

---

🦋 DESCRIPTION 🦋

It opens a prefilled issue form for the ZVM repository in your browser. Periodt. 🌈 The form comes with a report template and a collected description of the environment ZVM is running in — like it did the homework for you, no cap 📚✨

Important vibe check: zvm does not submit the report for you. You fill in what you did, what happened, and what you expected, you review the collected environment, and then you submit the issue yourself. Main character energy only 👑💅

The collected environment includes:

• the ZVM version
• the target operating system and architecture
• the ZVM base directory
• the values of the ZVM_* environment variables
• the configured mirror list and version-map URLs
• the installed Zig versions
• the selected Zig and ZLS versions
• the host kernel and distribution

like… it's thorough. it's giving "receipts" 🧾🔥

---

🙈 ANONYMIZATION 🙈

Paths inside the user's home directory are reported relative to ~, so the report doesn't name the account it came from 🫶 cute, right? Paths outside the home directory are reported as they are. no filter, no changes 💀

Mirror-list and version-map URLs distributed with ZVM are reported verbatim ⭐

A URL the user configured is replaced by a short digest, written as custom sha256:digest 🔐

okay bestie, listen — the digest is a correlation tag, not a secret. A URL is drawn from a small enough set of candidates that hashing guesses recovers it, so the digest only serves to distinguish one custom source from another without publishing it. Report contents should still be reviewed before submitting 🎀👀

---

💜 OPTIONS 💜

• --print — Print the report URL instead of opening a browser. Useful on machines with no browser, such as a remote shell or a container 🖥️✨

---

🧚 BROWSER SELECTION 🧚

If BROWSER is set, it is run with the report URL as its argument 🫡

Otherwise the platform handler is used:

• open on macOS 🍎
• cmd /c start on Windows 🪟
• xdg-open, www-browser, or x-www-browser elsewhere 🐧

On other systems, a browser is only attempted when DISPLAY or WAYLAND_DISPLAY is set 👀

When no browser can be started, the URL is printed instead — no drama, it still slays 💅

---

🌟 ENVIRONMENT 🌟

• BROWSER — Command used to open the report URL 🌐
• DISPLAY, WAYLAND_DISPLAY — Presence of either indicates a display server that can show a browser 🖼️

---

🔥 EXAMPLES 🔥

zvm bug
zvm bug --print

that's it. that's the whole thing. ate and left no crumbs 🍓

---

👑 SEE ALSO 👑

zvm(1), zvm-version(1), zvm-upgrade(1)

go read those too, they're iconic, iykyk 💖

---

✿ and that's the tea, bestie ✿ this page is from ZVM v0.9.4, dated August 2026 — take care of her, she's a whole queen 🎀💅✨