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.

Every alias lives in a personal namespace (your own account, the default) or a workspace namespace (the active workspace's shared account). See Aliases for how the namespaces resolve.

Create or update an alias

epismo alias upsert @repo-onboarding --id $PACK_ID
epismo alias upsert @release-review --id $PACK_ID
epismo alias upsert @deploy --id $PACK_ID --namespace workspace

The pack type (workflow or context) is derived from the pack ID. Reusing an existing alias name repoints it to the new pack ID.

--namespace is personal (default) or workspace. The workspace form shares the name with the active workspace. You can alias only packs you own — the command verifies ownership before writing.

Alias names are stored without the leading @. The CLI accepts repo-onboarding and @repo-onboarding. Alias names must be 1 to 255 characters after normalization and cannot contain / or control characters.

Resolve an alias

epismo alias get @repo-onboarding                 # personal first, then workspace fallback
epismo alias get @deploy --namespace workspace    # pin to the workspace's alias
epismo alias get @handle/repo-onboarding          # another account's alias

The response includes id, type, accountId, alias, namespace (personal | workspace, when applicable), and reference — a ready-to-use @alias.

List aliases

epismo alias list
epismo alias list --type workflow

list returns your personal aliases plus, when a workspace is active, the workspace's shared aliases. Each entry is tagged with its namespace. --type is optional.

Delete an alias

epismo alias delete @repo-onboarding              # personal
epismo alias delete @deploy --namespace workspace     # the workspace's shared alias

--namespace selects the namespace (default personal). A workspace alias can be deleted only by the target pack's owner, so you cannot remove a teammate's shared alias. Deleting an alias does not delete the pack. Deleting a pack removes aliases you own that point to that pack.

Common mistakes

• The @handle/alias form references another account's alias and is read-only — create and delete act on your own or workspace aliases, selected with --namespace.
• Do not use aliases for tracks.
• Do not rely on raw UUIDs in prompts when an alias can make the reference understandable.