mas <Badge type="warning" text="experimental" />

Mac App Store apps via the mas CLI.

toml

[bootstrap.packages]
"brew:mas" = "latest"
"mas:497799835" = "latest"       # Xcode

mas apps are part of [bootstrap.packages], just like apt packages, Homebrew formulae, and casks. The package name is the App Store app ID: a numeric ADAM ID accepted by mas install and mas upgrade.

mise does not install mas implicitly. Install it yourself first, for example with the built-in brew manager:

toml

[bootstrap.packages]
"brew:mas" = "latest"
"mas:497799835" = "latest"

or with a normal mise tool if you have one configured globally:

mise use -g mas

Commands

mise bootstrap packages use mas:497799835
mise bootstrap packages status
mise bootstrap packages install --manager mas
mise bootstrap packages upgrade --manager mas

mise bootstrap packages install runs mas install <id> for missing apps. mise bootstrap packages upgrade runs mas upgrade <id> for installed apps. Both commands require numeric ADAM IDs; bundle identifiers such as com.apple.dt.Xcode are not valid package names.

Caveats

mas is macOS-only and must be on PATH. On other platforms, or when the mas command is missing, shared configs list the entries as skipped instead of failing. Explicit commands such as mise bootstrap packages install --manager mas still fail when mas is unavailable, matching the other package managers.

Mac App Store operations may require an Apple Account signed in to the App Store, macOS authentication, prior purchase/claiming for paid apps, and valid Spotlight indexing. mise surfaces errors from mas rather than trying to purchase or claim apps itself.

Finding IDs

Use mas search or copy an App Store URL and extract the numeric ID:

mas search xcode

For example, Xcode's App Store URL contains id497799835, so the package entry is:

toml

[bootstrap.packages]
"mas:497799835" = "latest"