How to create a new Github repository using the terminal

20 June 2020Gary Woodfine5 min read

In Learn The Basics Of Version Control To Become A Master we discussed the basic principles, use cases and terms regarding version control. You have more than likely now realized that all software projects will require some form of version control. Even if you are the only developer that will be working on the project, it makes absolute sense to create a version control repository.

Version control systems not only help you in keeping track of changes and overcoming errors whilst coding, but they also help you to keep your code safe and helping ensure you never lose or delete your code.

GitHub is a code hosting platform for collaboration and version control, which not only enables you and others work together on projects, but it also enables you to safely store your code online, so you don't have to worry about servers and managing them. Despite Github being a for profit company they provide free access to developers to host and share code with over 50 millions other developers world-wide

Github front page screenshot

Registering an account with Github enables developers to create Public and Private remote repositories to store their code and access to a whole host of other really useful tools and services.

Github supplies a really easy to use Web Interface and developers can use it to carry out all actions and processes they would typically need just using a browser based interface. For instance, Creating and updating repositories, reviewing code, creating Pull requests and so forth.

The web based interface works great, however as developers are more than likely to going to prefer working with Terminal Window, because for most developers this is how they will primarily work with git. Especially when first starting out and learning the basics.

Github also provides a really rich set of Application Programming Interface (API) methods enabling developers to build tools to engage and interact with Github. Developers could use these API's to either build their own custom tools or just choose to interact with Github making use of these tools.

Create Github repository using the API

It is fairly easy, but unfortunately a verbose method to create a Github repository using the API using the terminal window. All that is required is using a library like CuRL - A command-line tool for transferring data using various network protocols and reading understanding and remembering the API structure.

In order to use the Github API's you will be required to create a Creating a personal access token for the command line

Once you're registered your Personal Access Token, you can use the following command to create your repository.

curl -H 'Authorization: token some_token-id' https://api.github.com/user/repos  -d '{"name":"somerepositoryname"}'

This is quite a lot to remember, and if you're anything like me you're going to forget this almost immediately. Fortunately, Github realise most developers have goldfish memories and have spent time developing an easier to use command line tool to help developers called Hub.

What is Github hub ?

hub is a command line tool that wraps git in order to extend it with extra features and commands that make working with GitHub easier.

hub is an extension to command-line git that helps you do everyday GitHub tasks without ever leaving the terminal.

How to install Hub

platform manager command to run
macOS, Linux Homebrew brew install hub
Windows Scoop scoop install hub
Windows Chocolatey choco install hub
Fedora Linux DNF sudo dnf install hub
Debian apt(8) sudo apt install hub
Ubuntu Snap sudo snap install hub --classic

After you have installed hub, I always prefer to ensure that I have I have my ssh keys installed and that I configure my SSH keys for GitHub Access then I ensure that I configure hub to authenticate and execute commands using ssh.

git config --global hub.protocol ssh

if you want to read the hub help files you can use the following commands

hub help hub

hub help files

It is worth taking a little time and having a read through the help files to get acquainted with some of the terms and commands that are available.

How to create Github repository using terminal commands

We now go ahead and create our repository and add our files then we create our repository on Github.

In this example we will create a very simple repository with one file.

# create a directory and name it geekiam
mkdir geekiam

# change into the directory
cd geekiam

# create a directory and name it version-control-tutorial
mkdir version-control-tutorial

# change into the version-control-tutorial
cd version-control-tutorial

# Initialise the git repository
git init

# then we will create another folder
mkdir create-remote-repo

# change into the new directory
cd create-remote-repo

# We will create a new file name it README.MD
touch README.md

# now we will edit the file and add whatever content we need
nano README.md

After you have added whatever data you want to the README.md file simply save and exit the file using ctrl + x

we can now add the files to our respository and commit them

# add the files to the repository
git add .

# commit the changes to our local repository
git commit -m "This is the first commit"

We can now use hub to create out remote repository. The default action hub will perform if you don't supply and organisation name, it will create a new repository with the name of the root folder you're adding under your username on Github. However, in my case I want to create the repository under the Gee-I-Am organisation so I will supply the organisation name and the repository name I want to use.

# create the remote repository
hub create Geek-I-Am/version-control-tutorial

# you will be notified of the success of the creation.
# We can now push our changes to the remote repository

git push -u origin master

Conclusion

Making use of the hub hub makes it easy to clone or create repositories, browse project pages, list known issues, ensure your local branches stay up to date, and share logs or code snippets via Gist, all while using the terminal.

Subscribe to our newsletter

The latest news, articles, and resources, sent to your inbox weekly.

© 2020 threenine.co.uk, Inc. All rights reserved.