gh-alias-import - Man Page

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

Example

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

# Import aliases from standard input
$ gh alias import -

See Also

gh-alias(1)

Referenced By

gh-alias(1).

Mar 2024 GitHub CLI manual