README.md

git-bash-config

This repository hosts my configuration for git-bash that comes bundled with git-for-windows, so this configuration is only for Windows Systems.

Features

• Enable symlink
• Custom prompt themes via oh-my-posh
• Plugins, aliases and functions from shell-fns

Requirements

• shell-fns
• oh-my-posh with manual installation

Installation

Cloning

Clone this repository into your user-specific configurations folder: $HOME/.config:

git clone --depth 1 https://github.com/Hdoc1509/git-bash-config.git ~/.config/git-bash

Sourcing

• Source entry file in your ~/.bashrc file:

source ~/.config/git-bash/main.sh

NOTE: Custom themes have the suffix -mod.

• Be sure to source ~/.bashrc file from your ~/.bash_profile file:

source ~/.bashrc

• Then, open cmd and make a simlink for the ~/.minttyrc file:

mklink %userprofile%\.minttyrc %userprofile%\.config\git-bash\.minttyrc

Customization

All configurations must be placed in ~/.config/git-bash/main.sh file.

• For set an oh-my-posh theme you should use set_posh_theme or set_custom_theme functions:

# For oh-my-posh built-in themes
set_posh_theme tokyonight_storm

# For oh-my-posh custom themes
set_custom_theme blue-owl-mod

Note: Custom themes have the suffix -mod.

• Configurations for shell-fns must be at the end.

Update git-bash-config

• Run the following commands for update your local copies of git-bash-config and shell-fns:

git -C ~/.config/git-bash pull
git -C ~/.config/shell-fns pull

• Or run the following built-in alias:

gbCfgU

All updates will take effect after restarting git-bash.

My other software configurations

• nvim-config
• wezterm-config