Git Gud is a small command-line game that teaches basic Git concepts through a short text adventure. You are trapped in a corrupted repository and must use familiar Git commands to escape.
https://jerome-mondol.github.io/git-gud/
- Two-branch story flow (master -> basement)
- Guided hints and friendly error messages
- Colorized terminal output
- Short and replayable
- C++ compiler with C++11 support (g++, clang++, or MSVC)
- A terminal that supports ANSI colors
On Windows, the game enables ANSI support automatically. If you do not see colors, try Windows Terminal, PowerShell, or a modern terminal emulator.
Clone the repository:
git clone https://github.com/Jerome-Mondol/git-gud.git
Then change into the project folder:
cd git-gud
From this folder:
Using g++ (MinGW or MSYS2):
g++ git-gud.cpp -o git-gud
Using clang++:
clang++ git-gud.cpp -o git-gud
Using MSVC (Developer Command Prompt):
cl /EHsc git-gud.cpp
./git-gud
If you built with MSVC on Windows, run:
git-gud.exe
The simulator only accepts Git commands. Start by checking your status:
git status
Core commands used in the game:
- git status
- git add
- git commit -m "message"
- git checkout
- exit
- If a command is rejected, read the hint and try again.
- The game is short. You can restart any time by closing and re-running.
- Discover the first useful file.
- Save your progress with a commit.
- Switch to the next branch and finish the escape.
MIT