zsh setup

gistfile1.txt

# ══════════════════════════════════════════════════════════════════════
#  SETUP — install everything this file depends on
# ══════════════════════════════════════════════════════════════════════
# Core tools (one line). Run once on a fresh machine:
#
#   brew install starship fzf zoxide eza bat
#
#   starship  — the prompt
#   fzf       — fuzzy finder (Ctrl+R history, Ctrl+T files)
#   zoxide    — smart cd (`z <partial>` jumps to frequent dirs)
#   eza       — modern ls (NOT exa, which is unmaintained)
#   bat       — cat with syntax highlighting
# ══════════════════════════════════════════════════════════════════════


# ── History ───────────────────────────────────────────────────────────
# 100k entries, shared live across tabs, no duplicates kept.
# SHARE_HISTORY already implies incremental append, so INC_APPEND is dropped.
HISTSIZE=100000
SAVEHIST=100000
HISTFILE=~/.zsh_history
setopt SHARE_HISTORY          # all open shells read/write the same history live
setopt HIST_IGNORE_ALL_DUPS   # drop older duplicate when a new dup is added
setopt HIST_REDUCE_BLANKS     # collapse superfluous whitespace before saving
setopt HIST_FIND_NO_DUPS      # skip dups when cycling through history search

# ── Completions ───────────────────────────────────────────────────────
# Rebuild the completion dump at most once every 24h instead of every launch.
# -C skips the security check and just loads the cached dump (the fast path).
autoload -Uz compinit
if [[ -n ~/.zcompdump(#qN.mh+24) ]]; then
  compinit            # cache is stale (older than 24h) -> full rebuild
else
  compinit -C         # cache is fresh -> load without rescanning
fi
zstyle ':completion:*' matcher-list 'm:{a-z}={A-Z}'   # case-insensitive matching
zstyle ':completion:*' menu select                     # arrow-key menu selection

# ── Cursor movement ───────────────────────────────────────────────────
# Option+Arrow jumps by word, Option+Backspace deletes a word.
# Two keycode variants because terminals disagree on what they emit.
bindkey '^[[1;3D' backward-word         # Option+Left
bindkey '^[[1;3C' forward-word          # Option+Right
bindkey '^[^?' backward-kill-word       # Option+Backspace
bindkey '^[[1;9D' backward-word         # Alt+Left  (some terminals)
bindkey '^[[1;9C' forward-word          # Alt+Right (some terminals)

# ── Prompt and shell tooling ──────────────────────────────────────────
# 2>/dev/null hides errors if a binary is missing, at the cost of silent
# breakage. If your prompt ever looks wrong, drop the redirect to see why.
eval "$(starship init zsh)" 2>/dev/null   # prompt
eval "$(fzf --zsh)" 2>/dev/null            # Ctrl+R fuzzy history, Ctrl+T files
eval "$(zoxide init zsh)" 2>/dev/null      # smart cd: `z <partial>`

# ── Aliases: navigation ──────────────────────────────────────────────
alias ..='cd ..'
alias ...='cd ../..'
alias ....='cd ../../..'

# ── Aliases: file listing (eza, colorful, dirs first) ────────────────
alias ls='eza --color --group-directories-first'
alias la='eza --color -la --group-directories-first'
alias ll='eza --color -l --group-directories-first'
alias lt='eza --color --tree --level=2'

# ── Aliases: git ─────────────────────────────────────────────────────
alias gs='git status'
alias gd='git diff'
alias gds='git diff --staged'
alias ga='git add'
alias gaa='git add --all'
alias gc='git commit'
alias gcm='git commit -m'
alias gp='git push'
alias gpl='git pull'
alias gl='git log --oneline --graph --all'
alias gco='git checkout'
alias gsw='git switch'
alias gb='git branch'
alias gst='git stash'
alias gstp='git stash pop'

# ── Aliases: bat (syntax-highlighted cat) ────────────────────────────
alias c='bat --style=plain'
alias b='bat'

# ── Editor ───────────────────────────────────────────────────────────
export EDITOR="nano"
export VISUAL="nano"

# ── Locale ───────────────────────────────────────────────────────────
export LANG=en_US.UTF-8

# ── Quality of life ──────────────────────────────────────────────────
setopt AUTO_CD                          # type a directory name to cd into it
alias path='echo $PATH | tr ":" "\n"'   # print PATH one entry per line
alias reload='source ~/.zshrc'          # re-source after edits
alias hosts='sudo nano /etc/hosts'      # edit the hosts file