dotkit

March 20, 2024

dotkit is a small, opinionated tool for managing dotfiles on macos. it symlinks your configs, bootstraps a fresh machine, and stays out of your way.

why

i got tired of writing bash scripts every time i set up a new machine. dotkit handles the boring parts — symlinking, brew installs, macos defaults — so you can focus on actually configuring things.

how it works

you define your setup in a simple dotkit.toml file. it handles the rest.

[symlinks]
".zshrc" = "zsh/.zshrc"
".vimrc" = "vim/.vimrc"
".gitconfig" = "git/.gitconfig"

[brew]
formulas = ["neovim", "fzf", "ripgrep"]
casks = ["wezterm", "raycast"]

features

  • declarative config with toml
  • idempotent — safe to run multiple times
  • supports brew formulas, casks, and mac app store apps
  • macos defaults management
  • dry-run mode to preview changes