Skip to content
dot
Esc
↑↓navigate↵open⌘Jpreview
On this page

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.

Was this page helpful?