Skip to main content

Hassle-free bootstrapping with Homebrew.

Project description

Start with a clean slate

Cider is a simple wrapper for Homebrew and Homebrew Cask that allows you to save your setup across different machines. This lets you to restore a backup without having to deal with the mess that was the state of your previous installation, or painstakingly babysit the process step-by-step.

Simply run the following on a new machine:

git clone [YOUR_REPO] ~/.cider
cider restore

… and you’ll be back up and running, with all of your applications and command line utilities re-installed (and configurations restored).

In addition to Homebrew, Cider also supports managing your user defaults, restoring symlinks, and running scripts to conveniently manage other settings such as your dotfiles.


pip install -U cider


All configuration files are stored in the ~/.cider directory as JSON. For instance, here’s an example bootstrap file:

    "after-scripts": [
        "brew linkapps"
    "casks": [
    "formulas": [
        "macvim --overwrite-system-vi",
    "icons": {
        "iTerm": ""
    "symlinks": {
        "bash/.*": "~",
        "bin/*": "~/bin/",
        "git/.*": "~",
        "sh/.*": "~",
        "vim/.*": "~"
    "taps": [

User defaults are stored similarly:

    "NSGlobalDomain": {
        "ApplePressAndHoldEnabled": false
    "": {
        "tilesize": 48
    "com.iconfactor.mac.xScope": {
        "generalShowDockIcon": false

To see how this works out in practice, feel free to take a look at my dotfiles.

Backup your existing setup

To save the state of your existing setup:

cider missing
cider tap missing
cider cask missing


There doesn’t seem to be a way to re-install purchases made from Mac App Store via the command line just yet, so those have to be done by hand.

Note: Cider is a work-in-progress, but it’s fairly well-tested and should be kind to your machine.

For more information, see the GitHub Repository.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for cider, version 1.1.4
Filename, size File type Python version Upload date Hashes
Filename, size cider-1.1.4.tar.gz (22.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page