█████╗  █████╗ ███████╗██╗  ██╗██╗   ██╗████████╗ ██████╗ ███████╗██╗  ██╗
██╔══██╗██╔══██╗██╔════╝██║  ██║██║   ██║╚══██╔══╝██╔═══██╗██╔════╝██║  ██║
███████║███████║███████╗███████║██║   ██║   ██║   ██║   ██║███████╗███████║
██╔══██║██╔══██║╚════██║██╔══██║██║   ██║   ██║   ██║   ██║╚════██║██╔══██║
██║  ██║██║  ██║███████║██║  ██║╚██████╔╝   ██║   ╚██████╔╝███████║██║  ██║
╚═╝  ╚═╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝ ╚═════╝    ╚═╝    ╚═════╝ ╚══════╝╚═╝  ╚═╝

• Screenshots
• Features
• Included Configurations
• Installation
• Updating an Existing Installation
• 🩺 Diagnose & Repair
• Zsh Is Required
• About ~/.local/bin/env
• What install.sh Actually Does
• What bootstrap.sh Actually Does
• Repository Structure
• Requirements
• Backups & Rollback
• Wallpaper Credits
• License

Hero shot: Hyprland + Omarchy shell + wallhaven

Ghostty + Fastfetch + Starship	Editor workflow in VS Code

LazyVim	Yazi file manager	Idle screensaver

alacritty · atuin · btop · fastfetch · fish · foot · ghostty · hyprland
kitty · lazydocker · lazygit · mise · mpv · neovim · omarchy · starship
tmux · voxtype · VS Code · yazi · zellij · zsh

curl -fsSL https://raw.githubusercontent.com/Aashutosh31/dotfiles/main/bootstrap.sh | bash

Handles everything: installs git/yay if missing, clones the repo, and runs the installer.

git clone https://github.com/Aashutosh31/dotfiles.git
cd dotfiles
chmod +x install.sh
./install.sh

After installation, if Hyprland is running, reload the config to apply changes:

hyprctl reload

Then open a new terminal — the installer makes sure zsh is your login shell, and a shell change only applies to new login sessions.

install.sh is safe to re-run at any time — that is the update mechanism:

cd ~/dotfiles
git pull
./install.sh

• Every file it overwrites is backed up first to ~/.dotfiles-backup/<timestamp>/.
• It never deletes your config directories and never removes files that only exist on your system.
• It does not perform a system upgrade (no pacman -Syu) — on Omarchy, upgrades belong to omarchy update, which the installer never bypasses. It only installs packages from packages/ that are missing.
• If something in your shell environment is still off afterwards, see Diagnose & Repair below.

Two companion scripts let you fix problems without reinstalling everything.

./doctor.sh

Checks, without touching anything:

Exit code is non-zero when any required component is missing, so you can use it in scripts or CI.

./repair.sh

Safe and idempotent — run it as many times as you like; unchanged state prints [SKIP]. It:

1. Installs only required packages that are actually missing.
2. Ensures zsh is installed and listed in /etc/shells.
3. Sets your login shell to zsh — only if it isn't already (never repeats chsh), printing a clear message and reminding you to start a new session.
4. Recreates ~/.local/bin/env / env.fish when they are missing (see below).
5. Re-applies only the shell-related configs (.zshrc, .XCompose, starship, fish, mise, atuin) — each backed up before being overwritten.

It never runs a system upgrade, never deletes home/config data, and exits non-zero if anything could not be fixed.

This setup requires Zsh. The shell environment depends on zsh-specific features:

• zsh options & completion (setopt, autoload -Uz compinit)
• zoxide integration (z, cd=z)
• atuin history integration (eval "$(atuin init zsh)")
• zsh-autosuggestions & zsh-syntax-highlighting
• Starship prompt
• all existing aliases/functions in .zshrc

install.sh and repair.sh both ensure: zsh installed → /bin/zsh present and listed in /etc/shells → login shell set to /bin/zsh (only when needed). After the change you must start a new login session/terminal for it to take effect. Don't try to source ~/.zshrc from Bash — it uses zsh-only builtins and will error.

The last line of .zshrc sources ~/.local/share/../bin/env (= ~/.local/bin/env). That file is created by uv's standalone installer (curl -LsSf https://astral.sh/uv/install.sh | sh), not by mise, Omarchy, pacman, or this repo. On a fresh machine where uv was never installed standalone, the file doesn't exist and every zsh startup ends with:

/home/<you>/.local/share/../bin/env: No such file or directory

install.sh and repair.sh recreate this file — byte-for-byte identical to uv's template — whenever it is missing, so the shell always starts cleanly even before uv itself is installed.

.
├── alacritty/
├── atuin/
├── btop/
├── doctor.sh       # read-only installation health check
├── fastfetch/
├── fish/
├── foot/
├── ghostty/
├── home/          # ~/.zshrc, ~/.XCompose
├── hypr/          # Hyprland Lua config (Quattro)
├── kitty/
├── lazydocker/
├── lazygit/
├── mise/
├── mpv/
├── nvim/
├── repair.sh      # safe, idempotent in-place repair
├── vscode/
├── omarchy/       # shell, bar plugin, theme, hooks, theme.name
├── bootstrap.sh   # one-shot installer for fresh machines
├── packages/       # pacman.txt, aur.txt
├── scripts/       # omarchy-launch-about, lib/shell-env.sh
├── starship/
├── tmux/
├── voxtype/
├── wallpapers/
├── yazi/
└── zellij/

• Arch Linux
• Omarchy
• Zsh (installed and set as login shell automatically by install.sh / repair.sh — required for this setup to function)
• yay (auto-installed by bootstrap.sh if missing)
• Git

Every run of install.sh creates a fresh timestamped snapshot before touching anything:

~/.dotfiles-backup/20260701-143022/

To roll back a specific config manually:

cp -a ~/.dotfiles-backup/<timestamp>/.config/<tool> ~/.config/

MIT License