# ╔══════════════════════════════════════════════════════════════════════╗
# ║                                                                      ║
# ║   ~/.zshrc - дружелюбный конфиг для macOS                            ║
# ║   Что внутри:                                                        ║
# ║     - Тема jonathan (минималистичная встроенная OMZ)                 ║
# ║     - Плагины Oh My Zsh + zsh-autosuggestions + fast-syntax-highlight║
# ║     - Большая история, общая между терминалами                       ║
# ║     - Безопасные rm / cp / mv (переспрашивают)                       ║
# ║     - Полезные алиасы и функции                                      ║
# ║     - Поддержка eza / bat / zoxide / fzf если установлены            ║
# ║                                                                      ║
# ║   Не забудь установить (один раз):                                   ║
# ║     brew install eza bat zoxide fzf                                  ║
# ║     $(brew --prefix)/opt/fzf/install --all                           ║
# ║                                                                      ║
# ╚══════════════════════════════════════════════════════════════════════╝


# ┌──────────────────────────────────────────────────────────────────────┐
# │ 1. PATH - дополнительные пути для исполняемых файлов                 │
# └──────────────────────────────────────────────────────────────────────┘
# Раскомментируй, если у тебя свои скрипты в ~/bin или ~/.local/bin
# export PATH="$HOME/bin:$HOME/.local/bin:$PATH"

# Homebrew подгружает свой PATH сам. На Apple Silicon путь /opt/homebrew/bin,
# на Intel - /usr/local/bin. Если brew команда не находится, раскомментируй:
# eval "$(/opt/homebrew/bin/brew shellenv)"


# ┌──────────────────────────────────────────────────────────────────────┐
# │ 2. Окружение (язык, редактор)                                        │
# └──────────────────────────────────────────────────────────────────────┘
export LANG=en_US.UTF-8
export EDITOR='nano'                # nano - простой и понятный новичку
                                    # позже можно поменять на 'vim' или 'code -w'


# ┌──────────────────────────────────────────────────────────────────────┐
# │ 3. Oh My Zsh                                                         │
# └──────────────────────────────────────────────────────────────────────┘
export ZSH="$HOME/.oh-my-zsh"

# ─── Тема промпта ─────────────────────────────────────────────────────
# jonathan - минималистичная встроенная тема OMZ
ZSH_THEME="jonathan"

# Альтернативы (раскомментируй одну, текущую закомментируй):
# ZSH_THEME="powerlevel10k/powerlevel10k"   # информативная, нужен визард p10k configure
# ZSH_THEME="agnoster"                       # сегментированная (нужен Nerd Font)
# ZSH_THEME="robbyrussell"                   # дефолтная OMZ

# ─── Поведение OMZ ────────────────────────────────────────────────────
zstyle ':omz:update' mode reminder         # напоминать об обновлениях, но не ставить молча
zstyle ':omz:update' frequency 14          # раз в 14 дней

# ─── Плагины OMZ (через ПРОБЕЛ, не запятую) ───────────────────────────
plugins=(
  git                       # десятки git-алиасов: gst, gco, gp, gcb, glog
  brew                      # автокомплит и алиасы для Homebrew
  macos                     # cdf (cd в папку Finder), quick-look, man-preview
  sudo                      # двойной ESC = подставить sudo в начало команды
  extract                   # x archive.zip / x file.tar.gz - универсальная распаковка
  copypath                  # copypath - путь файла в буфер обмена
  copyfile                  # copyfile - содержимое файла в буфер
  copybuffer                # Ctrl+O - текущая набранная команда в буфер
  command-not-found         # подскажет какой brew install нужен
  colored-man-pages         # man-страницы в цветах
  web-search                # google "запрос", duckduckgo "запрос"
  z                         # z имя_папки - переход в недавно посещённую
  history                   # h, hs - удобства с историей
)

source $ZSH/oh-my-zsh.sh


# ┌──────────────────────────────────────────────────────────────────────┐
# │ 4. Дополнительные плагины (свой загрузчик с автоклонированием)       │
# │    Достаточно добавить строку в массив - при следующем запуске       │
# │    плагин склонируется и подключится автоматически.                  │
# └──────────────────────────────────────────────────────────────────────┘
zsh_plugins=(
  mattmc3/ez-compinit                          # быстрая инициализация автодополнения
  zsh-users/zsh-autosuggestions                # серым подсказывает команду из истории
  zsh-users/zsh-completions                    # расширенный автокомплит для кучи команд
  romkatv/powerlevel10k                        # тема (сама подгружается через ZSH_THEME)
  zdharma-continuum/fast-syntax-highlighting   # подсветка синтаксиса (ВСЕГДА ПОСЛЕДНИЙ)
)

# Стиль оформления автодополнений
zstyle ':plugin:ez-compinit' 'compstyle' 'zshzoo'

# Клонируем и подключаем
ZSH_PLUGINS_HOME=${ZDOTDIR:-$HOME}/.zsh_plugins
for zplugin in $zsh_plugins; do
  [[ -d $ZSH_PLUGINS_HOME/$zplugin ]] \
    || git clone --depth=1 https://github.com/$zplugin $ZSH_PLUGINS_HOME/$zplugin
  # Powerlevel10k подключается через ZSH_THEME, отдельный source не нужен
  if [[ "$zplugin" != "romkatv/powerlevel10k" ]]; then
    source $ZSH_PLUGINS_HOME/${zplugin}/${zplugin:t}.plugin.zsh 2>/dev/null \
      || source $ZSH_PLUGINS_HOME/${zplugin}/${zplugin:t}.zsh 2>/dev/null
  fi
done

# Подгрузка конфига p10k (создастся визардом p10k configure)
[[ ! -f ~/.p10k.zsh ]] || source ~/.p10k.zsh


# ┌──────────────────────────────────────────────────────────────────────┐
# │ 5. История команд                                                    │
# └──────────────────────────────────────────────────────────────────────┘
HISTFILE=~/.zsh_history
HISTSIZE=50000                  # сколько команд держать в памяти
SAVEHIST=50000                  # сколько сохранять на диск

setopt HIST_IGNORE_DUPS         # не сохранять подряд одинаковые
setopt HIST_IGNORE_ALL_DUPS     # удалять старые дубликаты
setopt HIST_IGNORE_SPACE        # команда с пробелом впереди не попадёт в историю
setopt HIST_REDUCE_BLANKS       # убирать лишние пробелы
setopt HIST_VERIFY              # !! и !$ показывают команду перед выполнением
setopt SHARE_HISTORY            # история общая между всеми открытыми терминалами
setopt INC_APPEND_HISTORY       # сохранять сразу после ввода, не при выходе
setopt EXTENDED_HISTORY         # с метками времени


# ┌──────────────────────────────────────────────────────────────────────┐
# │ 6. Поведение шелла                                                   │
# └──────────────────────────────────────────────────────────────────────┘
setopt AUTO_CD                  # просто "Documents" вместо "cd Documents"
setopt CORRECT                  # "git stauts" → "did you mean git status?"
setopt INTERACTIVE_COMMENTS     # # комментарии работают в интерактиве
setopt AUTO_PUSHD               # cd запоминает стек посещённых папок
setopt PUSHD_IGNORE_DUPS        # без дубликатов в стеке
setopt PUSHD_SILENT             # без шума при pushd
setopt NO_BEEP                  # тишина при ошибке
setopt EXTENDED_GLOB            # расширенные шаблоны: ^foo, foo~bar, **/foo

# Tab-комплит без учёта регистра ("doc<TAB>" найдёт "Documents")
zstyle ':completion:*' matcher-list 'm:{a-zA-Z}={A-Za-z}'

# Меню выбора при двойном Tab
zstyle ':completion:*' menu select

# Цветной комплит файлов
zstyle ':completion:*' list-colors "${(s.:.)LS_COLORS}"


# ┌──────────────────────────────────────────────────────────────────────┐
# │ 7. Безопасные команды (страховка от случайного удаления)             │
# └──────────────────────────────────────────────────────────────────────┘
alias rm='rm -i'                # rm спросит подтверждение
alias cp='cp -i'                # cp спросит, если перезаписывает
alias mv='mv -i'                # mv спросит, если перезаписывает
alias mkdir='mkdir -p'          # mkdir создаст промежуточные папки


# ┌──────────────────────────────────────────────────────────────────────┐
# │ 8. Навигация                                                         │
# └──────────────────────────────────────────────────────────────────────┘
alias ..='cd ..'
alias ...='cd ../..'
alias ....='cd ../../..'
alias .....='cd ../../../..'
alias ~='cd ~'
alias dl='cd ~/Downloads'
alias dt='cd ~/Desktop'
alias docs='cd ~/Documents'
alias o='open .'                # открыть текущую папку в Finder


# ┌──────────────────────────────────────────────────────────────────────┐
# │ 9. Утилиты                                                           │
# └──────────────────────────────────────────────────────────────────────┘
alias c='clear'
alias h='history'
alias path='echo -e ${PATH//:/\\n}'                     # $PATH построчно
alias myip='curl -s ifconfig.me; echo'                  # внешний IP
alias localip="ipconfig getifaddr en0"                  # IP в локальной сети
alias myssid="networksetup -getairportnetwork en0"      # имя текущего Wi-Fi
alias ports='lsof -i -P -n | grep LISTEN'               # кто слушает какие порты
alias weather='curl -s "wttr.in/Moscow?lang=ru&M"'      # погода в Москве
alias zshrc='${EDITOR:-nano} ~/.zshrc'                  # быстро открыть конфиг
alias reload='source ~/.zshrc && echo "✓ конфиг перезагружен"'


# ┌──────────────────────────────────────────────────────────────────────┐
# │ 10. Размеры и диск                                                   │
# └──────────────────────────────────────────────────────────────────────┘
alias df='df -h'
alias du='du -h'
alias dus='du -sh * 2>/dev/null | sort -h'              # размеры всех файлов в папке


# ┌──────────────────────────────────────────────────────────────────────┐
# │ 11. macOS-специфика                                                  │
# └──────────────────────────────────────────────────────────────────────┘
alias showfiles='defaults write com.apple.finder AppleShowAllFiles -bool true && killall Finder'
alias hidefiles='defaults write com.apple.finder AppleShowAllFiles -bool false && killall Finder'
alias flushdns='sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder && echo "✓ DNS-кэш сброшен"'
alias emptytrash='rm -rfv ~/.Trash/*'                   # очистить корзину
alias sleepnow='pmset sleepnow'                         # усыпить мак
alias awake='caffeinate -d'                             # не давать маку засыпать
alias spot-on='sudo mdutil -a -i on'                    # включить Spotlight
alias spot-off='sudo mdutil -a -i off'                  # выключить (экономит CPU)


# ┌──────────────────────────────────────────────────────────────────────┐
# │ 12. Современные замены классических утилит                           │
# │    Работают только если установлено через brew. Если нет -           │
# │    падают молча на системные команды.                                │
# └──────────────────────────────────────────────────────────────────────┘

# eza - замена ls с цветами и иконками
if command -v eza &>/dev/null; then
  alias ls='eza --icons --group-directories-first'
  alias ll='eza -lh --icons --git --group-directories-first'
  alias la='eza -lah --icons --git --group-directories-first'
  alias lt='eza --tree --level=2 --icons'
fi

# bat - cat с подсветкой синтаксиса
if command -v bat &>/dev/null; then
  alias cat='bat --paging=never'
  alias less='bat'
  export BAT_THEME="OneHalfDark"
fi

# zoxide - умный cd, запоминает папки с весом
# "cd proj" найдёт ~/Projects/my-project из истории посещений
if command -v zoxide &>/dev/null; then
  eval "$(zoxide init --cmd cd zsh)"
fi

# fzf - fuzzy-поиск (Ctrl+R история, Ctrl+T файлы, Alt+C папки)
[[ -f ~/.fzf.zsh ]] && source ~/.fzf.zsh


# ┌──────────────────────────────────────────────────────────────────────┐
# │ 13. Функции                                                          │
# └──────────────────────────────────────────────────────────────────────┘

# mkcd - создать папку и сразу в неё перейти
mkcd() { mkdir -p "$1" && cd "$1"; }

# bak - бэкап файла с меткой времени
bak() { cp "$1" "$1.bak.$(date +%Y%m%d_%H%M%S)" && echo "✓ создан $1.bak.$(date +%Y%m%d_%H%M%S)"; }

# ff - найти файл по подстроке имени в текущей папке и подпапках
ff() { find . -type f -iname "*$1*" 2>/dev/null; }

# fdir - найти папку
fdir() { find . -type d -iname "*$1*" 2>/dev/null; }

# weather2 - погода для произвольного города
weather2() { curl -s "wttr.in/${1:-Moscow}?lang=ru&M"; }

# manp - открыть man-страницу в Preview.app красиво (PDF)
manp() { man -t "$@" | open -f -a Preview; }

# server - запустить простой HTTP-сервер в текущей папке (для теста html)
server() { python3 -m http.server "${1:-8000}"; }

# psg - найти процесс по имени (вместо ps aux | grep)
psg() { ps aux | grep -i "$1" | grep -v grep; }

# gencpw [длина] - сгенерировать случайный пароль (по умолчанию 24 символа)
gencpw() { openssl rand -base64 "${1:-24}" | tr -d '/+=' | head -c "${1:-24}"; echo; }

# make-exec - сделать файл исполняемым
make-exec() { chmod +x "$1" && echo "✓ $1 теперь исполняемый"; }


# ┌──────────────────────────────────────────────────────────────────────┐
# │ 14. Помощь и обучение                                                │
# └──────────────────────────────────────────────────────────────────────┘

# Установка всех полезных утилит командой: setup-cli-tools
alias setup-cli-tools='brew install tldr htop ncdu tree jq wget rsync ripgrep fd eza bat zoxide fzf && echo "✓ Все утилиты установлены"'

# helpme <команда> - умная справка: пробует tldr → --help → man
# Пример: helpme tar
helpme() {
  if [[ -z "$1" ]]; then
    echo "Использование: helpme <команда>"
    echo "Пример: helpme tar"
    return 1
  fi
  if command -v tldr &>/dev/null; then
    tldr "$1" 2>/dev/null && return 0
  fi
  "$1" --help 2>/dev/null || man "$1"
}

# safe-curl <URL> - безопасно скачать скрипт, показать его, спросить запускать ли
# Пример: safe-curl https://example.com/install.sh
safe-curl() {
  if [[ -z "$1" ]]; then
    echo "Использование: safe-curl <URL>"
    return 1
  fi
  local tmp=$(mktemp)
  echo "→ Скачиваю $1 ..."
  if ! curl -fsSL "$1" -o "$tmp"; then
    echo "✗ Скачать не удалось"
    rm -f "$tmp"
    return 1
  fi
  echo "─── Содержимое (q - выйти из просмотра): ───"
  ${PAGER:-less} "$tmp"
  echo ""
  echo -n "Запустить через bash? [y/N] "
  read -r answer
  if [[ "$answer" == "y" || "$answer" == "Y" ]]; then
    bash "$tmp"
  else
    echo "Отменено. Скрипт сохранён: $tmp"
  fi
}

# make-ssh-key - сгенерировать SSH-ключ ed25519, положить публичную часть в буфер
# Используется для GitHub, серверов
make-ssh-key() {
  if [[ -f ~/.ssh/id_ed25519 ]]; then
    echo "⚠ Ключ ~/.ssh/id_ed25519 уже существует."
    echo -n "Перезаписать? Старый будет потерян! [y/N] "
    read -r answer
    [[ "$answer" != "y" && "$answer" != "Y" ]] && { echo "Отменено."; return 1; }
  fi
  echo -n "Email для ключа: "
  read -r email
  [[ -z "$email" ]] && { echo "✗ Email пустой, отмена"; return 1; }
  ssh-keygen -t ed25519 -C "$email" -f ~/.ssh/id_ed25519 || return 1
  pbcopy < ~/.ssh/id_ed25519.pub
  echo ""
  echo "✓ Публичный ключ скопирован в буфер обмена"
  echo "  GitHub:  Settings → SSH and GPG keys → New SSH key → вставить"
  echo "  Сервер:  ssh-copy-id user@host"
  echo "  Проверка GitHub: ssh -T git@github.com"
}

# cheat <тема> - встроенные шпаргалки. Без аргумента - список тем.
# Темы: basic, pipes, chmod, vim, nano, keys, emergency, net, git
cheat() {
  case "${1:-}" in
    basic)
      cat <<'CHEAT_EOF'
═══ 25 БАЗОВЫХ КОМАНД ═══

  pwd              где я сейчас
  cd <путь>        перейти в папку
  ls -lah          что в папке (подробно, со скрытыми)
  cat <файл>       показать файл
  less <файл>      пролистать длинный файл (q - выход)
  head -n / tail -n  первые / последние строки
  tail -f          живой просмотр (для логов)
  grep "X" file    поиск текста в файле
  find . -name X   поиск файлов по имени
  cp / mv / rm     копировать / переместить / удалить
  mkdir -p a/b/c   создать вложенные папки
  touch <файл>     создать пустой / обновить дату
  chmod +x file    сделать исполняемым
  ln -s tgt link   символическая ссылка
  echo $HOME       напечатать значение
  which git        где лежит команда
  man ls           руководство (q - выход)
  history          история команд
  ps aux           список процессов
  kill -9 PID      завершить процесс
  top              live-мониторинг (q - выход)
  df -h / du -h    диск / размеры
  curl -O URL      скачать файл
  ssh user@host    подключиться к серверу
  tar -czf out.tgz folder/   создать архив
  diff a b         сравнить файлы
CHEAT_EOF
      ;;
    pipes)
      cat <<'CHEAT_EOF'
═══ PIPES И ПЕРЕНАПРАВЛЕНИЕ ═══

  cmd > file        stdout в файл (перезаписать)
  cmd >> file       stdout в файл (дописать)
  cmd 2> err.log    stderr в файл
  cmd &> all.log    stdout И stderr в один файл
  cmd < file        stdin из файла
  cmd1 | cmd2       stdout cmd1 → stdin cmd2

ПРИМЕРЫ ЦЕПОЧЕК:

  ls -laS ~/Downloads | head -10        10 самых больших файлов
  ps aux | grep -i chrome | wc -l       сколько процессов Chrome
  du -sh ~/* | sort -h | tail -5        топ-5 жирных папок
  cat log | grep ERROR | sort -u        уникальные ошибки в логе
  history | grep brew | tail -20        последние 20 brew-команд
  find . -name "*.png" | wc -l          сколько png в дереве
CHEAT_EOF
      ;;
    chmod)
      cat <<'CHEAT_EOF'
═══ ПРАВА ДОСТУПА (chmod) ═══

  chmod +x file       сделать исполняемым
  chmod 755 file      rwxr-xr-x (стандарт для скриптов)
  chmod 644 file      rw-r--r-- (стандарт для документов)
  chmod 600 file      rw------- (только владелец, для ssh-ключей)
  chmod -R u+w folder рекурсивно дать запись владельцу
  ls -l               посмотреть текущие права

ЦИФРОВАЯ ЗАПИСЬ:
  4 = read (r)   2 = write (w)   1 = execute (x)
  Три цифры = владелец / группа / остальные

  Алиас: make-exec <file>   быстрый chmod +x
CHEAT_EOF
      ;;
    vim)
      cat <<'CHEAT_EOF'
═══ VIM - ВЫЖИТЬ И ВЫЙТИ ═══

  i              режим вставки текста (печатаешь как обычно)
  ESC            выйти из режима вставки

  :w             сохранить
  :q             выйти
  :wq            сохранить и выйти
  :q!            выйти БЕЗ сохранения (запомни как мантру)

  /текст         поиск (n - следующее, N - предыдущее)
  dd             удалить строку
  u              undo
  Ctrl+R         redo
  yy / p         скопировать строку / вставить
  gg / G         в начало / в конец файла
  :%s/old/new/g  заменить во всём файле
CHEAT_EOF
      ;;
    nano)
      cat <<'CHEAT_EOF'
═══ NANO ═══

  Ctrl+O          сохранить
  Ctrl+X          выйти
  Ctrl+W          найти
  Ctrl+\          найти и заменить
  Ctrl+K          вырезать строку
  Ctrl+U          вставить
  Ctrl+_          перейти на номер строки
  Alt+/           в конец файла
  Alt+\           в начало файла
CHEAT_EOF
      ;;
    keys)
      cat <<'CHEAT_EOF'
═══ ГОРЯЧИЕ КЛАВИШИ В ШЕЛЛЕ ═══

РЕДАКТИРОВАНИЕ КОМАНДЫ:
  Ctrl+A / Ctrl+E   в начало / в конец строки
  Ctrl+W            удалить слово влево
  Ctrl+U            удалить всё до начала строки
  Ctrl+K            удалить до конца
  Ctrl+L            очистить экран

ИСТОРИЯ:
  Ctrl+R            поиск по истории (с fzf - магия)
  Ctrl+P / ↑        предыдущая команда
  Ctrl+N / ↓        следующая команда
  !!                подставить предыдущую команду
  sudo !!           запустить предыдущую через sudo
  !$                последний аргумент предыдущей команды
  Alt+.             вставить последний аргумент
  ^old^new          предыдущая команда, заменив old на new

ZSH-СПЕЦИФИКА (этот конфиг):
  →                 принять подсказку autosuggestions
  ESC ESC           подставить sudo в начало команды
  Ctrl+O            копировать текущую команду в буфер
  Tab               автокомплит (без учёта регистра)
CHEAT_EOF
      ;;
    emergency)
      cat <<'CHEAT_EOF'
═══ ЭКСТРЕННЫЕ СИТУАЦИИ ═══

КОМАНДА ЗАВИСЛА:
  Ctrl+C          прервать (SIGINT)
  Ctrl+Z          приостановить (fg вернёт обратно)
  Ctrl+D          послать EOF (часто = выйти)
  Ctrl+\          SIGQUIT - сильнее Ctrl+C

ТЕРМИНАЛ ПОЛОМАЛСЯ:
  reset           полный сброс терминала
  clear           очистить экран
  Ctrl+L          то же что clear

ЗАСТРЯЛ В VIM:
  ESC : q ! Enter

ПОРТ ЗАНЯТ:
  lsof -i :8080     кто слушает порт
  kill -9 <PID>     убить процесс

ПАМЯТЬ КОНЧАЕТСЯ:
  top -o MEM        что жрёт память
  htop              то же красиво (brew install htop)

ДИСК ЗАБИЛСЯ:
  df -h             свободное место
  ncdu ~            интерактивный анализ (brew install ncdu)
  dus               алиас: размеры в текущей папке

КОМАНДА НЕ НАХОДИТСЯ:
  which <cmd>       где должна быть
  type <cmd>        алиас / функция / команда
  echo $PATH        список путей поиска
CHEAT_EOF
      ;;
    net)
      cat <<'CHEAT_EOF'
═══ СЕТЬ ═══

  ping example.com           пинг
  curl -I https://site.ru    HTTP-заголовки
  curl -O URL                скачать файл с тем же именем
  curl -o name URL           скачать с другим именем
  wget URL                   альтернатива curl
  myip                       алиас: внешний IP
  localip                    алиас: IP в локалке
  myssid                     алиас: имя текущего Wi-Fi
  ports                      алиас: кто слушает порты
  flushdns                   алиас: сброс DNS-кэша
  ssh user@host              подключение к серверу
  scp file user@host:/path   копирование на сервер
  rsync -avz src/ user@host:dst/   умное копирование с докачкой
  safe-curl URL              скачать скрипт + показать + спросить
CHEAT_EOF
      ;;
    git)
      cat <<'CHEAT_EOF'
═══ GIT (через OMZ-плагин) ═══

  gst              git status
  gco <branch>     git checkout
  gcb <branch>     git checkout -b (создать и переключиться)
  ga <file>        git add
  gaa              git add --all
  gcmsg "msg"      git commit -m "msg"
  gp / gpl         git push / git pull
  glog             git log с графом
  gd / gds         git diff / git diff --staged
  gpsup            git push --set-upstream origin <текущая>
  grb / grbi       git rebase / interactive
  gsta / gstp      git stash / stash pop
  gba              git branch --all

  Полный список:  alias | grep "^g"
CHEAT_EOF
      ;;
    *)
      cat <<'CHEAT_EOF'
Доступные шпаргалки (cheat <тема>):

  cheat basic       25 базовых команд
  cheat pipes       перенаправления и pipes
  cheat chmod       права доступа
  cheat vim         vim - выжить и выйти
  cheat nano        горячие клавиши nano
  cheat keys        клавиши в шелле
  cheat emergency   экстренные ситуации
  cheat net         сетевые команды
  cheat git         git-алиасы из OMZ

Полезные функции (см. ~/.zshrc):
  helpme <cmd>      tldr / --help / man по команде
  safe-curl <URL>   скачать скрипт + посмотреть + спросить
  make-ssh-key      сгенерировать SSH-ключ ed25519
  make-exec <file>  chmod +x
  psg <pattern>     найти процесс
  gencpw [N]        сгенерировать пароль
  mkcd <dir>        mkdir + cd
  bak <file>        бэкап с меткой времени
  ff / fdir <X>     найти файл / папку
  server [port]     HTTP-сервер в текущей папке

Установить весь рекомендуемый софт:
  setup-cli-tools
CHEAT_EOF
      ;;
  esac
}


# ┌──────────────────────────────────────────────────────────────────────┐
# │ 15. Горячие клавиши - шпаргалка                                      │
# │                                                                      │
# │   →            принять подсказку zsh-autosuggestions                 │
# │   Tab          автокомплит (без учёта регистра)                      │
# │   Ctrl+R       поиск по истории через fzf                            │
# │   Ctrl+T       вставить путь к файлу через fzf                       │
# │   Alt+C        перейти в папку через fzf                             │
# │   ESC ESC      подставить sudo в начало команды                      │
# │   Ctrl+L       очистить экран                                        │
# │   Ctrl+A       в начало строки                                       │
# │   Ctrl+E       в конец строки                                        │
# │   Ctrl+W       удалить слово влево                                   │
# │   Ctrl+U       удалить всё до начала строки                          │
# │   Ctrl+O       копировать текущую набранную команду в буфер          │
# │                                                                      │
# └──────────────────────────────────────────────────────────────────────┘


# ┌──────────────────────────────────────────────────────────────────────┐
# │ 16. Мини-гайд при старте                                             │
# └──────────────────────────────────────────────────────────────────────┘
cat <<'STARTUP_GUIDE'

  ┌─ ПОМОЩЬ ─────────────────────────────────────────────────────────┐
  │  cheat              список встроенных шпаргалок                  │
  │  cheat basic        25 базовых команд                            │
  │  cheat keys         горячие клавиши шелла                        │
  │  cheat emergency    что делать если зависло / поломалось         │
  │  cheat git          git-алиасы                                   │
  │  helpme <cmd>       умная справка по команде (tldr → man)        │
  │                                                                  │
  ├─ УТИЛИТЫ ────────────────────────────────────────────────────────┤
  │  safe-curl <URL>    скачать скрипт + посмотреть + спросить       │
  │  make-ssh-key       сгенерировать SSH-ключ для GitHub            │
  │  gencpw [N]         сгенерировать пароль                         │
  │  mkcd <dir>         создать папку и зайти в неё                  │
  │  bak <file>         бэкап файла с меткой времени                 │
  │  ff / fdir <X>      найти файл / папку по имени                  │
  │  psg <name>         найти процесс                                │
  │                                                                  │
  ├─ КОНФИГ ─────────────────────────────────────────────────────────┤
  │  zshrc              открыть ~/.zshrc для редактирования          │
  │  reload             применить изменения в конфиге                │
  │  setup-cli-tools    установить весь рекомендуемый софт           │
  └──────────────────────────────────────────────────────────────────┘

STARTUP_GUIDE