homebrew-cli

Homebrew tap for dotkit, a configuration manager.

Install

brew tap dotkit-run/cli
brew install dotkit

Usage

Dotkit CLI provides many helper functions for organizing your configurations, packages, dotfiles, and more. It can be used from the command line, in shell scripts, or it can parse txt/md files following the dotkit format.

See dotkit help for all subcommands:

usage: dotkit SUBCOMMAND [ARGS...]

Subcommands:
  map TEMPLATE                  Apply TEMPLATE to each row of stdin.
  install URL                   Download and execute an installer script.
  parse [--extension EXT] FILE  Parse a dotkit file, emit shell on stdout.
  run   [--extension EXT] FILE  Parse and execute a dotkit file.
  link SRC DEST                 Symlink files from SRC into DEST.
  todo [-f] DIR                 Generate a TODO.md from a directory.
  apply [--dry-run] DIR         Apply a profile directory.
  add [-y|-y0|-y9] MODULE [ITEMS...]  Append items to a map block and run.
  help [SUBCOMMAND]             Show this message or detailed help.

Examples

Install many tools from the command line easily with a simple wrapper for homebrew, uv, and rust:

dotkit install https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh
dotkit install https://astral.sh/uv/install.sh
dotkit install https://sh.rustup.rs

Symlink files from ~/dev/dotfiles to your home folder:

dotkit link ~/dev/dotfiles ~

Apply an entire configuration, packages, dotfiles kit:

dotkit apply ./profiles/work

Update your dotkit and install package(s) to the active profile in one command:

dotkit add packages/brew -y uv fnm rust