dotpilot 0.1.0

Symlink-based dotfiles manager with auto-sync and system bootstrapping

dotpilot

Symlink-based dotfiles manager with auto-sync and system bootstrapping.

Install

uv tool install dotpilot

Or with pip:

pip install dotpilot

Quick start

dotpilot status              # Show untracked dotfiles + sync status
dotpilot install --apply     # Symlink dotfiles into ~/
dotpilot sync --apply        # Fetch & fast-forward merge from origin

Commands

All commands default to ~/dotfiles. Override with --dotfiles DIRECTORY.

Command	Description
dotpilot install	Symlink dotfiles into ~/ (dry-run by default)
dotpilot sync	Fetch and fast-forward merge from origin
dotpilot track <path>	Start tracking a dotfile or directory
dotpilot untracked	List untracked dotfiles in ~/ and ~/.config
dotpilot status	Show untracked dotfiles and sync status
dotpilot cron	Install or remove the auto-sync cron job
dotpilot bootstrap	Install system packages for a fresh machine

All mutating commands are dry-run by default — pass --apply to execute.

How it works

dotpilot manages your dotfiles as symlinks. Your dotfiles live in a git repo (default ~/dotfiles), and dotpilot creates symlinks from ~/ pointing into the repo.

• Root-level dotfiles (e.g. .zshrc) are symlinked directly
• .config/ directories (e.g. .config/nvim) are symlinked as directories
• .overwrite files are copied instead of symlinked (for files that can't be symlinks)
• .delete files remove the corresponding file from ~/
• track copies a file into the dotfiles repo and replaces the original with a symlink

License

MIT