Git Commander

A spaceship-themed terminal game that teaches Git commands through an interactive adventure.

    ╔══════════════════════════════════════════════════════════════════════════════════════╗
    ║      ██████╗ ██╗████████╗                                                            ║
    ║     ██╔════╝ ██║╚══██╔══╝                                                            ║
    ║     ██║  ███╗██║   ██║                                                               ║
    ║     ╚██████╔╝██║   ██║                                                               ║
    ║      ╚═════╝ ╚═╝   ╚═╝                                                               ║
    ║      ██████╗ ██████╗ ███╗   ███╗███╗   ███╗ █████╗ ███╗   ██╗██████╗ ███████╗██████╗ ║
    ║     ██╔════╝██╔═══██╗████╗ ████║████╗ ████║██╔══██╗████╗  ██║██╔══██╗██╔════╝██╔══██╗║
    ║     ██║     ██║   ██║██╔████╔██║██╔████╔██║███████║██╔██╗ ██║██║  ██║█████╗  ██████╔╝║
    ║     ╚██████╗╚██████╔╝██║ ╚═╝ ██║██║ ╚═╝ ██║██║  ██║██║ ╚████║██████╔╝███████╗██║  ██║║
    ║      ╚═════╝ ╚═════╝ ╚═╝     ╚═╝╚═╝     ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═════╝ ╚══════╝╚═╝  ╚═╝║
    ╚══════════════════════════════════════════════════════════════════════════════════════╝

Overview

You are the Captain of the USS Repository, a starship powered by GitCore technology. After a cosmic storm damages your ship, you must learn Git commands to restore systems and save your crew.

Features

• 8 progressive chapters teaching Git from basics to advanced concepts
• Ship status system - your actions affect hull integrity, power, and crew morale
• Safe sandbox - all Git operations run in a temporary directory
• Interactive terminal UI with color-coded feedback

Git Commands Taught

Chapter	Commands
1. The Awakening	git init
2. The Ship's Log	git status, git add, git commit
3. Identity Crisis	git config, git log
4. Parallel Universes	git branch, git checkout
5. Convergence	git merge
6. Time Paradox	git diff, git checkout -- <file>
7. Emergency Cache	git stash, git stash pop
8. The Final Commit	All commands combined

Requirements

• Python 3.6+
• Git 2.20+
• Terminal with ANSI color support

Installation

git clone https://github.com/yourusername/git-commander.git
cd git-commander

Usage

python3 git_commander.py

In-Game Commands

• Type Git commands as instructed (e.g., git init, git status)
• help - Show hints for the current mission
• status - Display ship status
• quit - Exit the game

Running Tests

python3 -m pytest test_git_commander.py -v

License

MIT License - see LICENSE for details.

Contributing

Contributions welcome! Please feel free to submit a Pull Request.