GSK - Git Script Kit

⚠️ This is the official repository of the Git Script Kit project.
Beware of unofficial copies or modified versions that may contain unsafe files.

📌 Overview

The GSK (Git Script Kit) is a Shell Script framework for Git, Software Configuration Management (SCM), and DevOps, designed to automate processes, simplify operations, and strengthen software development lifecycle governance.

It provides a unified CLI that standardizes branching workflows through GSK Flow, encapsulates complex Git operations (such as merge, rebase, and cherry-pick), supports advanced features (Git LFS and submodules), integrates natively with the Azure DevOps API, and enables CI/CD pipeline automation in Jenkins and Azure DevOps.

It is built on a modular architecture based on the Single Responsibility Principle (SRP), featuring reusable internal scripts that reduce code duplication and simplify maintenance. Each command includes parameter validation, a structured help system, and execution logging designed for auditing and troubleshooting. It is compatible with Windows, WSL, and Linux, with full support for Bash and Zsh.

📊 By the Numbers

| GSK Commands | 300+ | | Internal Scripts | 100+ | | In Active Development | 15+ years |

❓ Why This Project Exists

GSK was created to address real challenges in large-scale development environments, where Git usage varies significantly among teams and operational mistakes can lead to rework, broken pipelines, and inconsistencies.

Before GSK, common issues included:

• Branching inconsistencies.
• Dangerous or repetitive manual Git operations.
• Merge conflicts caused by improper workflows.
• Lack of uniformity between Windows, WSL, and Linux users.
• No integration between Git actions and Azure DevOps.
• Recurring human errors affecting SCM and DevOps processes.

GSK has evolved continuously since 2011 and remains an essential tool for efficient and consistent delivery.

🔑 Additional Features

• Auto-complete (gsk <tab><tab> or gsk <command> <tab><tab>)
• Alias creation (gsk alias_add --help)
• Windows context-menu integration (commit, diff, log, pull, stash and stash_apply)
• TortoiseGit integration (blame, commit, diff, log, and resolve)

📁 Project Structure

gsk/
├── dev/          # Git wrappers and commands executed directly by users
├── system/       # Scripts, functions and constants used across all other scripts
├── functions/    # functions/ # Internal reusable functions
├── manager/      # GSK management scripts
├── scm/          # Scripts executed directly by SCM users
├── personal/     # Custom scripts (not overwritten on updates)
├── drafts/       # Scripts under testing or validation, not ready for production
├── deprecated/   # Legacy scripts kept for compatibility
└── .context/     # AI agent context

manager/ and scm/ are accessible only by the [scm] profile.

⚠ To ensure update compatibility, custom scripts must be created exclusively in the personal/ folder. Manual changes to native GSK scripts are not supported and will be automatically discarded during the update process.

👤 Author

Alex Ferreira de Almeida
Software Engineer

🔒 Disclaimer

This repository contains public documentation only.
The actual source code of the GSK is private and cannot be published due to internal processes, proprietary integrations, and corporate security policies.

This README exists solely to document the project’s existence, architecture, design principles, and authorship.

📝 License

This project is licensed under the MIT License.

You are free to use, modify, and distribute this project for personal or commercial purposes, provided that the original authorship and license notice are preserved.

📅 Project Status

Active - 2011 to Present