1GH-ALIAS-IMPORT(1)             GitHub CLI manual            GH-ALIAS-IMPORT(1)
2
3
4

NAME

6       gh-alias-import - Import aliases from a YAML file
7
8
9

SYNOPSIS

11       gh alias import [<filename> | -] [flags]
12
13
14

DESCRIPTION

16       Import aliases from the contents of a YAML file.
17
18
19       Aliases  should  be  defined as a map in YAML, where the keys represent
20       aliases and the values represent the corresponding expansions. An exam‐
21       ple file should look like the following:
22
23
24              bugs: issue list --label=bug
25              igrep: '!gh issue list --label="$1" | grep "$2"'
26              features: |-
27                  issue list
28                  --label=enhancement
29
30
31
32       Use "-" to read aliases (in YAML format) from standard input.
33
34
35       The  output  from  the gh command "alias list" can be used to produce a
36       YAML file containing your aliases, which you can  use  to  import  them
37       from one machine to another. Run "gh help alias list" to learn more.
38
39
40

OPTIONS

42       --clobber
43              Overwrite existing aliases of the same name
44
45
46

EXAMPLE

48              # Import aliases from a file
49              $ gh alias import aliases.yml
50
51              # Import aliases from standard input
52              $ gh alias import -
53
54
55
56
57

SEE ALSO

59       gh-alias(1)
60
61
62
63                                   Oct 2023                 GH-ALIAS-IMPORT(1)