1
0
mirror of synced 2025-12-31 06:02:42 -05:00
Files
docs/content/github-cli/github-cli/quickstart.md
2023-02-15 15:16:18 +00:00

2.3 KiB

title, intro, versions, topics, type, allowTitleToDifferFromFilename, shortTitle
title intro versions topics type allowTitleToDifferFromFilename shortTitle
GitHub CLI quickstart Start using {% data variables.product.prodname_cli %} to work with {% data variables.product.company_short %} in the command line.
fpt ghes ghae ghec
* * * *
CLI
overview true Quickstart

About {% data variables.product.prodname_cli %}

{% data reusables.cli.about-cli %}

Getting started

  1. Install {% data variables.product.prodname_cli %} on macOS, Windows, or Linux.
  2. In the command line, authenticate to {% data variables.product.company_short %}.{% ifversion not fpt or ghec %} Replace HOSTNAME with the name of {% data variables.location.product_location %}. For example, octo-inc.ghe.com.{% endif %}

{% ifversion fpt or ghec %}

gh auth login

{% else %}

gh auth login --hostname HOSTNAME

{% endif %}

  1. Start working with {% data variables.product.company_short %} in the command line. For example, find an issue to work on with gh issue status or gh issue list --assignee @me. Create a pull request with gh pr create. Review a pull request with gh pr checkout, gh pr diff and gh pr review.

Next steps

  • Tell {% data variables.product.prodname_cli %} which text editor to use for commands that open a text editor. For example, enter gh config set editor "code -w" to set your preferred text editor to {% data variables.product.prodname_vscode %}. For more information, see gh config set.

  • Define aliases for commands that you commonly run. For example, if you run gh alias set prd "pr create --draft", you will then be able to run gh prd to quickly open a draft pull request. For more information, see gh alias.

  • Create or add custom commands with {% data variables.product.prodname_cli %} extensions. For more information, see "AUTOTITLE" and "AUTOTITLE."

  • For more information about all of the commands that you can run with {% data variables.product.prodname_cli %}, see "AUTOTITLE."