The letter A styled as Alchemists logo. lchemists
Published October 31, 2019 Updated May 15, 2020


Demonstrates using the macOS project for building and managing an existing development tool set.


# Hello and welcome to the Alchemists Screencasts!
# Today, we'll look at the macOS project (
# You'll want to clone (or download) this project for global use and general upkeep:

git clone git://
cd mac_os

# You can check out a stable release (recommended) by running: `git checkout <version>`.
# For this tutorial, we'll live on the edge and use the `master` branch instead.
# While in the project root, we can use the `bin/run` script to interact:


# As the error indicates, we need a corresponding macOS Config project.
# Let's clone the one I use (any compatible config project will do, though):

cd ..
git clone git://
cd mac_os

# Notice there are four sections: Boot, Install, Restore, and Manage.
# We'll walk through each section, starting with "Boot":

bin/run B

# This would create a boot disk for which to install macOS onto a new/existing machine.
# Documentation is always printed to guide you with next steps.
# In this situation, it threw an error because the disk wasn't mounted properly.
# Had we done that, it would have outputted boot disk creation progress.


# The next section is "Install".
# The options listed here can be used by a new or existing machine.
# For full system install, use: `bin/run i`.
# Then follow the prompts and restart your system afterwards.
# You can run each setup step individually too -- Check README for details.
# Next up is the "Restore" section.
# This provides a way to restore software settings, personal directories, etc.
# (after installing software from the previous section)

bin/run R

# In this case, the backup volume doesn't exist.
# Otherwise, it would have rsync'd files from the backup (see README for details).
# Last of the sections is the "Manage" section.
# This allows you to perform maintenance of previously installed software.
# We'll walk through some of these options to see how they are used:

bin/run c

# Here we can see that all software is currently up-to-date (for the most part 😉).
# We can uninstall software by using any of the u* options:


# Sometimes there are situations where you need to reinstall/upgrade an app/extension.
# For that, you can use the equivalent reinstall options. Example:
# bin/run ra
# bin/run rx

# Enjoy!
# ☿ 🜔 🜍 🜂 🜃 🜁 🜄