PathPath
Cute octopus playing with building block toys

Learn the GitHub CLI Command Basics

Now that we have a functioning repository from the previous lesson, we’re ready to dive headfirst into the GitHub CLI’s commands. The best approach is to first familiarize ourselves with the command structure. At the core of the CLI, all commands follow a basic pattern.

gh <command> <subcommand> --flags

The primary alias for interacting with the GitHub CLI is gh. Executing gh alone will display a high-level overview of all available commands, as shown in the screenshot below.

Display of possible commands when using gh by itself

Scrolling down, there’s a useful guide that shows an overview on the command syntax:

LEARN MORE
  Use 'gh <command> <subcommand> --help' for more information about a command.
  Read the manual at https://cli.github.com/manual

Deconstructing a Command

Let’s deconstruct a straightforward command like gh pr view 123 --web. This command opens a specific pull request in the browser by passing in a value. The majority of commands are going to follow this type of syntax.

  • gh is the CLI’s alias.
  • pr is a top-level command within the CLI.
  • view is a subcommand under pr.
  • 123 represents a variable, in this case, pull request number 123.
  • --web is a flag that can be used with the view subcommand to open the item in the browser instead of displaying it in the terminal.

Learning About Commands

In upcoming lessons, we’ll explore how to craft more complex commands. Remember, two invaluable resources are at your disposal: the GitHub CLI manual, which offers the most current information, and the --help flag which is an excellent quick-reference for command details.

Micheal England

Article by Micheal England.

Looking for My Next Role


Seeking a skilled JS, Node, or React developer? Connect with me on LinkedIn. Let's discuss how I can contribute to your team's success!
Connect