2022-07-10

GitHub CLI でエイリアスを設定する

はじめに

先週に引き続き GitHub CLI の Tips 紹介。以下の記事を見てそんなことができるのかと思ったので試してみた！

結論から言うと、GitHub CLI のサブコマンド gh alias で自由にエイリアスを作成／削除できるので、試してみた。

`gh alias` サブコマンドの使い方

Usage をチェックすると以下のようにな感じとなる。

$ gh alias --help
Aliases can be used to make shortcuts for gh commands or to compose multiple commands.

Run "gh help alias set" to learn more.

USAGE
  gh alias <command> [flags]

CORE COMMANDS
  delete:      Delete an alias
  list:        List your aliases
  set:         Create a shortcut for a gh command

INHERITED FLAGS
  --help   Show help for command

LEARN MORE
  Use 'gh <command> <subcommand> --help' for more information about a command.
  Read the manual at https://cli.github.com/manual

Usage を見ると一目瞭然ではあるが主に 3 つのことが可能。

list: エイリアスの一覧を確認
set : エイリアスの作成
delete : エイリアスの削除

エイリアスの設定方法

gh alias set で独自でエイリアスを設定できる。

例として、今回は「自分にアサインされている issue の一覧」を取得するコマンドにエイリアスを設定する。

何も設定しないと以下のコマンドで実現できる。

$ gh issue list --assignee @me

しかし、これを毎回打つとなると少し長いので、これに対して gh homework というエイリアスを設定してみたい。

$ gh alias set homework 'issue list --assignee @me'
- Adding alias for homework: issue list --assignee @me
✓ Added alias.

これでエイリアスの設定が完了した！

テストのため ega4432/dotfiles リポジトリに都合よく issue があるので、そちらのディレクトリに移動して実行してみる。

$ gh homework

Showing 2 of 2 issues in ega4432/dotfiles that match your search

#18  macOS settings    less than a minute ago
#8   Terminal          less than a minute ago

期待通りの結果を得られてそうなので、無事にエイリアスを設定できている。

まだ先人の知恵を参考にいじっている段階なのでオリジナルものは少ないが、僕が設定しているエイリアスの一覧を載せておく。

$ gh alias list
aliases:    alias list
co:         pr checkout
create-pr:  pr create --assignee @me --fill --web
gitignore:  api /gitignore/templates/$1 --jq .source
homework:   issue list --assignee @me
mypr:       pr list --state all --assignee @me
open:       repo view --web
s:          api -X GET /search/repositories -f q="$1" --template "{{range .items}}{{.full_name}} -...
unwatch:    api -X DELETE /repos/$1/subscription
watches:    api /users/ega4432/subscriptions --paginate --jq .[].full_name