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

Built-in aliases

Alias	Description
gbCfg	Change directory to ~/.config/git-bash and open editor setted in SF_EDITOR variable
gbCfgU	Update your local copies of git-bash-config and shell-fns. You will need to restart git-bash
new	Open a new window of git-bash in current directory. This alias is affected by SF_START_DEV_FOLDER variable of dev plugin from shell-fns.
srcBash	Source your ~/.bashrc file

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.

My other software configurations

• nvim-config
• wezterm-config