.nh
.TH "GH-ALIAS-IMPORT" "1" "May 2024" "" "GitHub CLI manual"

.SH NAME
.PP
gh-alias-import - Import aliases from a YAML file


.SH SYNOPSIS
.PP
\fBgh alias import [<filename> | -] [flags]\fR


.SH DESCRIPTION
.PP
Import aliases from the contents of a YAML file.

.PP
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:

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

.PP
Use \fB-\fR to read aliases (in YAML format) from standard input.

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


.SH OPTIONS
.TP
\fB--clobber\fR
Overwrite existing aliases of the same name


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

# Import aliases from standard input
$ gh alias import -

.EE


.SH SEE ALSO
.PP
\fBgh-alias(1)\fR