Aliases

Aliases make pack references stable and readable. Use them in prompts, runbooks, scripts, and CI jobs when copying raw pack IDs would make the workflow harder to understand.

Aliases point only to packs. Tracks are referenced by UUID or URLs containing a UUID.

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 must match the target pack type: workflow or context. Reusing an existing alias name repoints it to the new pack ID.

Alias names are stored without the leading @. The CLI accepts repo-onboarding and @repo-onboarding for your own alias.

Alias names must be 1 to 255 characters after normalization. They cannot contain /, owner prefixes, or control characters.

Resolve an alias

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

Use @alias for your own alias. Use @handle/alias when reading an alias owned by another handle.

List aliases

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

List aliases when you need to discover the readable names available in the current personal or workspace context.

Delete an alias

epismo alias delete @repo-onboarding

Deleting an alias does not delete the pack. Deleting a pack removes aliases you own that point to that pack.

Common mistakes

• Do not include an owner prefix when creating your own alias.
• Do not use aliases for tracks.
• Do not rely on raw UUIDs in prompts when an alias can make the reference understandable.