When you launch GitHub for Mac for the first time, you'll be greeted with a setup window.

GitHub for Mac intro screen

  1. Click "Continue" to connect to GitHub and enter your GitHub Enterprise credentials, and click "Sign in". If you have 2 factor authentication enabled on your account (and we'd suggest that you do!) – you'll be prompted to enter your authorisation code. Once you're signed in, click “Continue” to move onto the next step.

  2. GitHub for Mac autofills your Git configuration from your GitHub Enterprise name and email address. Make sure that these are correct so that Git can correctly attribute all of your commits and then click "Continue".

  3. Select any local repositories on your machine to add to the GitHub for Mac app. Don't worry if you don't already have any local repositories – you can clone or create them later!

    What exactly is a repository?

    A repository, or "repo", is simply a directory which contains your project work, as well as a few files (hidden by default on Mac OS X) which are used to communicate with Git.

    Repositories can exist either locally on your computer or as a remote copy online. You can then use GitHub for Mac to sync between these two copies.

    Tip: GitHub for Mac lets you perform the following tasks with repositories:

    • Search for pre-existing local repositories on your machine
    • Clone remote repositories from GitHub.com to make a syncable, local copy on your machine
    • Send a local repository to GitHub.com so that you can sync between the two
    • Create new repositories which can either be kept local-only, or copied and synced with GitHub.com

    Celebrate

    Congratulations! Now that GitHub for Mac is setup you'll just need to grab some repositories.