cutler

Powerful, declarative settings management for your Mac,
with speed.
Get Started Star on GitHub
Apple Silicon + Intel Macs Coffee-checked

Infrastructure-as-code for your Mac

Imagine if you had just one file which could setup everything on your beloved machine? With cutler, you can do just that!

cutler uses TOML as its format to store configuration data.

With this simple style, you can manage system preferences, commands which you'd have to write entire scripts for, and even software installs!

Once ready, just run one command to apply everything. Finally, you can take that cup of coffee while you watch cutler do the heavylifting.
# ~/.config/cutler/config.toml

[set.dock]
autohide = true
orientation = "left"

[commands.sync]
run = "git clone git@github.com:hitblast/dotfiles"

[brew]
formulae = ["neovim", "python@3.12"]
no-deps = true


# Apply all settings with one command
$ cutler apply --with-brew

Installation

To install cutler, run the following command in your terminal:

curl -fsSL https://cutlercli.github.io/scripts/install.sh | /bin/bash

For more installation options, see the installation guide.


Why Choose cutler?

1

Declarative

Simple TOML format tailored to cutler itself. The pro users simply cannot gatekeep this from being simple.

Lightning Fast

Built with Rust for maximum performance. Apply hundreds of system preferences in milliseconds.

Safe & Reversible

All changes are tracked and can be easily reverted. Never worry about breaking your system again.

Comprehensive Coverage

Manage system preferences, Homebrew formulae/casks, external commands, and more, from a single file.

Cross-Machine Sync

Host your configuration wherever you like, and download them on any Mac to apply! They're totally movable.

Security Focused

No telemetry, no tracking. Your settings stay on your machine where they belong. Even the download count isn't tracked!

Documentation

Want to use cutler? There is an entire cookbook with recipes for you to follow, written specifically for it!

View the Cookbook

Join the Community

cutler is a solo project and still in rapid development. Join the community by contributing, sharing ideas, or just by giving a boost by dropping a star!