Git-Mastery App

Windows

Download the Git installer from the official Git website.
Run the installer and make sure to select the option to install Git Bash when prompted.

Screenshots given below provide some guidance on the dialogs you might encounter when installing Git. In other cases, go with the default option.

---

When running Git commands, we recommend Windows users to use the Git Bash terminal that comes with Git. To open Git Bash terminal, hit the key and type git-bash.

It may be possible that the installation didn't add a shortcut to the Start Menu. You can navigate to the directory where git-bash.exe is (most likely C:\Program Files\Git\git-bash.exe), double click git-bash.exe to open Git Bash.
You can also right-click it and choose Pin to Start or Pin to taskbar.

SIDEBAR: Git Bash Terminal

Git Bash is a terminal application that lets you use Git from the command line on Windows. Since Git was originally developed for Unix-like systems (like Linux and macOS), Windows does not come with a native shell that supports all the commands and utilities commonly used with Git.

Git Bash provides a Unix-like command-line environment on Windows. It includes:

• A Bash shell (Bash stands for Bourne Again SHell), which is a widely used command-line interpreter on Linux and macOS.
• Common Unix tools and commands (like ls, cat, ssh, etc.) that are useful when working with Git and scripting.

When copy-pasting text onto a Git Bash terminal, you will not be able to use the familiar Ctrl+V key combo to paste. Instead, right-click on the terminal and use the Paste menu option.

On Windows, you might need to close and open the terminal again for it to recognise changes done elsewhere in the computer (e.g., newly-installed software, changes to system variables, etc.).

---

MacOS

Install homebrew if you don't already have it, and then, run brew install git

---

Linux

Use your Linux distribution's package manager to install Git. Examples:

• Debian/Ubuntu, run sudo apt-get update and then sudo apt-get install git.

• Fedora: run sudo dnf update and then sudo dnf install git.

---

Verify Git is installed, by running the following command in a terminal.

git --version

    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

git version 2._._

    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

To set the two config settings, run the following commands in your terminal window:

git config --global user.name "<your-name>"
git config --global user.email "<your-email@example.com>"

    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

To check if they are set as intended, you can use the following two commands:

git config --global user.name
git config --global user.email

    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

Optionally, you can install a Git GUI client. e.g., Sourcetree (installation instructions).

Our Git lessons show how to perform Git operations in Git CLI, and in Sourcetree -- the latter just to illustrate how Git GUIs work. It is perfectly fine for you to learn the CLI only.

_{[image credit: https://www.sourcetreeapp.com]}

1. Install the Git-Mastery App

brew tap git-mastery/gitmastery
brew install gitmastery

    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

echo "deb [trusted=yes] https://git-mastery.github.io/gitmastery-apt-repo any main" | \
  sudo tee /etc/apt/sources.list.d/gitmastery.list > /dev/null
sudo apt install software-properties-common
sudo add-apt-repository "deb https://git-mastery.github.io/gitmastery-apt-repo any main"
sudo apt update
sudo apt-get install gitmastery

    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

yay -S gitmastery-bin

    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

install -D -m 0755 gitmastery-3.3.0-linux-arm64 /usr/bin/gitmastery

    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

2. To verify the installation, run the gitmastery --help command from a couple of different folder locations. An example given below (IMPORTANT: change the cd command to match your folders):

gitmastery --help
cd ../my-projects  # cd into a different folder
gitmastery --help

    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

3. Trigger the initial setup by running the gitmastery setup command in a suitable folder (the app will create files/folders inside this folder).

mkdir gitmastery-home
cd gitmastery-home
gitmastery setup

    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

The gitmastery setup command will perform the following tasks:

• a)
  Checks if Git is installed.
• b)
  Checks if user.name and user.email are set.
• c)
  Prompts you to specify a name for the git-mastery exercises directory

  • Recommended: accept the default (i.e., gitmastery-exercises) by pressing Enter.
  • If you choose to specify a different name for that folder, remember to use that name instead whenever our instructions refer to the gitmastery-exercises folder.
• d)
  Sets up a mechanism to locally track the progress of your exercises.

Notes:

• If the command failed due to checks (a) or (b) failing, you can rectify the problem and run the command again.
• If you wish to check the Git set up again at a later time, you can run the gitmastery check git command.

Git-Mastery App: Commands

Updating the Git-Mastery App

As the Git-Mastery app is under active development, it is likely to get updated frequently. When you run a gitmastery <command>, the output will warn you if there is a new version, in which case you should update the app immediately, by following the instructions in that message.

brew update
brew upgrade gitmastery

    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

sudo apt-get install --only-upgrade gitmastery


    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

sudo pacman -S gitmastery-bin


    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

Create a personal GitHub account as described in GitHub Docs → Creating an account on GitHub, if you don't have one yet.

[Optional, but recommended] Set up your GitHub profile, as explained in GitHub Docs → Setting up your profile.

Set up your computer's GitHub authentication, as described in the se-edu guide Setting up GitHub Authentication.

If you prefer not to include your real email address in commits, you can do the following:

1. Find your no-reply email provided by GitHub: Navigate to the email settings of your GitHub account and select the option to Keep my email address private. The no-reply address will then be displayed, typically in the format ID+USERNAME@users.noreply.github.com.
   

2. Update your user.email with that email address e.g.,

   git config --global user.email "12345678+username@users.noreply.github.com"
   
       
   
       Copy
       
   
       
   
   
       
       
       
       
   
       Wrap Text
       
   
       
   
   
       
       
       

brew install gh

    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

2. Authenticate yourself to GitHub account:

gh auth login

    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

When prompted, choose the protocol (i.e., HTTPS or SSH) you used previously to set up your GitHub authentication.

3. Give GitHub CLI permission to delete repos in your account, as this is required for some of the Git-Mastery exercises.

gh auth refresh -s delete_repo

    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

4. Verify the setup by checking the status of your GitHub CLI with your GitHub account.

gh auth status

    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

You should see confirmation that you’re logged in.

5. Verify that Github and GitHub CLI is set up for Git-Mastery:

gitmastery check github

    

    Copy
    

    


    
    
    
    

    Wrap Text
    

    


    
    
    

6. [Optional, Recommended] Ask Git-Mastery to switch on the 'progress sync' feature.

# cd into the gitmastery-exercises folder first
gitmastery progress sync on

    

    Copy
    

    


    
    
    
    

    Wrap Text