Managed with GNU Stow via Task.
<tool>/... one stow package per tool; contents mirror $HOME
linux/<tool>/... Linux-only overlays
Rules:
- A package is named after the tool and lives at the repo root.
- Package directories are discovered automatically.
linux/lid-serveris a separate, opt-in system installer and is never stowed into$HOME. - Retired configs are deleted; git history is the archive.
- Linux hosts get git/vim config from nix, so those packages are not stowed on Linux.
- Linux Ghostty keeps
~/.config/ghostty/configas a regular file. Stow linksshared.conffrom the root package andlinux.conffromlinux/ghostty, and skips the macOSconfigfile.
task stow # all root packages (default on every OS)
task stow -- vim # just vim
task stow -- --mac lazyvim # just lazyvim
task stow -- --linux # Linux overlays plus shared root packages
task stow -- --linux nvim # shared Neovim config
task stow -- --linux herdr # shared Herdr config
task stow:dry -- --linux nvim # list existing files whose contents differ
./scripts/dryrun.sh # preview all root packages
The preview prints only short target paths, such as ~/.config/nvim/init.lua.
New files and identical contents are omitted; an empty list prints
No differing files (macos). (or linux).
Use ./scripts/dryrun.sh linux or ./scripts/dryrun.sh macos nvim to select
a platform or package. It never overwrites files. Stow still refuses conflicting
regular files or symlinks during installation, even if their contents match.
Arguments after -- select --mac (the default) or --linux, followed by at
most one package name. A macOS name must match a package directory at the repo
root. A Linux name must match herdr, nvim, or ghostty at the root, or a
directory under linux/. For example, task stow -- --linux lazyvim works once
linux/lazyvim/ exists. Selecting Ghostty also installs its shared settings
and, on Linux, adds its config includes. lid-server remains a separate task.
For plain Stow, select packages from the repo root:
stow --no-folding -t "$HOME" -d ~/.dotfiles -R nvim herdr vimWhen upgrading from macos/<tool> packages, unstow before checking out this
layout, while macos/ is still present:
stow --no-folding -t "$HOME" -d ~/.dotfiles/macos -D \
alacritty ccstatusline copyq ghostty git hammerspoon kitty lazyvim starship tmux vimAfter updating, task stow recreates the links from the repo root.
To bring a live config under management, copy it into its package directory at its $HOME-relative path, then stow --adopt that package once.
Install Git, GNU Stow and Task (the go-task runner), then clone this repo:
git clone https://github.com/archae0pteryx/dotfiles.git ~/.dotfiles
cd ~/.dotfiles
task stow:dry -- --linux
task stow -- --linuxThese tasks install config links, not applications or a desktop environment. Install Ghostty, Neovim, Herdr, Rofi and Conky separately if you use them. On a host without nix managing Git/Vim, install and configure those separately too.
Stow stops on conflicting files. Back up and move only the files it reports,
then repeat the preview. Use --adopt only when deliberately importing a live
config: it moves that file into the repo and can replace the tracked version.
Linux setup creates ~/.config/ghostty/config if needed and appends the shared
and Linux includes once, preserving existing settings. On Omarchy this stays
a regular file so its font and display tools can edit it. If your config is a
symlink, make a backup and convert it to a regular file first. The dry run only
compares package files; it does not create or append this file.
Rofi's bundled themes and applets target an X11 desktop. Install the fonts they
reference (Nerd Fonts and Feather) and Papirus icons; applet commands in
linux/rofi/.config/rofi/applets/bin/ also depend on your desktop and apps.
For example, apps.sh uses pacman, screenshots use maim/xdotool, audio
uses amixer, and power menus use systemctl and a screen locker. Review the
commands before using them on another distro or Wayland desktop.
Before starting Conky, edit linux/conky/.config/conky/conky.conf for the new
machine: it currently uses the enp5s0 network interface, an NVIDIA GPU
(nvidia-smi), FiraCode Nerd Font and an X11 desktop.
The optional lid-server setup disables sleep on
a dedicated laptop server. Normal task stow never changes /etc or sleep
settings. Existing task linux, task macos and per-package macOS commands
remain available; for one Linux-only package use
stow --no-folding -t "$HOME" -d linux -R <tool>. Use
task stow -- --linux ghostty for Ghostty so its macOS config file is not linked.
Run bash tests/stow.sh to check Linux and macOS installation in temporary
homes, including conflict handling and repeat installs. Requires Task and Stow.