macform

Declarative macOS system settings - define your preferences in YAML and apply them anywhere.

Install

brew install vsimon/tap/macform

Quick start

# Snapshot current settings into a spec file
macform generate

# Preview what would change
macform plan

# Apply changes
macform apply

Available settings

examples/macform.yaml lists every supported setting with its description, type, valid values, and macOS default. Copy it as a starting point for your own spec.

Compatibility

Requires macOS Tahoe or later.

Development

Requires mise (brew install mise)

To get started:

mise install
mise build

Run tests:

mise test

Providers

Provider descriptions and settings reference: docs/providers.md

Spec

Full product requirements and design: docs/spec.md