YADRLite

YADRLite is a highly-modular, lightning-fast dotfiles collection designed for cross-platform portability. Built on top of Homebrew and Zsh, it provides a unified configuration experience across macOS and Linux without the brittle OS-detection scripts.

It provisions modern, GPU-accelerated terminals, intelligent tiling window managers, and powerful IDE-like Neovim setups out of the box.

Credit: This repository is heavily based on the excellent YADR, trimmed down considerably for speed and portability. Check out the original repo if you work heavily in Python or Ruby.

The Architecture

YADRLite is driven by a completely dynamic feature router. It doesn't rely on monolithic bash scripts. Instead, you define exactly what you want via --with-<feature> flags.

The router simply looks for <feature>.Brewfile bundles and hooks/pre/<feature>.zsh lifecycle hooks, making it infinitely scalable.

---

⚡ Installation

Requirements: git

1. Bootstrap the environment: This single command installs Homebrew (if missing), updates Git and Zsh, sets your default shell, and clones the repository.

/bin/sh -c "`curl -fsSL https://raw.githubusercontent.com/odysseyalive/dotfiles/master/install.sh`"

2. Install Development Tools: Installs Node.js, Go tools, ripgrep, fd, starship, and essential language servers.

zsh ~/.yadrlite/setup.zsh tools

---

🖥️ Workstation Setups

macOS Workstation

Transform your Mac into a tiling window manager setup (no SIP disable required).

zsh ~/.yadrlite/setup.zsh --macos --with-macos
# or use the shorthand alias:
zsh ~/.yadrlite/setup.zsh macos

This installs:

• Ghostty - Modern GPU-accelerated terminal with Kitty graphics protocol.
• AeroSpace - i3-like tiling window manager.
• Sketchybar - Custom status bar.
• JankyBorders - Window border highlighting.

Arch / Linux Workstation

For Linux environments, specifically targeted at Omarchy:

zsh ~/.yadrlite/setup.zsh --linux --with-omarchy
# or use the shorthand alias:
zsh ~/.yadrlite/setup.zsh omarchy

Headless Servers / Linux without zsh

For headless servers and remote Linux hosts where zsh isn't installed (and you don't want to pull in Homebrew either), use the headless flow. Both bootstrap and management run under bash; no zsh dependency anywhere.

1. Bootstrap with the --headless flag — install.sh skips the Homebrew install, skips the Zsh install, doesn't run chsh, and writes shell config to ~/.bashrc instead of ~/.zshrc. The only prerequisite is git.

# Option A: pass --headless through curl-piping
bash -c "$(curl -fsSL https://raw.githubusercontent.com/odysseyalive/dotfiles/master/install.sh)" -- --headless

# Option B: set the env var (equivalent)
YADR_HEADLESS=1 bash -c "$(curl -fsSL https://raw.githubusercontent.com/odysseyalive/dotfiles/master/install.sh)"

2. Manage the install with setup.sh — the bash entry point. It mirrors setup.zsh exactly (same flags, same actions, same feature hooks). Every hook under setup/hooks/ is a portable .sh file that runs in both bash and zsh, so no behavior is lost on a headless box.

bash ~/.yadrlite/setup.sh help
bash ~/.yadrlite/setup.sh --upgrade
bash ~/.yadrlite/setup.sh --with-langs       # ASDF-managed languages
bash ~/.yadrlite/setup.sh tools              # node + go tooling

Features that depend on tools you don't have on a server (Homebrew bundles, AeroSpace, Ghostty, Sketchybar, fontconfig, etc.) are skipped automatically with a friendly warning — they don't abort the run.

Optional Features

• Language Management (ASDF): Install languages dynamically using ASDF via --with-langs or granular versions via --with-lang-<name>-<version>. If you prefer legacy installers (NVM/G-Install), use --without-asdf.

  zsh ~/.yadrlite/setup.zsh --with-langs
  zsh ~/.yadrlite/setup.zsh --with-lang-ruby-3.2.0

• GNU Linuxify (macOS): Standardize your macOS coreutils to use GNU versions via Homebrew.

  zsh ~/.yadrlite/setup.zsh --with-gnu

• Keyboard Remap (macOS): Swaps Caps Lock and Escape keys using hidutil.

  zsh ~/.yadrlite/setup.zsh --with-keyboard

---

📚 Documentation & Shortcuts

We've moved the massive lists of shortcuts and editor documentation into their own dedicated guides. YADRLite includes heavily optimized configurations for:

• LazyVim (Modern IDE Setup) - Highly Recommended
• Tmux
• Vim (Classic)
• Ranger (File Manager)
• AeroSpace (macOS Window Manager)
• Ghostty (Terminal)
• Kitty (Terminal)
• Hyprland (Linux Window Manager)

---

🔄 Maintenance & Uninstallation

Apply Rolling Migrations & Updates: Safely updates the repository, refreshes tmux plugins, and applies any new configuration changes automatically (e.g., migrating from legacy NVM to ASDF).

zsh ~/.yadrlite/setup.zsh --upgrade --migrate

On headless servers without zsh, use the bash entry point — --upgrade and --migrate run natively under bash:

bash ~/.yadrlite/setup.sh --upgrade --migrate

Uninstall and Restore (Local): Restores your original ~/.bashrc, ~/.zshrc, and other configs to their pre-YADRLite state.

/bin/sh ~/.yadrlite/uninstall.sh

Uninstall and Restore (Remote): If your local directory is broken or deleted, you can uninstall remotely:

/bin/sh -c "`curl -fsSL https://raw.githubusercontent.com/odysseyalive/dotfiles/master/uninstall.sh`"

Note: To violently remove all Homebrew packages managed by YADRLite as well, pass the --all and --force flags to the uninstaller.

---

Maintained with Claude Enforcer