Aliases

Aliases are human-readable references to packs. Use them when prompts, docs, scripts, or CI jobs need a stable name instead of a raw pack UUID.

Forms

Form	Meaning
@repo-onboarding	Alias owned by the current user/account
@hiroki/repo-onboarding	Alias owned by another handle
repo-onboarding	Accepted when creating or deleting your own alias

Aliases point only to packs. Tracks do not have aliases.

Rules

• Alias names are stored without the leading @.
• Alias names cannot contain / or control characters.
• Owner-qualified aliases are for reading, not for creating.
• Updating an alias repoints it to another pack.
• Deleting a pack removes aliases you own that point to that pack.