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