# Install mage with Homebrew, apk, apt, MacPorts, Nix, pacman, scoop, winget, zypper Make/rake-like build tool using Go. Version 1.17.2 via Homebrew; verified 2026-04-23. ## Install ```sh sudo av install brew:mage ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install mage ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install mage ``` Evidence: MacPorts ports tree: devel/mage/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add mage ``` Evidence: Alpine Linux edge package indexes: mage from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz - Debian apt (92%): ```sh sudo apt install golang-github-magefile-mage-dev ``` Evidence: Debian stable package indexes: golang-github-magefile-mage-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - Nix (92%): ```sh nix profile install nixpkgs#mage ``` Evidence: nixpkgs package indexes: pkgs/by-name/ma/mage/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S mage ``` Evidence: Arch Linux sync databases: mage from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install mage ``` Evidence: openSUSE Tumbleweed package metadata: mage from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ### Windows - Scoop (92%): ```sh scoop install main/mage ``` Evidence: Scoop official bucket manifest trees: bucket/mage.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget (92%): ```sh winget install --id Magefile.mage -e ``` Evidence: Windows Package Manager source index: Magefile.mage from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:mage - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.17.2 - **Source summary:** Make/rake-like build tool using Go - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-04-23T03:53:13Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - mage (cli) - mage (alias) ## Dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.17.2 - Package-manager updated: 2026-04-23 - Local data: ok - Upstream repository: https://github.com/magefile/mage - info: No cached GitHub release or tag data was available. ## Project history and usage Mage is a Go-native make/rake-style task runner. Its package identity is simple: a small `mage` CLI finds Go functions in mage files and exposes them as build targets, giving Go projects a build script that is compiled and type-checked as ordinary Go. ### Project history The public GitHub repository was created in September 2017, and the project reached its v1 release in October 2017. The official site describes the core idea as Makefile-like runnable targets written as plain Go functions, with no runtime dependency beyond Go itself. Mage evolved around Go workflow conventions. Release notes and documentation added support for Go modules, versioned `go install` use, optional and variadic arguments, multiline help text, tab completion, and the `magefiles/` directory convention for keeping build files separate from normal application code. ### Adoption history Mage became a common package-manager install for developers who wanted a cross-platform replacement for Make in Go-heavy repositories. The official installation page documents Homebrew, MacPorts, Scoop, GitHub releases, `go install`, and asdf, while the Homebrew input data also lists Linux distribution, Nix, pacman, winget, and zypper package names. The repository has several thousand GitHub stars and hundreds of forks, which is a useful adoption signal for a developer tool whose main audience is maintainers wiring project automation into local builds and CI. ### How it is used A typical project adds a mage file with the `mage` build tag and exported functions. Running `mage -l` lists targets, `mage ` executes one, and comments on functions become command help. Mage is also used in CI and in vendored or zero-install workflows. The zero-install documentation shows how a project can run Mage through `go run` so contributors do not need a preinstalled `mage` binary. ### Why package nerds care Mage is package-nerd interesting because it trades Make's whitespace-sensitive shell DSL for Go code while still looking like a tiny command-line build tool to package managers. It sits in the same cultural slot as Make, Rake, Just, and Task, but its dependency story is unusually boring for Go users: install one CLI, write Go. Its packaging footprint is broad for a niche build tool, and the docs explicitly cover binary releases and multiple package managers, which makes it easy to pin in CI images or bootstrap on contributor machines. ### Timeline - 2017: Public GitHub repository created. - 2017: v1 release published. - 2018: Go modules support documented in release history. - 2021: `magefiles/` directory support released. - 2026: v1.17.x releases continue the 1.x line with tab completion and help improvements. ### Related projects - Make and Rake are the direct inspirations named by the project description. - Go task runners such as Task and Just occupy adjacent package-manager space, but Mage's distinguishing feature is that tasks are ordinary Go functions. ### Sources - - - - - - source_facts.package-manager - source_facts.repo ## Security Notes generalized runtime or code generation signal. - **Geiger risk:** yellow / medium - generalized runtime or code generation signal ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: magefile.go, Magefile.go - Windows: magefile.go, Magefile.go ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** mage - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Debian apt - golang-github-magefile-mage-dev - 1.15.0+ds-2: normalized package name match | Debian stable package indexes: golang-github-magefile-mage-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Make/rake-like dev tool using Go (library) | https://github.com/magefile/mage - Debian apt - mage - 1.15.0+ds-2+b3: normalized package name match | Debian stable package indexes: mage from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Make/rake-like dev tool using Go (program) | https://github.com/magefile/mage - Nix - mage: normalized package name match | nixpkgs package indexes: pkgs/by-name/ma/mage/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - apk - mage - 1.13.0-r23: normalized package name match | Alpine Linux edge package indexes: mage from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | make-like build tool using Go | https://magefile.org/ - pacman - mage - 1.15.0-2: normalized package name match | Arch Linux sync databases: mage from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A Make/rake-like build tool using Go | https://magefile.org - zypper - mage - 1.15.0-2.5: normalized package name match | openSUSE Tumbleweed package metadata: mage from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | A make-like build tool using Go | https://github.com/magefile/mage - MacPorts - mage: normalized package name match | MacPorts ports tree: devel/mage/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Scoop - main/mage: normalized package name match | Scoop official bucket manifest trees: bucket/mage.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget - Magefile.mage: normalized package name match | Windows Package Manager source index: Magefile.mage from https://cdn.winget.microsoft.com/cache/source.msix ## Related links - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Runtime dependency declared by Homebrew. - [goredo](https://www.automicvault.com/pkg/brew/goredo/) - Shares av.db curated category or tags: build-system, cli, developer-tools, go, make-alternative. - [boot-clj](https://www.automicvault.com/pkg/brew/boot-clj/) - Shares av.db curated category or tags: build-system, build-tool, cli, developer-tools. - [go-task](https://www.automicvault.com/pkg/brew/go-task/) - Shares av.db curated category or tags: build-tool, cli, developer-tools, make-alternative, task-runner. - [ninja](https://www.automicvault.com/pkg/brew/ninja/) - Shares av.db curated category or tags: build-system, build-tool, cli, developer-tools. - [redo](https://www.automicvault.com/pkg/brew/redo/) - Shares av.db curated category or tags: build-system, cli, developer-tools, make-alternative. - [smake](https://www.automicvault.com/pkg/brew/smake/) - Shares av.db curated category or tags: build-system, build-tool, cli, developer-tools. - [bsdmake](https://www.automicvault.com/pkg/brew/bsdmake/) - Shares av.db curated category or tags: build-system, cli, developer-tools. - [cabin](https://www.automicvault.com/pkg/brew/cabin/) - Shares av.db curated category or tags: build-system, cli, developer-tools. - [cargo-make](https://www.automicvault.com/pkg/brew/cargo-make/) - Local metadata places this package in an adjacent workflow. Shared terms: build, build-tool, cli, developer, developer-tools. ## Combined YAML source View the package source record on GitHub. [combined/mage.yml](https://github.com/automic-vault/db/blob/main/combined/mage.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph