Apps and tools
Install apps, fonts and command-line tools with one line each, all from Homebrew.
Each package is one line in a file in config/:
# config/apps.conf
brew cask ghostty
# config/packages.conf
brew formula gh
| File | Holds | Comes with |
|---|---|---|
config/apps.conf |
apps | 1Password, Google Chrome, Dia, Ghostty, Zed, Discord, Slack, WhatsApp, Hammerspoon, Linear, and a container runtime |
config/fonts.conf |
fonts | JetBrains Mono Nerd Font |
config/packages.conf |
command-line tools | 1Password CLI (op), GitHub CLI (gh), Starship, Varlock, Vercel CLI, GNU Make |
config/mise.conf |
languages and runtimes | mise, and through it Node, pnpm, Bun, Python and uv (Languages and versions) |
config/aws.conf |
cloud | the AWS CLI and its profiles (AWS) |
Those are the original repo’s choices; your fork keeps, removes or adds lines.
Add one
Find its exact name, then add a line to the right file:
brew search <name>
brew cask <name>for apps, fonts and prebuilt binaries.brew formula <name>for command-line tools.brew tap <owner/repo>for a third-party package source, before the packages that come from it.
Then dot apply apps (or packages, fonts). An app you already installed
by hand is adopted, as long as it’s the same version; adopting may ask for
your password.
dot explain brew cask <name> shows what a package is, its version, and
whether it’s installed.
Containers
One line in config/apps.conf picks what runs docker and
docker compose:
containers runtime docker-desktop
| Value | Installs | After installing |
|---|---|---|
docker-desktop |
Docker Desktop; installing asks for your password | open the app once |
orbstack |
OrbStack | open the app once |
rancher |
Rancher Desktop | open the app once and pick the dockerd engine |
colima |
the colima, docker and docker-compose formulae |
colima start, and the step below |
The apps bring Kubernetes too. Each has its own license terms for work use; read them before choosing.
With colima, docker compose only works once Docker knows Homebrew’s
plugin folder. Add it to ~/.docker/config.json:
{
"cliPluginsExtraDirs": ["/opt/homebrew/lib/docker/cli-plugins"]
}
Changing the value installs the new runtime and leaves the old one installed, like any other package.
gh extensions
Extensions to the GitHub CLI are one line each, in config/packages.conf:
gh extension github/gh-stack
dot apply packages installs the ones that are missing, through gh and so
through 1Password (Touch ID). If 1Password can’t reach its app, the error
says so: open and unlock 1Password, check that Settings › Developer ›
Integrate with 1Password CLI is on, and apply again. dot check only looks
at gh’s extensions folder, so it needs neither.
dot doesn’t upgrade them. gh extension list shows what’s installed and its
version, and this upgrades them all:
gh extension upgrade --all
Remove one
Removing a line doesn’t uninstall anything: dot only ever installs. Uninstall
with brew uninstall <name> (or gh extension remove <name>) if you want it
gone.