# geerlingguy/mac-dev-playbook

Mac setup and configuration via Ansible.

Repository: https://github.com/geerlingguy/mac-dev-playbook
Canonical: https://ross.abutalabs.com/products/mac-dev-playbook
Language: Shell
License: NOASSERTION
License Family: other
Topics: mac, macos, setup, developer, homebrew, automation, ansible, playbook
Last push: 2026-08-04T17:19:43+00:00

## Health v2 (maintenance only)
Score: 75/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 96, release rhythm 35, longevity 100
- inputs: {"age_days": 4585, "days_push": 29, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7035, forks 1883 (observed 2026-08-28T04:09:55.204521+00:00)

## What it is
An Ansible playbook that automates installing and configuring development software on macOS, including Homebrew packages, Mac App Store apps, and dotfiles. It can run locally or provision remote Macs over SSH, with customizable package lists via a config override file.

## Use cases
- set up a new mac for development automatically
- automate macos developer environment provisioning
- install homebrew packages and apps with ansible
- configure dotfiles and system settings on mac
- provision a remote mac over ssh
- reproducible mac workstation setup

## When to choose
- you want a repeatable, scripted macOS dev machine setup
- you manage multiple Macs and want consistent configuration
- you're comfortable with Ansible and want a customizable base playbook

## When to avoid
- you need a one-click GUI installer with no command-line work
- you don't use macOS
- you want fully automated setup with zero manual steps

## Facets
- artifact type: infra-config
- maturity: active
- function: configuration-management, deployment, developer-tools, cli
- domain: developer-tools, operating-systems
- platform: cli, python
- tags: ansible-playbook, macos-setup, homebrew, dotfiles, provisioning, dev-environment, automation, devops, macos

## Member repositories
- geerlingguy/mac-dev-playbook (main) score 75

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:55.204521+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:40:33.794219+00:00, confidence not recorded.
  - readme: https://github.com/geerlingguy/mac-dev-playbook (fetched 2026-08-28T04:09:55.204521+00:00, sha 6422c5e087e1)
- Data as of 2026-08-30T08:39:29.467469+00:00.