XWLinux

yadm

Yet Another Dotfile Manager — plik konfiguracyjny w repozytorium Git, a w katalogu domowym symlink. Zamiast tysiąca skryptów: jedno narzędzie, pełna kontrola wersji, historia zmian i łatwa migracja między maszynami.

Opis

yadm to menedżer plików konfiguracyjnych, który traktuje katalog domowy jak repozytorium Git. Zamiast tworzyć symlink do katalogu z dotfilesami (jak robi to stow), yadm przechowuje właściwe pliki w ukrytym katalogu ~/.yadm/repo/ i generuje symlinki w ~. To daje pełną historię zmian (git log ~/.zshrc), łatwe cofanie (git checkout) i natychmiastową migrację na nową maszynę (git clone + yadm bootstrap). Narzędzie jest napisane w Bashu, więc działa na każdym systemie z git i ln. Nie wymaga dodatkowego runtime — wystarczy git i bash. W Arch instaluje się przez pacman -S yadm, w Debianie i Ubuntu apt install yadm, w Fedorze dnf install yadm, w Alpinie apk add yadm, na macOS przez brew install yadm.

Przykłady

$ yadm bootstrap git@github.com:user/dotfiles.git
Zainicjalizuj repo z istniejącym repozytorium Git i podłącz je jako ~/.yadm/repo
$ yadm bootstrap
Zainicjalizuj puste repo w ~/.yadm/repo (pierwsze uruchomienie na nowej maszynie)
$ yadm manage .zshrc
Dodaj plik do repo: yadm skopiuje go do ~/.yadm/repo/ i wygeneruje symlink w ~
$ yadm forget .zshrc
Wyłącz symlink i usuń plik z repo (zostaje kopia w repo)
$ yadm status
Status repo — jak git status, ale dla dotfilesów
$ yadm diff
Różnica między ~ a repo (co zmieniłeś od ostatniego commita)
$ yadm add .zshrc .vimrc .bashrc
Dodaj wiele plików naraz
$ yadm commit -m "Dopasowanie aliasów i promptu"
Commit z opisem (git commit pod spodem)
$ yadm push
Push do remote (git push pod spodem)
$ yadm log .zshrc
Historia zmian konkretnego pliku
$ yadm checkout HEAD~1 -- .zshrc
Cofnij .zshrc do poprzedniego commita
$ yadm branch
Lista gałęzi (git branch pod spodem)
$ yadm stow
Przełącz na tryb stow (symlink do katalogu zamiast pliku) — kompatybilność

Flagi

FlagaOpis