Top 10 Tips for using GitHub from the Command Line

Kedasha - Oct 13 '23 - - Dev Community

The GitHub CLI (gh cli) is a command line tool that allows you to interact with GitHub without ever leaving your terminal. It's an open source tool that allows you to view and manage issues, pull requests, releases, and more. In this post, we'll cover 10 tips for using the GitHub CLI, but first, how do you install it?

Installing the GitHub CLI 🛠️

I'm using MacOS, so I'll be using Homebrew to install the GitHub CLI. If you're using Windows or Linux, you can find instructions for installing the GitHub CLI here.



brew install gh
Enter fullscreen mode Exit fullscreen mode

Once you've installed the GitHub CLI, you'll need to authenticate with GitHub. You can do this by running the following command:



gh auth login
Enter fullscreen mode Exit fullscreen mode

This will open a browser window and prompt you to login to GitHub. Once you've logged in, you'll be prompted to authenticate with GitHub. Once you've authenticated, you'll be able to use the GitHub CLI. 🎉

CLI Syntax and Usage 📝

The CLI follows a very specific syntax. It generally works as, "gh" "feature" "then what you want to do with the feature" then “any flags associated with the feature” - everything you want to do with the cli takes on this format.

For example, if you wanted to clone a repository using the gh cli, it would be gh repo clone <repo to be cloned>

Let's take a look at some practical tips when using the GitHub CLI.

1. Create a new repository and clone it locally 🎉

You can create a new repository using the gh repo create command. This command will prompt you for the name of the repository, the description, and the visibility. You can also specify the name of the repository as an argument to the command.

You can also create a new repository and clone it locally at the same time by using the --clone flag. Here's what this will look like:



gh repo create your-new-repo --public --clone
Enter fullscreen mode Exit fullscreen mode

gh repo create command

The repo was created here and all you need to do now is to push your changes and you're good.

2. Create issues 📝

We can create issues for this repository right from the command line with the gh cli. This command will prompt you for the title and body of the issue. You can also specify the title and body as arguments to the command.



gh issue create -t "issue title" -b "issue body content" -a "assignee"
Enter fullscreen mode Exit fullscreen mode

You can also edit, transfer, delete, close, and reopen issues with the gh cli. You can find more information about this here.

gh repo issue create

3. Create pull requests 🔄

We can create pull requests by using the gh pr create command and follow the on-screen prompts. You can also specify the title and body as arguments to the command.



gh pr create -t "pull request title" -b "pull request body content" -a "assignee"
Enter fullscreen mode Exit fullscreen mode

gh repo pr create

4. Review pull requests 👀

Run gh pr create and add the necessary flags: -t for the title, -b for the body -a for the assignee and -d to mark the pr as draft. You can also use gh pr create and follow the on screen prompts to create a new PR with the cli.
Once the PR is created, take note of the PR num and run gh pr view <num> to see the details of the pr in your terminal.

gh pr review

5. View action workflows 👀

We can view the action workflows right from the command line with the gh cli. This command will list all the recent action workflows for the repository.



gh run list
Enter fullscreen mode Exit fullscreen mode

gh run list

You can also run workflows right from your terminal with the command gh workflow run <workflow name>. This command will run the workflow and prompt you for any required inputs.



gh workflow run <workflow filename>
Enter fullscreen mode Exit fullscreen mode

6. Open your current Repo in the browser 💻

You can open your current repository in the browser right from your terminal. This command will take you to the homepage of your repository.



gh browse
Enter fullscreen mode Exit fullscreen mode

If you you attach the -b option, you can open the current branch in the browser, like so:



gh browse -b "branch name"
Enter fullscreen mode Exit fullscreen mode

7. Create and update Project Boards 📋

Creating a project from your terminal with the command line requires you to have project scope permissions. To update your auth token with project scope permissions, run the following command and follow the on screen prompts:



gh auth refresh -s project,read:project
Enter fullscreen mode Exit fullscreen mode

Once that's confirmed, you can create a project board with the command gh project create and follow the on screen prompts.



gh project create --owner "owner" --title "title"
Enter fullscreen mode Exit fullscreen mode

8. Create edit, and view Releases 🚀

You can create a release with the command gh release create and follow the on screen prompts.



gh release create --title "title" --notes "notes"
Enter fullscreen mode Exit fullscreen mode

You can also edit, dowload assets and delete relases with the gh cli. You can find more information about this here.

9. Start and Stop Codespaces 💻

A Codespace is an online development environment. You can start a codespace with the command gh codespace create and follow the on screen prompts. You can also do it by specifying certain flags, for example, the branch you want to use:



gh codespace create -b "branch"
Enter fullscreen mode Exit fullscreen mode

gh codespace create

You can then open up the codespace in VSCode or Jupyter Notebooks with the command gh codespace code [flags] or gh codespace jupyter [flags], respectively, where the flags can include the version of vscode, repo, repo owner and name of the codespace you want to open.

10. Browse and create gh cli extensions 📦

You can run gh extension browse in your terminal to view a list of all available cli extensions to make your terminal experience even better. You can also install ann extension directly from the browsing interface.

gh extension browse command

To install an extension you like, run gh extension install <repository> [flags] and follow the on screen prompts.
You can also create your own cli extensions with the command gh ext create and follow the on screen prompts.

Getting Help with the gh cli ❓

If you're ever unsure of what to do with the GitHub CLI or how to use it, you can always run gh --help and it will give you a list of all the commands, help topics, extensions, flags and examples you can run with the GitHub CLI.

gh --help command

GitHub Copilot for CLI 🤖

Ever forget a command and have to search for it over and over again? Yea, me too. This is why we built GitHub Copilot for CLI. It provides a chat-like interface in your terminal to help you find commands for GitHub CLI, shell commands and git.

I'll be showing you how to use GitHub Copilot for CLI and how amazing it is at taking your command line skills to the next level. Join me at GitHub Universe next month to see it in action.

github universe copilot for cli talk

And if you can't make it in person, virtual passes are free and open to everyone. Register here.

If you have any questions about the gh cli, feel free to post them below and I'll do my best to answer them. 😄

Image
UPVC Door Panel Replacement Cat Flap
Image
trick menang dengan mesin slots online dengan gampang
Image
The Most Common Spare Car Key Cut Debate Could Be As Black Or White As You May Think
Image
How Real-Time Editing Works: Understanding Event Ordering in Distributed Systems

distributedsystems, softwareengineering, techtalks, systemdesign
Image
Duckdb — O novo banco de dados dos Big Data

duckdb, postgres, docker, database
Image
It's The Next Big Thing In Mental Health Assessment Near Me
Image
TCP vs UDP protocol

webdev, javascript, beginners, devops
Image
Mental Health Assessment: The Ugly Facts About Mental Health Assessment
Image
Base security mechanism, Developer tools and potential use cases
Image
20 Quotes That Will Help You Understand Mental Health Services
Image
A Deep Dive into YARP and Ocelot
Image
GitHub Spark: Create Apps with Ease and No Code

ai, githubspark, github, gpt3
Image
Integrating Obsidian with n8n for Automated Note-Taking Workflows

medium, repost
Image
The Reasons Why Keys Lost For Car Is The Main Focus Of Everyone's Attention In 2023
Image
mengapa slots online bisa dipercaya punyai link alternative?
Image
Berapa Gampang Jadi Bandar Judi Online Itu?
Image
An Bi Fold Door Repair Near Me Success Story You'll Never Be Able To
Image
7 Secrets About Asbestos Litigation Online That No One Will Tell You
Image
15 Things You Didn't Know About Accident Lawyer Near Me
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .