MAGE(1)

📦
version 1.17.1 · 4 versions
, in ubuntu stonking

💖 NAME 💖

mage — a make/rake-like build tool using Go, and honestly? she ate.

🌸 DESCRIPTION 🌸

Okay so bestie, picture make but it's written in Go and it's not gonna make you cry. That's mage. It's a make-like command runner. Fr fr.

The vibe:

mage [options] [target]

Full docs live at https://magefile.org if you want the whole lore. 📖✨

🎀 Commands: 🎀

  • -clean — clean out old generated binaries from CACHE_DIR. Marie Kondo but for your build artifacts 💅
  • -compile <string> — output a static binary to the given path. One binary, no drama, iconic.
  • -h — show this help. Hi, hello, here's the tea 🫶
  • -init — create a starting template if no mage files exist. Your starter pack, no cap.
  • -l — list mage targets in this directory. The menu, the lineup, the roster 👑
  • -version — show version info for the mage binary. Who is she? Find out.

✨ OPTIONS ✨

  • -d <string> — directory to read magefiles from (default "." or "magefiles" if it exists). Tell her where to look.
  • -debug — turn on debug messages. Chaos mode: enabled 🐛
  • -f — force recreation of compiled magefile. No cache, all fresh, we're rebuilding from scratch bestie.
  • -goarch — sets the GOARCH for the binary created by -compile (default: current arch). Architecture slay.
  • -gocmd <string> — use the given go binary to compile the output (default: "go"). Bring your own go ✨
  • -goos — sets the GOOS for the binary created by -compile (default: current OS). Operating system: your choice.
  • -ldflags — sets the ldflags for the binary created by -compile (default: ""). Linker flags, very demure, very mindful.
  • -multiline — retain line returns in help docs (default: convert to spaces). Keep the formatting, don't flatten her 😭
  • -h — show description of a target. (Yes, -h shows up twice in this page. Context matters, iykyk 💀)
  • -keep — keep intermediate mage files around after running. Hoarder mode: activated. They can stay, they're part of the family now 🥺
  • -t <string> — timeout in duration parsable format (e.g. 5m30s). Set a limit, she has places to be ⏰
  • -v — show verbose output when running mage targets. Give me every single detail, I want the whole story 🗣️
  • -w <string> — working directory where magefiles will run (default -d value). Where the magic actually goes down.

🦋 SEE ALSO 🦋

  • make(1) — the OG. Respect the elders. 🫡

That's the whole page, bestie! This one's mage 1.17.1+ds-1, dated April 2026. Go build something iconic. Periodt. 💜✨

📦 where this page comes from