ADLee's Dotfiles

Personal configuration files for a fast, consistent dev environment across Linux/macOS.

┌[alee@catchthesethighs]─[~/.dotfiles ⎇ main]
└%

What's Included

Component	Description
Zsh Theme	Git status, command timer, smart path truncation
Espanso	100+ text snippets (..date, ..gst, ..dps)
CLI Tools	fzf, bat, eza integrations
Snapper	Btrfs snapshot helpers for CachyOS/Arch

Quick Start

# One-liner
curl -fsSL https://raw.githubusercontent.com/adlee-was-taken/dotfiles/main/install.sh | bash

# Or clone first
git clone https://github.com/adlee-was-taken/dotfiles.git ~/.dotfiles
cd ~/.dotfiles && ./install.sh

The installer backs up existing configs, installs oh-my-zsh, and creates symlinks.

Repository Layout

dotfiles/
├── install.sh              # Main installer
├── zsh/
│   ├── .zshrc              # Shell config
│   ├── themes/adlee.zsh-theme
│   └── functions/snapper.zsh
├── espanso/
│   ├── config/default.yml
│   └── match/base.yml      # 100+ snippets
├── git/.gitconfig
├── vim/.vimrc
├── tmux/.tmux.conf
├── bin/                    # Helper scripts
└── docs/                   # Extended docs

Espanso Snippets

All triggers use .. prefix to avoid accidents.

Category	Examples
Time	..date → 2025-12-14, ..ts → ISO timestamp, ..epoch
Git	..gstat, ..gcm, ..branch (current branch)
Docker	..dps, ..dcup, ..dlog
Symbols	..shrug → ¯\_(ツ)_/¯, ..check → ✓

Full list: docs/ESPANSO.md

Theme Features

• Git integration – ⎇ branch with dirty indicator (*)
• Command timer – shows elapsed time for commands >10s
• Smart paths – truncates long directories
• User detection – blue prompt for users, red for root

Customization

# Edit theme
vim ~/.dotfiles/zsh/themes/adlee.zsh-theme
source ~/.zshrc

# Add espanso snippets
vim ~/.dotfiles/espanso/match/base.yml
espanso restart

# Add aliases
vim ~/.dotfiles/zsh/.zshrc

System-Wide Theme Deployment

Share the theme across all users:

sudo ./bin/deploy-zshtheme-systemwide.sh --all     # All users
sudo ./bin/deploy-zshtheme-systemwide.sh --status  # Check status

Updating

cd ~/.dotfiles
git pull origin main
./install.sh

Snapper Integration (CachyOS/Arch)

For btrfs systems with limine-snapper-sync:

snap-create "Before update"   # Create + validate limine entry
snap-list                     # Recent snapshots
snap-check-limine             # Verify boot menu sync

Troubleshooting

Issue	Fix
Theme not loading	Check ZSH_THEME="adlee" in ~/.zshrc, then source ~/.zshrc
Espanso not working	espanso status, then espanso restart
Broken symlinks	cd ~/.dotfiles && ./install.sh

License

MIT – See LICENSE

---

Author: Aaron D. Lee
Repo: https://github.com/adlee-was-taken/dotfiles