Introduction
Install one or more Homebrew packages on a macOS device as part of an automation. Use this action to deploy command-line tools or GUI applications from Homebrew without touching each device manually.
Install Homebrew Package
From the automation pipeline in edit mode, click + Add action and select Install Homebrew package from the App management category. The action panel opens with two sections: Action type (pre-set to Install Homebrew package) and Step configuration.
ℹ️ NOTE: If Level's Homebrew isn't installed on the device yet, this action sets it up automatically before installing the packages. This includes creating the homebrew system user account and wrapper script. See Install Homebrew Action for details on how Level manages Homebrew.
Package(s)
Enter the Homebrew formula or cask name for each package you want to install. Press Tab or type a comma after each name to add the next one.
ℹ️ NOTE: If a package is already installed on the device, it's skipped. The action still completes successfully.
The field is required — you can't save the action without at least one package name.
For a full list of available formulae (command-line tools) and casks (GUI applications), visit https://formulae.brew.sh/.
💡 TIP: Homebrew distinguishes between formulae and casks. Most command-line tools are formulae (wget, jq, ffmpeg). GUI apps are casks (firefox, visual-studio-code). Use the bare package name from formulae.brew.sh — Level handles the install type automatically.
Conditions
The Conditions section lets you restrict when this action runs based on device attributes or the outcome of a previous action. Expand the section to add conditions.
See Action Conditions for the full reference on condition types, operators, and values.
Additional Options
Expand Additional options for additional execution settings including action name, failure behavior, output variables, and retries.
See Actions Overview for the full reference on additional options available on every action.
FAQ
Where do I find the correct package name? Search https://formulae.brew.sh/ for the package. The name shown on that page is the one to use in the Package(s) field.
Do I need to add an Install Homebrew step first? No. If Level's Homebrew isn't on the device yet, this action installs it automatically before running.
Can I install both formulae and casks in the same action? Yes. Enter each package name as a separate value in the Package(s) field regardless of type.
What if a package name is spelled wrong? The action will fail for that package. Check the failure output in the automation run log and correct the name.
I see a banner when running brew commands in the terminal. Is that normal? Yes. Level's wrapper script at
/usr/local/bin/brewprints an informational note confirming Homebrew is Level-managed. It's not an error. See Install Homebrew Action for more on how Level manages Homebrew.Does this work on Windows or Linux? No. Homebrew is macOS only. This action is not available for Windows or Linux devices.
Who can add or modify this action in an automation? Technicians with permission to edit automations in the relevant group. See Workspace → Permissions for access control configuration.