Это продвинутая конфигурация Bash, разработанная для решения одной главной проблемы: как поддерживать идентичное, удобное и мощное окружение командной строки на всех удаленных машинах, с которыми вы работаете по SSH?

Эта система избавляет от необходимости вручную копировать .bashrc на каждый сервер и рисковать, затирая существующие настройки. Вместо этого она "на лету" создает ваше привычное окружение на любой машине, куда вы подключаетесь, и даже централизованно собирает историю команд со всех серверов.

• Полная синхронизация окружения: Ваши псевдонимы (aliases), функции и переменные окружения (exports) будут доступны на любом сервере, куда вы подключитесь через sshb.
• Централизованная "вечная" история: Все команды, выполненные на любом сервере, сохраняются в один локальный файл ~/.bash_eternal_history, с указанием пользователя, хоста и каталога.
• Умное и безопасное SSH-подключение (sshb): Главная "магическая" функция sshb использует мультиплексирование SSH для мгновенных повторных подключений и автоматически настраивает окружение, не оставляя мусора после себя.
• Интерактивное управление инфраструктурой: Управляйте Kubernetes, Docker, systemd и Terraform с помощью удобных fzf-меню, не покидая терминал.
• Продвинутая работа с Git: Переключайтесь между ветками и Pull Request'ами, просматривайте логи, управляйте stash и выполняйте cherry-pick в интерактивном режиме.
  • Модульная структура: Конфигурация разделена на 4 логических файла для легкой поддержки и расширения (.bashrc, .bash_export, .bash_functions, .bash_aliases).
• Встроенная справка: Команды ha и fa покажут вам список всех доступных псевдонимов и функций с описаниями.
  • Множество утилит: Включает десятки полезных псевдонимов и функций для работы с git, docker, файловой системой, сетью и многого другого.

Функция sshb — это сердце всей системы. Когда вы выполняете sshb user@server, происходит сложный, но надежный процесс:

1. Создание безопасной среды:

   • На вашей локальной машине создается временный, защищенный каталог с помощью mktemp -d. Это исключает уязвимости.
   • В этом каталоге создается управляющий сокет для SSH.

2. Установка "Мастер-соединения":

   • Выполняется команда ssh -fNM user@server. Она создает фоновое, постоянное SSH-соединение с сервером. Все последующие коммуникации будут проходить через него мгновенно, без повторной аутентификации.

3. Упаковка окружения:

   • sshb локально собирает содержимое всех ваших конфигурационных файлов (.bashrc, .bash_export, .bash_functions, .bash_aliases) в один "пакет".

4. Отправка и настройка на сервере:

   • Этот "пакет" по защищенному каналу отправляется на удаленный сервер и сохраняется во временный файл ~/.bash-ssh.
   • Если вы уже находитесь внутри сессии sshb и подключаетесь дальше, настраивается обратный туннель для пересылки истории команд на вашу локальную машину.

5. Запуск "магической" сессии:

   • Выполняется финальная команда: exec bash --rcfile ~/.bash-ssh -i.
   • exec bash ...: Запускается новый экземпляр bash.
   • --rcfile ~/.bash-ssh: Это ключевой флаг. Он принудительно заставляет bash использовать наш отправленный "пакет" в качестве единственного файла конфигурации, полностью игнорируя системный .bashrc на сервере.
   • -i: Запускает оболочку в интерактивном режиме.

6. Автоматическая очистка:

   • Как только вы выходите с сервера (командой exit), sshb автоматически закрывает фоновое "мастер-соединение".
   • Срабатывает механизм trap, который гарантированно удаляет временный каталог и управляющий сокет с вашей локальной машины, не оставляя следов.

Этот подход гарантирует, что ваше окружение будет полностью воссоздано на удаленной машине без изменения ее системных файлов.

Проект имеет простую и понятную модульную структуру:

• ~/.bashrc: Главный файл, точка входа. Он обрабатывает логику SSH-подключений и загружает остальные части конфигурации.
• ~/.bash_export: Здесь определяются все переменные окружения ($PATH, $EDITOR), настройки истории, локали и инициализация менеджеров версий.
• ~/.bash_functions: Коллекция полезных shell-функций, включая "магическую" функцию sshb и утилиты для работы с файлами, сетью и git.
• ~/.bash_aliases: Большая коллекция псевдонимов для ускорения повседневной работы в терминале.

1. Клонируйте репозиторий:

   git clone https://github.com/kootik/bash.git ~/.dotfiles

2. Создайте символические ссылки:

   ln -s ~/.dotfiles/.bashrc ~/.bashrc
   ln -s ~/.dotfiles/.bash_export ~/.bash_export
   ln -s ~/.dotfiles/.bash_functions ~/.bash_functions
   ln -s ~/.dotfiles/.bash_aliases ~/.bash_aliases

3. Установите зависимости: Убедитесь, что у вас установлены необходимые утилиты.

   # Для Debian/Ubuntu
   sudo apt-get update 
   sudo apt-get install socat fzf jq trash-cli xclip fd-find ripgrep bat
   
   # Для macOS (используя Homebrew)
   brew install socat fzf jq trash jq trash-cli xclip fd-find ripgrep bat
   
   # Для Fedora/CentOS  
   sudo dnf install fzf jq trash-cli ripgrep xclip

4. Перезапустите оболочку: Откройте новую вкладку терминала или выполните source ~/.bashrc.

Теперь вместо ssh используйте команду sshb для подключения к удаленным серверам.

• socat: (Опционально) Используется для создания надежного TCP-сервера для приема истории команд.
• fzf: (Обязательно) Мощный нечеткий поиск, основа всех интерактивных утилит.
• jq: (Рекомендуется) Используется для форматирования JSON-ответов.
• trash-cli (или trash на macOS): (Рекомендуется) Для безопасного перемещения файлов в корзину.
• ripgrep (rg): (Рекомендуется) Для сверхбыстрого поиска по коду (frg, ftodo).
• gh: (Рекомендуется) Для работы с GitHub Pull Requests (fpr).
• xclip: (Рекомендуется) Для интеграции с системным буфером обмена.

Этот проект распространяется под лицензией GNU General Public License v3.0. Это означает, что он является свободным программным обеспечением, и вы можете его изменять и распространять на тех же условиях.

Для быстрого просмотра всех доступных команд используйте:

• ha - показать все псевдонимы (aliases).

• fa - показать все функции.

  [Изображение справки по псевдонимам в терминале]

на фото часть функций и алиасов

Это новые мощные утилиты, которые превращают вашу командную строку в интерактивное меню.

Этот документ — детальный разбор псевдонимов, которые делают работу в командной строке быстрее, удобнее и безопаснее. Для каждой группы псевдонимов указана полная команда, назначение и наглядные примеры.

Этот документ — подробный разбор вспомогательных функций, которые автоматизируют рутинные задачи, не связанные напрямую с Git. Они помогут вам эффективнее управлять файлами, системой, сетью и рабочим окружением.

• Назначение: Быстрое создание резервной копии файла с добавлением текущей даты и времени в имя.

• Как это работает: Использует команду cp -iv, копируя указанный файл в новый с суффиксом .ГГГГ-ММ-ДД_ЧЧ:ММ:СС.

• Когда использовать: Пе� 103C7 �ед тем, как вносить рискованные изменения в важный файл (например, файл конфигурации).

• Пример использования:
  # Создать резервную копию nginx.conf перед редактированием
  bak /etc/nginx/nginx.conf

  # Будет создан файл: /etc/nginx/nginx.conf.2025-08-09_23-49-00

• Назначение: Создать каталог (включая все родительские) и немедленно перейти в него.
• Как это работает: Объединяет две команды: mkdir -p (создать путь) и cd (перейти в каталог).
• Когда использовать: Когда вы создаете новую структуру каталогов для проекта и хотите сразу начать в ней работать.
• Пример использования:
  # Создать структуру для нового веб-проекта и перейти в нее
  mkcd ~/projects/new-cool-app/src
  # Вы окажетесь в каталоге ~/projects/new-cool-app/src

• Назначение:

  • ff (Find File): Искать файлы по имени (или маске) в текущем каталоге и всех его подкаталогах.
  • fd (Find Directory): Искать каталоги по имени.

• Как это работает: Это удобные обертки над стандартной командой find.

• Когда использовать: Когда вы знаете имя файла/каталога, но не помните, где именно он лежит в большом проекте.

• Пример использования:
  # Найти все файлы с расширением .md в проекте
  ff "*.md"

  # Найти каталог с компонентами в проекте React
  fd "components"

• Назначение: Безопасное удаление файлов и каталогов путем перемещения их в системную корзину, а не безвозвратного стирания.
• Как это работает: Использует утилиту trash-cli. Если она не установлена, функция сообщит об этом.
• Когда использовать: Всегда, вместо rm, когда вы не уверены на 100%, что файл вам больше никогда не понадобится.
• Пример использования:
  # Переместить ненужный лог-файл в корзину
  trash old_log.txt

• Назначение: Универсальный распаковщик, который автоматически определяет тип архива и использует правильную команду для его извлечения.
• Как это работает: Конструкция case проверяет расширение файла и вызывает соответствующую команду (tar, unzip, unrar и т.д.).
• Когда использовать: Чтобы не вспоминать флаги для tar и не искать, какая команда нужна для .rar или .7z.
• Пример использования:
  # Распаковать несколько разных архивов одной командой
  extract project.zip backup.tar.gz documents.rar

• Назначение:

  • targz: Быстро создать архив .tar.gz.
  • zipf: Быстро создать .zip архив, автоматически исключая ненужные файлы (.git, .DS_Store).

• Как это работает: Обертки над командами tar и zip с предустановленными оптимальными флагами.

• Когда использовать: Когда нужно быстро заархивировать проект или каталог для отправки коллеге или для резервного копирования.

• Пример использования:
  # Заархивировать каталог проекта в my-app.tar.gz
  targz ./my-app

  # Создать zip-архив с исходниками, исключив git
  zipf ./my-app-sources

• Назначение: Выполнить DNS-запрос через защищенный сервис Google DNS-over-HTTPS и красиво отформатировать ответ.
• Как это работает: Отправляет запрос с помощью curl и форматирует полученный JSON с помощью jq.
• Когда использовать: Когда стандартный dig или nslookup заблокирован или вы хотите получить более подробную информацию в удобном виде.
• Пример использования:
  doh github.com

• Назначение: Показать краткий прогноз погоды для указанного города (или Москвы по умолчанию) прямо в терминале.
• Как это работает: Использует сервис wttr.in с помощью curl.
• Пример использования:
  # Погода в Монреале
  weather Montreal

• Назначение: Принудительно завершить все процессы, чье имя соответствует заданному шаблону.
• Как это работает: Безопасная обертка над pkill, которая находит и "убивает" процессы.
• Когда использовать: Когда программа зависла и нужно завершить все ее процессы.
• Пример использования:
  # Завершить все процессы, связанные с зависшим плеером VLC
  killg vlc

• Назначение: Проверить, открыт ли определенный TCP-порт на удаленном хосте.

• Как это работает: Использует утилиту nc (netcat) с коротким таймаутом для попытки соединения.

• Когда использовать: Для быстрой диагностики сетевых проблем. Например, чтобы проверить, доступен ли веб-сервер или база данных.

• Пример использования:
  # Проверить, работает ли веб-сервер на example.com
  checkport example.com 443

  # Проверить, доступен ли сервер PostgreSQL
  checkport db.internal.host 5432

• Назначение: Заблокировать экран компьютера.
• Как это работает: Интеллектуально определяет доступную в вашей системе команду для блокировки экрана (xdg-screensaver, loginctl и др.) и выполняет ее.
• Когда использовать: Когда вы отходите от компьютера и хотите быстро заблокировать сеанс.
• Пример использования:
  lock

• Назначение: Показать логи конкретного сервиса (unit) в systemd и следить за их обновлением в реальном времени.
• Как это работает: Вызывает journalctl -u [имя_юнита] -f.
• Когда использовать: Для отладки системных сервисов, таких как nginx, docker, sshd и т.д.
• Пример использования:
  # Смотреть логи веб-сервера nginx в реальном времени
  jnl-unit nginx.service

• Назначение: Выполнить быструю очистку системы Docker: удалить остановленные контейнеры, неиспользуемые образы, сети и кэш сборки.
• Как это работает: Выполняет docker container prune и docker system prune.
• Когда использовать: Регулярно, чтобы освободить место на диске, которое занимает Docker.
• Пример использования:
  dclean

• Назначение: Создать новое виртуальное окружение Python, сразу же активировать его и обновить pip.
• Как это работает: Объединяет три шага: python3 -m venv, source activate и pip install -U pip.
• Когда использовать: В самом начале работы над любым новым проектом на Python.
• Пример использования:
  # Создать и активировать окружение для нового проекта
  mkvenv my-django-project-env

• Назначение: Легко и быстро загрузить файл или каталог на сервис transfer.sh и получить ссылку для скачивания.

• Как это работает: Использует curl для загрузки файла. Если передается каталог, он сначала автоматически архивируется в .zip.

• Когда использовать: Когда нужно быстро поделиться файлом с кем-то, у кого нет доступа к вашему компьютеру. Ссылка действительна 14 дней.

• Пример использования:
  # Загрузить один файл
  transfer report.pdf

  # Загрузить целый каталог
  transfer ./screenshots

  # Загрузить вывод команды
  ls -l | transfer file-list.txt

• Назначение: Перейти вверх по иерархии каталогов на заданное количество уровней.
• Как это работает: Генерирует путь вида ../../.. и выполняет cd.
• Когда использовать: Удобнее, чем печатать cd ../../...
• Пример использования:
  # Находясь в /home/user/projects/app/src/components
  # Перейти на 3 уровня вверх в /home/user/projects
  up 3

• Назначение: Простой калькулятор в командной строке с поддержкой чисел с плавающей точкой.

• Как это работает: Передает математическое выражение утилите bc.

• Когда использовать: Для быстрых вычислений, не покидая терминал.

• Пример использования:
  calc "10 / 3"
  # Вывод: 3.3333333333

  calc "(15.5 * 4) + 2"
  # Вывод: 64

Этот документ — подробный разбор продвинутых функций для работы с Git. Они разделены на две категории: функции-комбо для автоматизации рутины и интерактивные функции на базе fzf для мощного поиска и управления.

Эти функции объединяют несколько стандартных команд Git для выполнения частых задач одной короткой командой.

Представьте, вы закончили работу над формой входа.

Вместо того, чтобы печатать:

git add --all
git commit -m "feat: реализована базовая форма входа"
git push

Вы просто печатаете:

gacp "feat: реализована базовая форма входа"

Вам нужно начать работу над задачей PROJ-123.

Вместо того, чтобы печатать:

git checkout -b feature/PROJ-123
git push --set-upstream origin feature/PROJ-123

Вы просто печатаете:

gnewbranch feature/PROJ-123

За неделю вы слили несколько веток. Чтобы очистить локальный репозиторий:

gprune

Вывод будет примерно таким:

Основная ветка: main. Удаление слитых веток...
Deleted branch feature/login (was a1b2c3d).
Deleted branch hotfix/typo (was e4f5g6h).
Очистка завершена.

Эти функции превращают командную строку в интерактивное меню с нечетким поиском. Требуют установленной утилиты fzf.

Выполните gfb, начните печатать часть названия ветки, выберите нужную стрелками и нажмите Enter.

Выполните gfl, найдите нужный коммит поиском и нажмите Ctrl-D, чтобы увидеть только изменения, которые он принес.

Выполните gfa, с помощью Tab выберите файлы для первого коммита и нажмите Enter. Они будут добавлены в индекс.

Выполните gfc, найдите коммит, где файл был в порядке, выберите его, а затем выберите сам файл. Он будет восстановлен в вашей рабочей директории.

Выполните gfd, выберите с помощью Tab несколько старых веток и нажмите Enter для их удаления.