Scroll to navigation

GH-ALIAS-IMPORT(1) GitHub CLI manual GH-ALIAS-IMPORT(1)

NAME

gh-alias-import - Import aliases from a YAML file

SYNOPSIS

gh alias import [<filename> | -] [flags]

DESCRIPTION

Import aliases from the contents of a YAML file.

Aliases should be defined as a map in YAML, where the keys represent aliases and the values represent the corresponding expansions. An example file should look like the following:

bugs: issue list --label=bug
igrep: '!gh issue list --label="$1" | grep "$2"'
features: |-

issue list
--label=enhancement

Use - to read aliases (in YAML format) from standard input.

The output from gh alias list can be used to produce a YAML file containing your aliases, which you can use to import them from one machine to another. Run gh help alias list to learn more.

OPTIONS

Overwrite existing aliases of the same name

EXAMPLE

# Import aliases from a file
$ gh alias import aliases.yml
# Import aliases from standard input
$ gh alias import -

SEE ALSO

gh-alias(1)

Jul 2024 GitHub CLI v2.52.0