docs.rs failed to build cutler-0.14.3
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

Visit the last successful build: cutler-0.19.5

🍎 cutler

Setup automation for your Mac

Pre-built binaries support macOS Big Sur (11.0) or later versions.

Quick Start

# Self-installing script
# See below sections for other methods.
curl -fsSL https://cutlercli.github.io/scripts/install.sh | /bin/bash

# Initialize a configuration file.
# Basic template includes preferences, Homebrew and external commands.
cutler init

# Modify using your preferred editor.
nano ~/.config/cutler/config.toml

# Apply your preferences.
cutler apply

What is cutler?

cutler simplifies the macOS setup pipeline by:

providing a declarative way to set system settings, without touching the Settings app,
wrapping around package managers for easy apps/tooling installation, and
by providing first-class support for external commands to ensure easy extensibility.

All of this happens with a single cutler.toml file in your config directory.

How it works

For backend functionality over system preferences, cutler wraps around the preferences APIs exposed by macOS. This allows for direct and instant feedback by just restarting the corresponding services related to the preference.

For wrapping around tooling, cutler includes mature implementations for extracting the data from the selected package managers. Sensitive actions (e.g. installing) are currently outsourced to remain as close to the original functionality as possible.

cutler is still in development and changes in functionality may be common during this stage.

Resources

Complete Documentation (Cookbook)
macOS defaults list (useful if you're starting out with declaring bare-metal system preferences and have not previously used defaults)

Installation

Self-install (recommended)

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

Using Homebrew

brew install hitblast/tap/cutler

Using cargo

cargo install cutler

Using mise

mise use -g cargo:cutler

Contributing

View the Contribution Guidelines to learn more about contributing to cutler. It also contains resources such as code snippets to make your contribution workflow easier.

License

This project is dual-licensed:

Open Source License: GNU General Public License v3.0 or later (GPLv3)
Commercial License: See COMMERCIAL_LICENSE.md for terms

You may choose either license for your use case. For commercial licensing or support, contact Anindya Shiddhartha at hitblastlive@gmail.com.

cutler 0.14.3