This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Der dotfiles-Befehl
Einheitlicher Einstiegspunkt für alles rund um dieses Repo (scripts/dotfiles, verlinkt nach ~/.local/bin/dotfiles). Direkter Aufruf:
dotfiles <befehl> [optionen]
Befehle
| Befehl | Macht |
|---|---|
dotfiles help |
Diese Übersicht anzeigen |
dotfiles check-updates |
Prüft, ob neue Commits verfügbar sind – ohne zu aktualisieren |
dotfiles update |
Auf den neuesten Stand bringen: git pull, fehlende Komponenten nachinstallieren, Symlinks auffrischen, Plugins aktualisieren, optionales Post-Setup |
dotfiles reconfigure |
Wie update, fragt aber alle Post-Setup-Schritte (Git-Identität, Terminal/Fonts, SSH-Key, Root-Setup) erneut ab, auch wenn sie schon einmal beantwortet wurden |
dotfiles uninstall |
Entfernt Symlinks, Plugin-Caches und gemerkten Zustand. Fragt interaktiv, ob zusätzlich das Repo-Verzeichnis und/oder installierte Pakete entfernt werden sollen |
dotfiles reinstall |
Kompletter Neuanfang: Uninstall (Repo wird immer mitgelöscht) + frischer Klon/Setup. Bei der neuen Komponenten-Abfrage abgewählte Tools (eza/yazi/starship) werden danach automatisch deinstalliert, siehe README.md |
Optionen
Werden an update/reconfigure/reinstall durchgereicht:
| Option | Wirkung |
|---|---|
-v, --verbose |
Volle Ausgabe statt Spinner (nützlich bei langen Cargo-Kompilierungen) |
--headless |
GUI-Schritte (Terminal-Profil, Nerd-Font-Installation) überspringen |
--with=LISTE |
Optionale Komponenten explizit setzen, z.B. --with=eza,yazi,starship,nvim-lsp, --with=all, --with=none |
Alte Aliase (weiterhin vorhanden)
update-dotfiles / update-dotfiles-verbose (Zsh-Funktionen, siehe Zsh) rufen intern direkt bash $DOTFILES_DIR/update.sh auf statt über dotfiles update – bewusst so, damit ein kaputter dotfiles-PATH sich damit trotzdem reparieren lässt (kein Henne-Ei-Problem). Funktional identisch zu dotfiles update, Flags werden durchgereicht (update-dotfiles --reconfigure ≙ dotfiles reconfigure).
Bis 2026-09 waren das Aliase, was ein stilles Problem hatte: bei einem Alias hängt die Shell nachgestellte Argumente ans Ende der Expansion –
--reconfigurelandete also beiexec zsh(zsh: no such option: reconfigure) statt beiupdate.sh, die Post-Setup-Fragen blieben trotz des Flags übersprungen. Als Funktion mit"$@"ist das behoben.
Optionale Komponenten im Detail
Core (immer installiert): Zsh, Tmux, Neovim (Basis-Editor ohne LSP).
| Komponente | Was es bringt |
|---|---|
eza |
ls-Ersatz mit Farben & Icons |
yazi |
Terminal-Dateimanager (siehe Eza-and-Yazi) |
starship |
Prompt mit Git-Status, siehe Prompt |
nvim-lsp |
LSP/Autocomplete in Neovim (Mason, lua_ls+bashls), siehe Neovim – eher für Arbeits-/Coding-Rechner als für schlanke Server |
Auswahl wird gespeichert unter $XDG_STATE_HOME/dotfiles/components (maschinenlokal, nicht Teil des Git-Repos) – nachträglich ändern mit dotfiles update --with=....