MAS(1)
🌸 MAS(1) — the mas girlies' field guide 🌸
ok so real talk: this is the manual page for mas, aka the Mac App Store command-line interface, straight out of the General Commands Manual. grab a strawberry drink 🍓 and let's get into it.
✨ NAME ✨
mas — Mac App Store command-line interface. that's it, that's the whole vibe. no cap.
🦋 SYNOPSIS 🦋
mas subcommand [--version] [--help]💅 DESCRIPTION 💅
okay bestie, so mas is a whole CLI for the Mac App Store, and it's giving main character energy. every subcommand gets the same two little besties available to it:
--version— show the version. that's the whole thing. she just tells you the version. 💁♀️-h,--help— show help information. the-his the shortie,--helpis the full word, both slay equally.
and now, the subcommands, in the order they were handed to us. do not skip any, i literally mean it, we're doing all of them 🫶
🎀 config — output mas config & related system info
--json— output JSON 💻
plus the standard:
--version— show the version.-h,--help— show help information.
👑 get — get & install free apps from the App Store
⚠️ requires root privileges to get apps. so like, sudo energy. periodt.
--force— force reinstall 🔁--bundle— process all app IDs as bundle IDsapp-id...— app ID
plus:
--version— show the version.-h,--help— show help information.
🌈 home — open App Store app pages in the default web browser
--bundle— process all app IDs as bundle IDsapp-id...— app ID
plus:
--version— show the version.-h,--help— show help information.
🧚 install — install previously gotten apps from the App Store
⚠️ requires root privileges to install apps.
--force— force reinstall--bundle— process all app IDs as bundle IDsapp-id...— app ID
plus:
--version— show the version.-h,--help— show help information.
⭐ list — list apps installed from the App Store
--json— output JSON--bundle— process all app IDs as bundle IDsapp-id...— app ID
plus:
--version— show the version.-h,--help— show help information.
🔥 lookup — output app info from the App Store
--json— output JSON--bundle— process all app IDs as bundle IDsapp-id...— app ID
plus:
--version— show the version.-h,--help— show help information.
🍀 lucky — install the first app returned from searching the App Store
ok so a cutie detail here: the app will install only if it has already been gotten. no getting, no installing. iykyk.
⚠️ requires root privileges to install apps.
--force— force reinstallsearch-term...— search terms are concatenated into a single search
plus:
--version— show the version.-h,--help— show help information.
💜 open — open app page in 'App Store.app'
--bundle— process all app IDs as bundle IDsapp-id— app ID
(psst — this one takes a single app-id, no .... she's monogamous 💅)
plus:
--version— show the version.-h,--help— show help information.
🦄 outdated — list pending app updates from the App Store
ok this one has a LOT going on, stay with me:
--json— output JSON--accurate— use accurate, slower logic that starts then cancels a download for each queried app, which can exceed download limits & which will open dialogs for undownloadable apps 😭--inaccurate— use inaccurate, faster logic that avoids dialogs--check-min-os— check if macOS can install latest app version--no-check-min-os— check if macOS can install latest app version--verbose— warn about app IDs unknown to the App Store--bundle— process all app IDs as bundle IDsapp-id...— app ID
plus:
--version— show the version.-h,--help— show help information.
💀 note that --accurate literally starts and cancels real downloads, can blow past download limits, and pops dialogs for undownloadable apps. it's giving "slay but expensive". choose accordingly.
🧼 reset — reset App Store processes & clear cached App Store downloads
--version— show the version.-h,--help— show help information.
🔍 search — search for apps in the App Store
--json— output JSON--price— output the price of each app 💸search-term...— search terms are concatenated into a single search
plus:
--version— show the version.-h,--help— show help information.
🛍️ seller — open apps' seller pages in the default web browser
--bundle— process all app IDs as bundle IDsapp-id...— app ID
plus:
--version— show the version.-h,--help— show help information.
🚪 signout — sign out of the App Store
--version— show the version.-h,--help— show help information.
🗑️ uninstall — uninstall apps installed from the App Store
⚠️ requires root privileges to uninstall apps.
--dry-run— perform dry run 🧪--all— uninstall all App Store apps--bundle— process all app IDs as bundle IDsapp-id...— app ID
plus:
--version— show the version.-h,--help— show help information.
🔄 update — update outdated apps installed from the App Store
⚠️ requires root privileges to update apps.
--force— force reinstall--accurate— use accurate, slower logic that starts then cancels a download for each queried app, which can exceed download limits & which will open dialogs for undownloadable apps 😭--inaccurate— use inaccurate, faster logic that avoids dialogs--check-min-os— check if macOS can install latest app version--no-check-min-os— check if macOS can install latest app version--verbose— warn about app IDs unknown to the App Store--bundle— process all app IDs as bundle IDsapp-id...— app ID
plus:
--version— show the version.-h,--help— show help information.
🏷️ version — output version number
--version— show the version.-h,--help— show help information.
🫶 help — show subcommand help information.
subcommands...--version— show the version.
(and yeah — help doesn't list -h, --help like the rest of the girlies do. that's just how it is, don't come for me 🙈)
💀 EXIT STATUS 💀
the mas utility exits 0 on success, and >0 if an error occurs. so like, zero = we ate, anything above zero = something went sideways. simple as that, no notes. 🔥
ok that's the whole page, bestie, you're officially fluent 💖
— cute lil sign-off: this one's from Debian, dated May 4, 2026. that's the source/version and the date, right there at the bottom like a little bow on top 🎀✨
📦 where this page comes from
- nixpkgs unstable: mas 7.0.0
- 💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms