エイリアス

エイリアスはパックへの、人が読みやすい参照です。プロンプト、ドキュメント、スクリプト、CI ジョブの中で、生のパック UUID の代わりに安定した名前を使いたい場合に使います。

名前空間

すべてのエイリアスは2つの名前空間のどちらかに属します。

• 個人用 — 自分のアカウント。デフォルトです。
• ワークスペース — アクティブなワークスペースの共有アカウント。ワークスペースエイリアスは単一の共有レコードで、ワークスペースのメンバーは誰でも解決できますが、付け替え・削除できるのは対象パックの所有者だけです。これにより、チームメイトのパックを自分のもののように呼び出せます。

エイリアスを作成・削除するときは、--namespace personal|workspace(デフォルト personal)で名前空間を選びます。

参照の形式

@alias(先頭 @ は省略可)は、まず個人用、次にアクティブなワークスペースの順で解決されます。そのため、同名のエイリアスが両方にある場合は個人用が優先されます。特定の名前空間を指定したい場合は、--namespace personal|workspace(CLI)または namespace(API/MCP)を渡します。

エイリアスはパックだけを指します。トラックにエイリアスはありません。

ルール

• エイリアスの名前は先頭の @ を取り除いて保存されます。
• エイリアスの名前に / や制御文字は使えません。
• エイリアスを作成・付け替え・削除できるのは、対象パックの 所有者 だけです(どちらの名前空間でも)。それ以外のユーザーは解決するだけです。他人のパックを自分用にブックマークしたい場合は like を使います。
• @handle/alias の形式は別アカウントのエイリアスを参照する読み取り専用で、作成・削除には使えません。名前空間を選びたい場合は --namespace / namespace を渡します。
• エイリアスの更新は別パックへの付け替えです。
• パックを削除すると、そのパックを指す自分のエイリアスも削除されます。