Aliases

CLI で読みやすい pack reference を create/resolve/list/delete します。

Alias は pack reference を安定して読みやすくするためのものです。Prompt、runbook、script、CI job の中で raw pack ID を直接扱うと読みにくくなる場合に使います。

Alias は pack だけを指します。Track は UUID、または UUID を含む URL で参照します。

Create or update an alias

epismo alias upsert @repo-onboarding --type context --id <pack-id>
epismo alias upsert @release-review --type workflow --id <pack-id>

type は target pack type と一致させます。workflow または context です。既存 alias name を再利用すると、その alias は新しい pack ID を指すように更新されます。

Alias name は先頭の @ を取り除いて保存されます。CLI では自分の alias に対して repo-onboarding と @repo-onboarding のどちらも受け付けます。

Alias name は normalization 後に 1〜255 文字である必要があります。/、owner prefix、control characters は使えません。

epismo alias get @repo-onboarding
epismo alias get @handle/repo-onboarding

自分の alias は @alias、他 handle が所有する alias は @handle/alias で読みます。

epismo alias list
epismo alias list --type workflow
epismo alias list --type context

現在の personal/workspace context で利用できる readable name を探すときに list を使います。

epismo alias delete @repo-onboarding

Alias を削除しても pack は削除されません。Pack を削除すると、その pack を指す自分の aliases は削除されます。