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.

Namespaces

Every alias lives in one of two namespaces:

• personal — your own account. This is the default.
• workspace — the active workspace's shared account. A workspace alias is a single shared record: any workspace member can resolve it, but only the target pack's owner can repoint or remove it. This lets a teammate's pack be called almost like your own.

When you create or delete an alias, pick the namespace with --namespace personal|workspace (default personal).

Reference forms

A bare @alias (or alias without the @) resolves in your personal namespace first, then falls back to the active workspace — so when both exist with the same name, your personal alias wins. To target a specific namespace, pass --namespace personal|workspace (CLI) or namespace (API/MCP).

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.
• Only the pack's owner may create, repoint, or delete an alias to it — in either namespace. Everyone else simply resolves it. To bookmark someone else's pack for yourself, use like.
• The @handle/alias form references another account's alias and is read-only — you cannot create or delete with it. To choose a namespace, pass --namespace / namespace.
• Updating an alias repoints it to another pack.
• Deleting a pack removes aliases you own that point to that pack.