4 Dotfiles CLI
dotfiles-sync edited this page 2026-09-24 08:13:52 +00:00
This file contains ambiguous Unicode characters

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 – --reconfigure landete also bei exec zsh (zsh: no such option: reconfigure) statt bei update.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=....