Get started
New here? The setup guide takes you from a one-line bootstrap to your first install.
dotfiles
A modular Go + shell dotfiles manager. A generic engine you personalize with an optional content overlay — no fork required.
dotfiles is a hybrid dotfiles manager: Go handles orchestration (CLI, config, dependency resolution, state tracking and rollback) while shell scripts handle the actual installation. The repository is a generic engine with conservative, personal-free defaults; your identity, secrets choice, and custom profiles/modules live in an optional content overlay that is deep-merged over it.
Make it yours
Keep your config in a separate repo with the content overlay, then follow the extending tutorial to add custom and override modules.
Modular & idempotent
~30 self-contained modules with topological dependency resolution; safe to re-run — only what changed is updated. See Architecture and Idempotence.
Automation-friendly
--unattended installs for CI/CD, containers, and IaC. See the
CI/CD guide and CLI reference.