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       bugs: issue list --label=bug
24       igrep: '!gh issue list --label="$1" | grep "$2"'
25       features: |-
26           issue list
27           --label=enhancement
28
29
30
31       Use "-" to read aliases (in YAML format) from standard input.
32
33
34       The  output  from  the gh command "alias list" can be used to produce a
35       YAML file containing your aliases, which you can  use  to  import  them
36       from one machine to another. Run "gh help alias list" to learn more.
37
38
39

OPTIONS

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

EXAMPLE

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

SEE ALSO

58       gh-alias(1)
59
60
61
62                                   Nov 2023                 GH-ALIAS-IMPORT(1)