if command -v eza >/dev/null 2>&1; then alias ls='eza --icons --group-directories-first' alias ll='eza -la --icons --group-directories-first --git' alias la='eza -a --icons --group-directories-first' alias l='eza --icons --group-directories-first' alias lt='eza --tree --level=2 --icons --git' else alias ls='ls --color=auto' alias ll='ls -la --color=auto' alias la='ls -A --color=auto' alias l='ls -CF --color=auto' if command -v tree >/dev/null 2>&1; then alias lt='tree -L 2' else lt() { find "${1:-.}" -maxdepth 2 | sed 's|[^/]*/| |g'; } fi fi

{ "aliases": { "ll": { "_note": "Long listing with hidden files", "windows": "eza -la --icons --group-directories-first | Get-ChildItem -Force", "unix": "eza -la --icons --group-directories-first | ls -la" } } }

if ! command -v bat >/dev/null 2>&1 && command -v batcat >/dev/null 2>&1; then bat() { batcat "$@"; } fi if ! command -v fd >/dev/null 2>&1 && command -v fdfind >/dev/null 2>&1; then fd() { fdfind "$@"; } fi

Subcommand

Behaviour

dotfiles help [query]

fzf interactive if no query; rg/grep keyword filter otherwise

dotfiles list

Reads shared/tools.json via jq; column-formatted

dotfiles version

Reads VERSION file + git rev-parse --short HEAD

dotfiles update

git pull, re-runs installer, reloads shell

dotfiles edit

Opens $DOTFILES in $EDITOR

dotfiles explain <name>

Looks up aliases.json → tools.json → --help

dotfiles agent --setup

Sources shell/lib/agent.sh; downloads llama-cli + model

dotfiles agent "<query>"

Sources shell/lib/agent.sh; runs inference

Feature

bash (bashrc.sh)

zsh (zshrc.sh)

History

HISTCONTROL, shopt -s histappend, PROMPT_COMMAND

setopt HIST_IGNORE_ALL_DUPS, SHARE_HISTORY

Shell options

shopt -s globstar cdspell autocd

setopt AUTO_CD AUTO_PUSHD GLOB_DOTS EXTENDED_GLOB

Completion

/usr/share/bash-completion/bash_completion

autoload -Uz compinit (guarded for oh-my-zsh)

zoxide init

eval "$(zoxide init bash)"

eval "$(zoxide init zsh)"

Starship init

eval "$(starship init bash)"

eval "$(starship init zsh)" + oh-my-zsh guard

Key bindings

(bash-completion handles)

bindkey -e, custom arrow-key history search

# grep → ripgrep if command -v rg >/dev/null 2>&1; then alias grep='rg' else alias grep='grep --color=auto' fi # cat → bat if command -v bat >/dev/null 2>&1; then alias cat='bat --style=plain' else : # cat is a builtin — no alias needed fi

# CORRECT — detect package manager if command -v apt-get >/dev/null 2>&1; then sudo apt-get install -y bat elif command -v brew >/dev/null 2>&1; then brew install bat elif command -v pacman >/dev/null 2>&1; then sudo pacman -S --noconfirm bat fi

Banned (bashism)

Use instead

[[ ]]

[ ]

echo -e

printf

${var,,} / ${var^^}

POSIX tr or awk

local inside sourced (non-function) context

Move to a function or use a _prefix_ name

$(< file)

$(cat file)