Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Backstory

Some of us really have a craze for configs and ricing. Though, looking at the dotfiles of others, I have realized that although they have really efficient scripts, they are not always easy to maintain and/or understand for others. I, personally, sometimes used to have a hard time navigating others' configurations.

And while, I might not be able to solve it for everyone, I have been using macOS for the past 4 years. Using it has given me a pretty good grip on the ecosystem and how preferences are handled.

Why?

While using macOS, I have come to realize that most solutions like Nix are not always easy to maintain either. So, I wanted to create a tool that abstracts away all the complexity into simple, already-known terms for most power users.

And that's how cutler came to be.

About this Book

This book, by name, wants to introduce you with cutler, a software made to declaratively manage your macOS preferences and essentials. It can do a number of things. This book will help you navigate all of them, including new ones which are currently in development.

It's a solo project, but I hope it will give you the proper impression for shrinking dotfiles by an order of magnitude.

Some Basic Directions

When you follow along the book, you'll notice both command and code snippets as examples, showing you certain behavior. If the command is prefixed with a $, it may mean that you may need to only "follow" the structure instead of just copy-pasting it. Other times, you can freely do so if the criterias specified are met.

If instead the code blocks have their file paths mentioned on top (for most of the time it will be the config file of cutler), it describes the structure of certail parts of the file.

There are some additional links that you may want to keep tabs on:

Let's Go!

To get started with your cutlery, move to the next page.