git-helpers

A set of helper scripts for the Git command line designed to automate repetitive tasks and keep your repository clean.

🚀 Installation & Setup

To ensure portability across different machines and operating systems without hardcoding paths, this repository includes a setup script that registers the installation directory as an environment variable (GIT_HELPERS).

1. Clone and Install

Clone the repository and run the installation script. This will add the GIT_HELPERS variable to your shell profile (.bashrc, .zshrc, etc.).

git clone https://github.com/bernardbr/git-helpers.git
cd git-helpers
chmod +x install-env.sh
./install-env.sh

2. Reload Shell

After running the script, reload your terminal configuration to apply the changes:

source ~/.bashrc
# OR
source ~/.zshrc

---

⚙️ Configuration

Once the GIT_HELPERS variable is set, you can configure your global .gitconfig using the variable. This approach works on Linux, macOS, and WSL.

Option A: Edit .gitconfig directly (Recommended)

Open your global config (git config --global -e) and paste the following block:

[alias]
    # Deletes local branches that are gone on the remote
    delete-stale-branches = !bash "$GIT_HELPERS"/delete-stale-branches.sh
    
    # Renames current branch locally and on remote
    rename = !bash "$GIT_HELPERS"/rename-branch.sh
    
    # Shows the latest tag
    last-tag = !bash "$GIT_HELPERS"/show-last-tag.sh
    
    # Deletes local tags that are gone on the remote
    delete-stale-tags = !bash "$GIT_HELPERS"/delete-stale-tags.sh

Option B: Via Command Line

Alternatively, you can run these commands one by one:

git config --global alias.delete-stale-branches '!bash "$GIT_HELPERS"/delete-stale-branches.sh'
git config --global alias.rename '!bash "$GIT_HELPERS"/rename-branch.sh'
git config --global alias.last-tag '!bash "$GIT_HELPERS"/show-last-tag.sh'
git config --global alias.delete-stale-tags '!bash "$GIT_HELPERS"/delete-stale-tags.sh'

---

🛠️ Scripts Description

Delete Stale Branches

Checks for all local branches that no longer exist on the server (remote) and deletes them.

• Usage: git delete-stale-branches

Rename Branch

Renames both the local and remote branches while maintaining tracking.

• Usage: git rename <new-branch-name>

Show Last Tag

Displays the latest tag created in the current tree.

• Usage: git last-tag

Delete Stale Tags

Syncs your local tags with the remote, removing tags locally that were deleted on the server.

• Usage: git delete-stale-tags

---

Made with ❤️ by Bernardo