dotfiles

Personal development environment for Fedora (primary), with partial Debian/Arch support.

Structure

Managed with GNU Stow. Each directory is a stow package that maps to $HOME.

Package	Contents
`shell/`	`.bashrc`, `.bash_profile`, `.config/env/`, `.tmux/`, `.tmuxifier/`
`dev-config/`	Neovim, Kitty, Glance, Fastfetch configs
`hyprland/`	Hyprland, Hypridle, Waybar configs
`ai-config/`	Claude Code settings
`tmux-layouts/`	Tmuxifier session layouts

Bootstrap

Full environment setup (system packages + toolchains + dotfiles):

cd ~/dotfiles/bootstrap
python3 bootstrap.py          # Full bootstrap
python3 bootstrap.py -v       # Verbose
python3 bootstrap.py --skip step1,step2  # Skip steps

Or via Makefile:

make bootstrap                # Production
make bootstrap-fresh          # Force all steps (clear state)
make test                     # Run linter + tests

Deploy dotfiles only

cd ~/dotfiles
stow shell
stow --no-folding ai-config   # ai-config needs no-folding (runtime dirs coexist)

Prerequisites

Fedora 39+ (DNF)
git, stow, python3
SSH key in ~/.ssh/ for GitHub repos (workspace setup)

Utilities

# Verify shell environment
bash ~/dotfiles/tools/setup/shell-env-verify.sh

# System update + cleanup (Fedora)
bash ~/dotfiles/tools/sysadmin/safe-update-clean.sh

Bootstrap phases

Phase	Description
0	OS detection
1	System packages (DNF)
2	Toolchains (Rust, UV, FNM, Node, Starship)
3	Dev tools (Nerdfonts, TPM, ble.sh)
4	Applications (Zen Browser, Glance)
5	Dotfiles (stow)
6	Workspace (clone repos)
7	Validation

State is persisted in bootstrap/state.json — re-runs skip completed steps.

Name	skill-neovim-research
Description	Research Neovim APIs, plugin patterns, and Lua development. Invoke for lua-language research tasks.

skill-neovim-research