device macos deploy

Overview

Installs applications on a macOS machine using Homebrew, driven by a Brewfile. Supports device-specific overrides, category filtering, and required-only installs. Can optionally skip the Homebrew update step for faster runs.

Usage

device macos deploy [OPTIONS]

Options

Option	Description	Default
-b, --brewfile PATH	Brewfile path	macos/apps/Brewfile
-d, --device DEVICE	Device ID for override (auto = hostname detection)	--
--skip-update	Skip brew update before installing	false
--required-only	Only install required packages	false
-c, --category CATEGORY	Only install packages from this category	All

Prerequisites

• Repo: device-deployments
• Platform: macOS
• Dependencies: Homebrew
• Brewfile: macos/apps/Brewfile with package definitions

Examples

Deploy all apps from default Brewfile

device macos deploy

Deploy only required packages, skip update

device macos deploy --required-only --skip-update

Deploy with device-specific overrides

device macos deploy -d auto

Deploy only development tools

device macos deploy -c development

Output

Deployment summary showing total, installed, skipped, and failed package counts.

Related Commands

• device macos audit -- audit compliance against Brewfile
• device macos update -- update all outdated Homebrew packages