dotstate: Profile-Based Dotfile Manager

dotstate manages dotfiles by replacing them with symlinks to a Git repository, supporting multiple machine profiles and a common shared layer.

Navigation Rule

Use dotstate when:

• The user has a ~/.config/dotstate/ directory
• Files in ~ are symlinks pointing to a dotstate storage directory
• The user mentions syncing dotfiles across machines

Profile Rule

dotstate organizes files into profiles (per-machine, e.g., ubuntu, macos) and Common (shared across all profiles).

File classification:

• Common: files identical on all machines (e.g., gitconfig, zshenv, starship.toml)
• Profile-specific: files with machine differences (e.g., zprofile with CUDA paths on Ubuntu, Homebrew paths on macOS; npmrc with OS-specific prefix paths)