Converts a Homebrew Brewfile into an Ansible playbook using community.general modules.

• Python 3.9+

• Ansible with the community.general collection:

  ansible-galaxy collection install community.general

git clone https://github.com/ViriLain/brewfile-to-ansible.git
cd brewfile-to-ansible
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

# Print playbook to stdout
brewfile-to-ansible Brewfile

# Write playbook to a file
brewfile-to-ansible Brewfile -o playbook.yml

# Fail on any unsupported or malformed lines
brewfile-to-ansible Brewfile --strict

# Parse and report issues without generating output
brewfile-to-ansible Brewfile --dry-run

# Normalize entries via `brew bundle list` before converting
brewfile-to-ansible Brewfile --normalize-with-brew

# Use a custom Jinja2 template directory
brewfile-to-ansible Brewfile -t ./my-templates -o playbook.yml

ansible-playbook playbook.yml

The playbook targets localhost, runs as the current user (become: false), and assumes Homebrew is already installed.

• No Ruby DSL evaluation. Brewfile is Ruby. Loops, conditionals, variables, and method calls are not evaluated — those lines are skipped and reported as warnings.
• MAS app IDs. --normalize-with-brew cannot recover App Store app IDs from brew bundle list. MAS entries are preserved from the original Brewfile but will be incomplete after normalization.
• VS Code and Whalebrew. These use shell commands in the generated playbook and are less reliable than the native Homebrew tasks.
• accept_external_apps not set. Some casks require this flag; the generated playbook does not set it. Pass it via install_options if needed.
• Homebrew must already be installed. The generated playbook does not install Homebrew itself.

pip install -e .[dev]
pytest          # run tests
ruff check .    # lint
mypy brewfile_converter/  # type check

• Homebrew Bundle
• community.general.homebrew
• community.general.homebrew_tap
• community.general.homebrew_cask