Create a new GitHub Repository from the command line

It can be frustrating when you are working on a project on your local machine and need to commit some changes to GitHub, but you haven't set up that repository.

The GitHub CLI can help in this situation, from your terminal you can create that repository and commit your project without leaving your terminal or Integrated development environment (IDE). If you haven't got the GitHub CLI installed, do check out my blog post that covers the best ways to do that.

Convert a directory to a Git repository

So, you've been working on a project on your local machine for the last few hours and you want to commit that project to a GitHub repository. The first step is to convert the directory to a Git repository. The command to use is:

git init

Stage the files

The next step would be to stage the files so they can be committed to your GitHub repository:

git add .

Commit the files

Now commit the files:

git commit -m "initial commit"

Authorise GitHub CLI

If you have never used the GitHub CLI tool before, you need to authorise it with your GitHub account. If you type in the following command it will walk you through allowing your terminal to make changes to your GitHub account.

gh auth login

Create your GitHub repository

Your directory is Git ready and your terminal is authorised to make changes to your GitHub account. The next step is to create that GitHub repository and push your files into that repository. The command you want to use is gh repo create. This command has a lot of switches you can use for different reasons.

The command below will create a repository in GitHub called "My-NewRepo". It will be a public repository. The directory you are in will be source for that GitHub repository and the push the files in the directory to it.

gh repo create my-newrepo --public --source=. --remote=upstream --push

Your directory is now Git initiated, you have a GitHub repository to store your project and the files are stored there. 😊
Enjoy this new found joy of being able to create GitHub repositories using the GitHub CLI tool!

Command Line icon by Icons8

Comments

[Andy Piper]

I'm always forgetting --remote=upstream ... I should create a shell alias!