Create a repo

1. In the command line, navigate to the directory where you would like to create a local clone of your new project.

2. To create a repository for your project, use the gh repo create subcommand. Replace project-name with the desired name for your repository. If you want your project to belong to an organization instead of to your user account, specify the organization name and project name with organization-name/project-name.

   gh repo create project-name

3. Follow the interactive prompts. To clone the repository locally, confirm yes when asked if you would like to clone the remote project directory. Alternatively, you can specify arguments to skip these prompts. For more information about possible arguments, see the GitHub CLI manual.

Now that you have created a project, you can start committing changes.

README files are a great place to describe your project in more detail, or add some documentation such as how to install or use your project. The contents of your README file are automatically shown on the front page of your repository. Follow these steps to add a README file.

1. In the command line, navigate to the root directory of your new project. (This directory was created when you ran the gh repo create command.)

2. Create a README file with some information about the project.

   echo "info about this project" >> README.md

3. Enter git status. You will see that you have an untracked README.md file.

   $ git status
   
   Untracked files:
     (use "git add ..." to include in what will be committed)
     README.md
   
   nothing added to commit but untracked files present (use "git add" to track)

4. Stage and commit the file.

   git add README.md && git commit -m "Add README"

5. Push the changes to your branch.

   git push --set-upstream origin HEAD