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¶

--clobber

Overwrite existing aliases of the same name

EXIT CODES¶

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

EXAMPLE¶

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

SEE ALSO¶

gh-alias(1)