@get-dx/cli 0.2.0 → 0.3.0

package/README.md

@@ -18,31 +18,44 @@ Interactively login and install the AI agent skill:
 dx init
 ```
 
-The CLI uses `app.getdx.com` as the hostname and `api.getdx.com` as the api base url by default.
+Show help text:
+
+```shell
+dx --help
+dx <subcommand> --help
+```
+
+### Customizing base URLs
 
-### Dedicated or managed deployments
+The CLI requires two base URLs to be configured. The default values are used for DX **cloud** deployments. Users of **dedicated** and **managed** deployments will need to specify these values explicitly when logging in.
 
-If your organization is on a dedicated or managed DX deployment, pass your custom hostname at init time:
+| Value            | How it is used                               | Env var           | Default value           |
+| ---------------- | -------------------------------------------- | ----------------- | ----------------------- |
+| **Web base URL** | Browser-based login and displaying web links | `DX_WEB_BASE_URL` | `https://app.getdx.com` |
+| **API base URL** | Making each API request to DX                | `DX_API_BASE_URL` | `https://api.getdx.com` |
+
+#### For dedicated deployments
+
+Set the env vars once when initializing:
 
 ```shell
-# Flag (dedicated instance at mycompany.getdx.io)
-dx init --host mycompany.getdx.io
+# Interactive login
+DX_WEB_BASE_URL="https://mycompany.getdx.io" DX_API_BASE_URL="https://api.mycompany.getdx.io" dx init
 
-# Env var — useful for CI or scripted setups
-DX_HOST=mycompany.getdx.io dx init
+# Non-interactive login for CI or remote agents
+DX_WEB_BASE_URL="https://mycompany.getdx.io" DX_API_BASE_URL="https://api.mycompany.getdx.io" dx auth login --token $DX_TOKEN
 ```
 
-The `DX_HOST` and `--host` values accept:
+#### For managed deployments
 
-- `app.getdx.com` — DX Cloud (default)
-- `<account>.getdx.io` — DX dedicated (derives `https://api.<account>.getdx.io` automatically)
-- Any custom domain — you will be prompted for the separate API base URL
-
-Show help text:
+Set the env vars once when initializing:
 
 ```shell
-dx --help
-dx <subcommand> --help
+# Interactive login
+DX_WEB_BASE_URL="https://dx.some-example-subdomain.example.com" DX_API_BASE_URL="https://api.dx.some-example-subdomain.example.com" dx init
+
+# Non-interactive login for CI or remote agents
+DX_WEB_BASE_URL="https://dx.some-example-subdomain.example.com" DX_API_BASE_URL="https://api.dx.some-example-subdomain.example.com" dx auth login --token $DX_TOKEN
 ```
 
 ## Logging

package/dist/cli.js

@@ -5,10 +5,13 @@ import { initCommand } from "./commands/init.js";
 import { scorecardsCommand } from "./commands/scorecards.js";
 import { studioCommand } from "./commands/studio.js";
 import { teamsCommand } from "./commands/teams.js";
+import { workflowsCommand } from "./commands/workflows.js";
 import { handleError } from "./commandHelpers.js";
 import cliPackage from "../package.json" with { type: "json" };
+import { handleTemporaryBaseUrlMigration } from "./config.js";
 export async function run(argv = process.argv) {
     try {
+        handleTemporaryBaseUrlMigration(argv);
         const program = createProgram();
         if (argv.length <= 2) {
             program.outputHelp();
@@ -35,6 +38,7 @@ function createProgram() {
     program.addCommand(scorecardsCommand());
     program.addCommand(studioCommand());
     program.addCommand(teamsCommand());
+    program.addCommand(workflowsCommand());
     applyExitOverride(program);
     return program;
 }

package/dist/commands/auth.js

@@ -4,12 +4,11 @@ import { deleteToken, setToken } from "../secrets.js";
 import { renderJson } from "../renderers.js";
 import { renderAuthInfo, renderLoggedOut } from "./authRendering.js";
 import { getContext, wrapAction } from "../commandHelpers.js";
-import { persistBaseUrl, resolveBaseUrl, resolveUiUrl } from "../config.js";
+import { persistBaseUrls, resolveApiBaseUrl, deriveBaseUrlsFromEnv, } from "../config.js";
 import { CliError } from "../errors.js";
 import { request } from "../http.js";
 import { loginViaBrowser } from "../loginViaBrowser.js";
-import { buildLogger, buildRuntime } from "../runtime.js";
-import cliPackage from "../../package.json" with { type: "json" };
+import { buildRuntime } from "../runtime.js";
 import { maskToken } from "../ui.js";
 export function authCommand() {
     const auth = new Command()
@@ -20,7 +19,7 @@ export function authCommand() {
         .option("--token <token>", "Account web API token or personal access token. Omit this option to login interactively by web browser or pasting.")
         .action(wrapAction(async (commandOptions, command) => {
         const context = getContext(command);
-        const baseUrl = resolveBaseUrl();
+        const { apiBaseUrl, webBaseUrl } = deriveBaseUrlsFromEnv();
         let token = commandOptions.token;
         if (!token) {
             if (!process.stdin.isTTY || !process.stderr.isTTY) {
@@ -34,7 +33,7 @@ export function authCommand() {
                 ],
             });
             if (method === "browser") {
-                token = await loginViaBrowser(resolveUiUrl(baseUrl));
+                token = await loginViaBrowser(webBaseUrl);
             }
             else {
                 token = await password({
@@ -46,45 +45,51 @@ export function authCommand() {
                 throw new CliError("Account web API token or personal access token is required");
             }
         }
-        const runtime = {
-            baseUrl,
+        const runtime = buildRuntime(context, {
+            apiBaseUrl,
             token,
-            context,
-            version: cliPackage.version,
-            logger: buildLogger(context),
-        };
+            webBaseUrl,
+        });
         const response = await getAuthInfo(runtime);
-        persistBaseUrl(baseUrl);
-        setToken(baseUrl, token);
+        persistBaseUrls(apiBaseUrl, webBaseUrl);
+        setToken(apiBaseUrl, token);
         if (context.json) {
-            renderJson({ ...response, base_url: baseUrl });
+            renderJson({
+                ...response,
+                api_base_url: apiBaseUrl,
+                web_base_url: webBaseUrl,
+            });
             return;
         }
-        renderAuthInfo(response, token, baseUrl);
+        renderAuthInfo(response, token, apiBaseUrl);
     }));
     auth.command("logout").action(wrapAction(async (_options, command) => {
         const context = getContext(command);
-        const baseUrl = resolveBaseUrl();
-        deleteToken(baseUrl);
+        const apiBaseUrl = resolveApiBaseUrl();
+        deleteToken(apiBaseUrl);
         if (context.json) {
-            renderJson({ ok: true, base_url: baseUrl, logged_out: true });
+            renderJson({ ok: true, api_base_url: apiBaseUrl, logged_out: true });
         }
         else {
-            renderLoggedOut(baseUrl);
+            renderLoggedOut(apiBaseUrl);
         }
     }));
-    auth.command("status").action(wrapAction(async (_options, command) => {
+    auth
+        .command("status")
+        .alias("info")
+        .action(wrapAction(async (_options, command) => {
         const runtime = buildRuntime(getContext(command));
         const response = await getAuthInfo(runtime);
         if (runtime.context.json) {
             renderJson({
                 ...response,
                 token: maskToken(runtime.token),
-                base_url: runtime.baseUrl,
+                api_base_url: runtime.apiBaseUrl,
+                web_base_url: runtime.webBaseUrl,
             });
         }
         else {
-            renderAuthInfo(response, runtime.token, runtime.baseUrl);
+            renderAuthInfo(response, runtime.token, runtime.apiBaseUrl);
         }
     }));
     return auth;

package/dist/commands/catalog/entities.js

@@ -21,6 +21,7 @@ export function entitiesCommand() {
         .option("--owner-team-ids <ids>", "Comma-separated owner team IDs")
         .option("--owner-user-ids <ids>", "Comma-separated owner user IDs")
         .option("--property <kv>", "Set a property value as key=value. Repeat for multiple properties.", (val, prev) => [...prev, val], [])
+        .option("--alias <kv>", "Set an alias value as key=value. Repeat for multiple aliases.", (val, prev) => [...prev, val], [])
         .addHelpText("afterAll", createExampleText([
         {
             label: "Create a new service entity",
@@ -38,6 +39,10 @@ export function entitiesCommand() {
             label: "Create with properties",
             command: 'dx catalog entities create --type service --identifier my-service --property tier=Tier-1 --property "languages=Ruby,TypeScript"',
         },
+        {
+            label: "Create with aliases",
+            command: "dx catalog entities create --type service --identifier my-service --alias github_repo=12345",
+        },
     ]))
         .action(wrapAction(async (options, command) => {
         if (!options.identifier) {
@@ -47,7 +52,7 @@ export function entitiesCommand() {
             throw new CliError("--type is required", EXIT_CODES.ARGUMENT_ERROR);
         }
         const runtime = buildRuntime(getContext(command));
-        const properties = await resolvePropertiesForEntityType(runtime, options.type, options.property);
+        const resolvedValues = await resolveValuesForEntityType(runtime, options.type, options.property, options.alias);
         const response = await createEntity(runtime, options.identifier, {
             type: options.type,
             name: options.name,
@@ -58,13 +63,13 @@ export function entitiesCommand() {
             owner_user_ids: options.ownerUserIds
                 ?.split(",")
                 .map((s) => s.trim()),
-            properties,
+            ...resolvedValues,
         });
         if (runtime.context.json) {
             renderJson(response);
         }
         else {
-            renderEntity(response.entity);
+            renderEntity(response.entity, runtime);
         }
     }));
     entities
@@ -100,6 +105,7 @@ export function entitiesCommand() {
         .option("--owner-team-ids <ids>", "Comma-separated owner team IDs")
         .option("--owner-user-ids <ids>", "Comma-separated owner user IDs")
         .option("--property <kv>", "Set a property value as key=value. Repeat for multiple properties. Use value null to remove a property.", (val, prev) => [...prev, val], [])
+        .option("--alias <kv>", "Set an alias value as key=value. Repeat for multiple aliases. Use value null to remove an alias.", (val, prev) => [...prev, val], [])
         .addHelpText("afterAll", createExampleText([
         {
             label: "Rename an entity",
@@ -113,19 +119,23 @@ export function entitiesCommand() {
             label: "Update properties",
             command: 'dx catalog entities update my-service --property tier=Tier-1 --property "languages=Ruby,TypeScript"',
         },
+        {
+            label: "Update aliases",
+            command: "dx catalog entities update my-service --alias github_repo=12345",
+        },
     ]))
         .action(wrapAction(async (identifier, options, command) => {
         const runtime = buildRuntime(getContext(command));
-        const properties = await resolvePropertiesForExistingEntity(runtime, identifier, options.property);
+        const resolvedValues = await resolveValuesForExistingEntity(runtime, identifier, options.property, options.alias);
         const response = await updateEntity(runtime, identifier, {
             ...getEntityMutationOptionValues(options),
-            properties,
+            ...resolvedValues,
         });
         if (runtime.context.json) {
             renderJson(response);
         }
         else {
-            renderEntity(response.entity, `${ui.success(ui.GLYPHS.CHECK)} Entity updated`);
+            renderEntity(response.entity, runtime, `${ui.success(ui.GLYPHS.CHECK)} Entity updated`);
         }
     }));
     entities
@@ -138,6 +148,7 @@ export function entitiesCommand() {
         .option("--owner-team-ids <ids>", "Comma-separated owner team IDs")
         .option("--owner-user-ids <ids>", "Comma-separated owner user IDs")
         .option("--property <kv>", "Set a property value as key=value. Repeat for multiple properties. Use value null to remove a property.", (val, prev) => [...prev, val], [])
+        .option("--alias <kv>", "Set an alias value as key=value. Repeat for multiple aliases. Use value null to remove an alias.", (val, prev) => [...prev, val], [])
         .addHelpText("afterAll", createExampleText([
         {
             label: "Create a new service entity if it does not exist",
@@ -151,6 +162,10 @@ export function entitiesCommand() {
             label: "Set properties while preserving omitted fields",
             command: 'dx catalog entities upsert --type service --identifier my-service --property tier=Tier-1 --property "languages=Ruby,TypeScript"',
         },
+        {
+            label: "Set aliases while preserving omitted fields",
+            command: "dx catalog entities upsert --type service --identifier my-service --alias github_repo=12345",
+        },
     ]))
         .action(wrapAction(async (options, command) => {
         if (!options.type) {
@@ -160,11 +175,11 @@ export function entitiesCommand() {
             throw new CliError("--identifier is required", EXIT_CODES.ARGUMENT_ERROR);
         }
         const runtime = buildRuntime(getContext(command));
-        const properties = await resolvePropertiesForEntityType(runtime, options.type, options.property);
+        const resolvedValues = await resolveValuesForEntityType(runtime, options.type, options.property, options.alias);
         const response = await upsertEntity(runtime, options.identifier, {
             type: options.type,
             ...getEntityMutationOptionValues(options),
-            properties,
+            ...resolvedValues,
         });
         if (runtime.context.json) {
             renderJson(response);
@@ -173,7 +188,7 @@ export function entitiesCommand() {
             const title = response.result === "created_new_entity"
                 ? `${ui.success(ui.GLYPHS.CHECK)} Created new entity`
                 : `${ui.success(ui.GLYPHS.CHECK)} Updated existing entity`;
-            renderEntity(response.entity, title);
+            renderEntity(response.entity, runtime, title);
         }
     }));
     entities
@@ -202,7 +217,7 @@ export function entitiesCommand() {
             renderJson(processedResponse);
         }
         else {
-            renderEntity(processedResponse.entity);
+            renderEntity(processedResponse.entity, runtime);
         }
     }));
     entities
@@ -245,7 +260,7 @@ export function entitiesCommand() {
             renderJson({ ...response, entities: processedEntities });
         }
         else {
-            renderEntityList(processedEntities, response.response_metadata?.next_cursor ?? null);
+            renderEntityList(processedEntities, response.response_metadata?.next_cursor ?? null, runtime);
         }
     }));
     entities
@@ -311,7 +326,7 @@ export function entitiesCommand() {
             renderJson(response);
         }
         else {
-            renderEntityScorecardList(response.scorecards, response.response_metadata?.next_cursor ?? null);
+            renderEntityScorecardList(response.scorecards, identifier, runtime, response.response_metadata?.next_cursor ?? null);
         }
     }));
     return entities;
@@ -459,6 +474,33 @@ export function parsePropertyValue(prop, rawValue) {
             return rawValue;
     }
 }
+function parseEntityAliases(entityTypeIdentifier, rawAliases, knownAliases) {
+    const aliasKeys = Object.keys(knownAliases);
+    const aliasSet = new Set(aliasKeys);
+    const result = {};
+    for (const kv of rawAliases) {
+        const eqIndex = kv.indexOf("=");
+        if (eqIndex === -1) {
+            throw new CliError(`Invalid --alias "${kv}": expected format key=value`, EXIT_CODES.ARGUMENT_ERROR);
+        }
+        const key = kv.slice(0, eqIndex);
+        const rawValue = kv.slice(eqIndex + 1);
+        if (!aliasSet.has(key)) {
+            const availableAliases = aliasKeys
+                .sort()
+                .map((k) => `\`${k}\``)
+                .join(", ");
+            const availableAliasesText = availableAliases.length > 0 ? availableAliases : "(none)";
+            throw new CliError(`Unknown alias \`${key}\` for entity type \`${entityTypeIdentifier}\`. Available aliases: ${availableAliasesText}`, EXIT_CODES.ARGUMENT_ERROR);
+        }
+        if (rawValue === "null") {
+            result[key] = [];
+            continue;
+        }
+        result[key] = [...(result[key] ?? []), { identifier: rawValue }];
+    }
+    return result;
+}
 // --- Include helpers ---
 const ENTITY_INCLUDE_SECTIONS = [
     "core",
@@ -487,22 +529,31 @@ function parseIncludeSections(include) {
     }
     return results;
 }
-async function resolvePropertiesForEntityType(runtime, entityTypeIdentifier, rawProperties) {
-    if (rawProperties.length === 0) {
-        return undefined;
+async function resolveValuesForEntityType(runtime, entityTypeIdentifier, rawProperties, rawAliases) {
+    if (rawProperties.length === 0 && rawAliases.length === 0) {
+        return {};
     }
     let entityTypeResponse;
     try {
         entityTypeResponse = await getEntityType(runtime, entityTypeIdentifier);
     }
     catch (err) {
-        throw wrapEntityTypeLookupError(entityTypeIdentifier, err);
+        throw wrapEntityTypeLookupError(entityTypeIdentifier, err, rawAliases.length > 0
+            ? "resolve property and alias values"
+            : "resolve property types");
+    }
+    const values = {};
+    if (rawProperties.length > 0) {
+        values.properties = parseEntityProperties(entityTypeIdentifier, rawProperties, entityTypeResponse.entity_type.properties);
     }
-    return parseEntityProperties(entityTypeIdentifier, rawProperties, entityTypeResponse.entity_type.properties);
+    if (rawAliases.length > 0) {
+        values.aliases = parseEntityAliases(entityTypeIdentifier, rawAliases, entityTypeResponse.entity_type.aliases);
+    }
+    return values;
 }
-async function resolvePropertiesForExistingEntity(runtime, identifier, rawProperties) {
-    if (rawProperties.length === 0) {
-        return undefined;
+async function resolveValuesForExistingEntity(runtime, identifier, rawProperties, rawAliases) {
+    if (rawProperties.length === 0 && rawAliases.length === 0) {
+        return {};
     }
     let entityResponse;
     try {
@@ -512,9 +563,23 @@ async function resolvePropertiesForExistingEntity(runtime, identifier, rawProper
         const exitCode = err instanceof HttpError && err.status !== undefined && err.status < 500
             ? EXIT_CODES.ARGUMENT_ERROR
             : EXIT_CODES.RETRY_RECOMMENDED;
-        throw new CliError(`Failed to fetch entity "${identifier}" to resolve property types: ${err instanceof Error ? err.message : String(err)}`, exitCode);
+        throw new CliError(`Failed to fetch entity "${identifier}" to resolve property and alias values: ${err instanceof Error ? err.message : String(err)}`, exitCode);
+    }
+    let entityTypeResponse;
+    try {
+        entityTypeResponse = await getEntityType(runtime, entityResponse.entity.type);
+    }
+    catch (err) {
+        throw wrapEntityTypeLookupError(entityResponse.entity.type, err, "resolve property and alias values");
+    }
+    const values = {};
+    if (rawProperties.length > 0) {
+        values.properties = parseEntityProperties(entityResponse.entity.type, rawProperties, entityTypeResponse.entity_type.properties);
+    }
+    if (rawAliases.length > 0) {
+        values.aliases = parseEntityAliases(entityResponse.entity.type, rawAliases, entityTypeResponse.entity_type.aliases);
     }
-    return resolvePropertiesForEntityType(runtime, entityResponse.entity.type, rawProperties);
+    return values;
 }
 function getEntityMutationOptionValues(options) {
     return {
@@ -549,13 +614,15 @@ function buildEntityMutationBody(identifier, params) {
         body.owner_user_ids = params.owner_user_ids;
     if (params.properties !== undefined)
         body.properties = params.properties;
+    if (params.aliases !== undefined)
+        body.aliases = params.aliases;
     return body;
 }
-function wrapEntityTypeLookupError(entityTypeIdentifier, err) {
+function wrapEntityTypeLookupError(entityTypeIdentifier, err, purpose = "resolve property types") {
     const exitCode = err instanceof HttpError && err.status !== undefined && err.status < 500
         ? EXIT_CODES.ARGUMENT_ERROR
         : EXIT_CODES.RETRY_RECOMMENDED;
-    return new CliError(`Failed to fetch entity type "${entityTypeIdentifier}" to resolve property types: ${err instanceof Error ? err.message : String(err)}`, exitCode);
+    return new CliError(`Failed to fetch entity type "${entityTypeIdentifier}" to ${purpose}: ${err instanceof Error ? err.message : String(err)}`, exitCode);
 }
 function uniqueSectionsInOrder(sections) {
     const seen = new Set();

package/dist/commands/catalog/entitiesRendering.js

@@ -1,7 +1,7 @@
 import dayjs from "dayjs";
 import { renderRichText } from "../../renderers.js";
 import * as ui from "../../ui.js";
-export function renderEntityList(entities, nextCursor) {
+export function renderEntityList(entities, nextCursor, runtime) {
     const blocks = [ui.h1("Entities")];
     blocks.push(ui.p(`Displaying ${ui.bold(entities.length.toString())} entities.`));
     if (nextCursor) {
@@ -19,7 +19,7 @@ export function renderEntityList(entities, nextCursor) {
         }
         if (entity.identifier) {
             blocks.push(ui.h3("Core attributes"));
-            blocks.push(...coreContent(entity));
+            blocks.push(...coreContent(entity, runtime));
         }
         if (entity.owner_teams || entity.owner_users) {
             blocks.push(ui.h3("Owners"));
@@ -36,11 +36,11 @@ export function renderEntityList(entities, nextCursor) {
     }
     renderRichText(blocks);
 }
-export function renderEntity(entity, title = "Entity Information") {
+export function renderEntity(entity, runtime, title = "Entity Information") {
     renderRichText([
         ui.h1(title),
         entity.identifier
-            ? [ui.h2("Core attributes"), ...coreContent(entity)]
+            ? [ui.h2("Core attributes"), ...coreContent(entity, runtime)]
             : null,
         entity.owner_teams ? [ui.h2("Owners"), ...ownersContent(entity)] : null,
         entity.properties
@@ -55,7 +55,7 @@ export function renderEntityDeleted(entity) {
         ui.p(`The entity ${ui.code(entity.identifier)} has been deleted.`),
     ]);
 }
-export function renderEntityScorecardList(scorecards, nextCursor) {
+export function renderEntityScorecardList(scorecards, entityIdentifier, runtime, nextCursor) {
     const blocks = [ui.h1("Scorecards")];
     blocks.push(ui.p(`Displaying ${ui.bold(scorecards.length.toString())} scorecards.`));
     if (nextCursor) {
@@ -63,7 +63,7 @@ export function renderEntityScorecardList(scorecards, nextCursor) {
     }
     for (const scorecard of scorecards) {
         blocks.push(ui.h2(scorecard.name));
-        blocks.push(...scorecardReportContent(scorecard));
+        blocks.push(...scorecardReportContent(scorecard, entityIdentifier, runtime));
     }
     renderRichText(blocks);
 }
@@ -79,8 +79,9 @@ export function renderEntityTaskList(tasks, nextCursor) {
     }
     renderRichText(blocks);
 }
-function scorecardReportContent(scorecard) {
+function scorecardReportContent(scorecard, entityIdentifier, runtime) {
     const blocks = [];
+    blocks.push(ui.p(ui.link(ui.webLink(`/catalog/${entityIdentifier}/scorecards?expanded=${scorecard.id}`, runtime))));
     if (scorecard.type === "POINTS") {
         const total = scorecard.points_meta?.points_total ?? 0;
         const achieved = scorecard.points_meta?.points_achieved ?? 0;
@@ -179,7 +180,7 @@ function dueDateText(completeBy) {
         return formattedDate;
     }
 }
-function coreContent(entity) {
+function coreContent(entity, runtime) {
     return [
         ui.dl([
             ui.dli("Name", [ui.p(entity.name ?? ui.dim("(None)"), false)]),
@@ -188,7 +189,10 @@ function coreContent(entity) {
             ui.dli("Created", [
                 ui.p(ui.timestampSummary(entity.created_at), false),
             ]),
-            ui.dli("Last updated", [ui.p(ui.timestampSummary(entity.updated_at))]),
+            ui.dli("Last updated", ui.timestampSummary(entity.updated_at)),
+            ui.dli("Web link", [
+                ui.p(ui.link(ui.webLink(`/catalog/${entity.identifier}`, runtime))),
+            ]),
             ui.dli("Description", [
                 ui.p(entity.description ?? ui.dim("(None)"), false),
             ]),

package/dist/commands/catalog/entityTypes.js

@@ -53,7 +53,7 @@ export function entityTypesCommand() {
             renderJson({ ok: true, entity_type: response.entity_type });
         }
         else {
-            renderEntityType(response.entity_type, `${ui.success(ui.GLYPHS.CHECK)} Entity type created`);
+            renderEntityType(response.entity_type, runtime, `${ui.success(ui.GLYPHS.CHECK)} Entity type created`);
         }
     }));
     entityTypes
@@ -106,7 +106,7 @@ export function entityTypesCommand() {
             renderJson(processedEntityType);
         }
         else {
-            renderEntityType(processedEntityType);
+            renderEntityType(processedEntityType, runtime);
         }
     }));
     entityTypes
@@ -200,7 +200,7 @@ export function entityTypesCommand() {
             renderJson({ ...response, entity_types: processedEntityTypes });
         }
         else {
-            renderEntityTypeList(processedEntityTypes, response.response_metadata?.next_cursor ?? null);
+            renderEntityTypeList(processedEntityTypes, response.response_metadata?.next_cursor ?? null, runtime);
         }
     }));
     entityTypes
@@ -245,7 +245,7 @@ export function entityTypesCommand() {
             renderJson({ ok: true, entity_type: response.entity_type });
         }
         else {
-            renderEntityType(response.entity_type, `${ui.success(ui.GLYPHS.CHECK)} Entity type updated`);
+            renderEntityType(response.entity_type, runtime, `${ui.success(ui.GLYPHS.CHECK)} Entity type updated`);
         }
     }));
     return entityTypes;

package/dist/commands/catalog/entityTypesRendering.js

@@ -1,6 +1,6 @@
 import { renderRichText } from "../../renderers.js";
 import * as ui from "../../ui.js";
-export function renderEntityTypeList(entityTypes, nextCursor) {
+export function renderEntityTypeList(entityTypes, nextCursor, runtime) {
     const blocks = [ui.h1("Entity Types")];
     blocks.push(ui.p(`Displaying ${ui.bold(entityTypes.length.toString())} entity types.`));
     if (nextCursor) {
@@ -18,7 +18,7 @@ export function renderEntityTypeList(entityTypes, nextCursor) {
         }
         if (entityType.identifier) {
             blocks.push(ui.h3("Core attributes"));
-            blocks.push(...coreContent(entityType));
+            blocks.push(...coreContent(entityType, runtime));
         }
         if (entityType.properties) {
             blocks.push(ui.h3("Properties"));
@@ -31,11 +31,11 @@ export function renderEntityTypeList(entityTypes, nextCursor) {
     }
     renderRichText(blocks);
 }
-export function renderEntityType(entityType, title = "Entity Type Information") {
+export function renderEntityType(entityType, runtime, title = "Entity Type Information") {
     renderRichText([
         ui.h1(title),
         entityType.identifier
-            ? [ui.h2("Core attributes"), ...coreContent(entityType)]
+            ? [ui.h2("Core attributes"), ...coreContent(entityType, runtime)]
             : null,
         entityType.properties
             ? [ui.h2("Properties"), ...propertiesContent(entityType.properties)]
@@ -51,25 +51,19 @@ export function renderEntityTypeDeleted(entityType) {
         ui.p(`The entity type ${ui.code(entityType.identifier)} has been deleted.`),
     ]);
 }
-function coreContent(entityType) {
+function coreContent(entityType, runtime) {
     return [
         ui.dl([
-            ui.dli("Name", [ui.p(entityType.name ?? ui.dim("(None)"), false)]),
-            ui.dli("Identifier", [ui.p(ui.code(entityType.identifier), false)]),
-            ui.dli("Description", [
-                ui.p(entityType.description || ui.dim("(None)"), false),
-            ]),
-            ui.dli("Icon", [ui.p(entityType.icon ?? ui.dim("(None)"), false)]),
-            ui.dli("Ordering", [
-                ui.p(entityType.ordering?.toString() ?? ui.dim("(None)"), false),
-            ]),
-            ui.dli("Created", [
-                ui.p(ui.timestampSummary(entityType.created_at), false),
-            ]),
-            ui.dli("Last updated", [
-                ui.p(ui.timestampSummary(entityType.updated_at)),
-            ]),
-        ], { termWidth: 14 }),
+            ui.dli("Name", entityType.name ?? ui.dim("(None)")),
+            ui.dli("Identifier", ui.code(entityType.identifier)),
+            ui.dli("Description", entityType.description || ui.dim("(None)")),
+            ui.dli("Icon", entityType.icon ?? ui.dim("(None)")),
+            ui.dli("Ordering", entityType.ordering?.toString() ?? ui.dim("(None)")),
+            ui.dli("Created", ui.timestampSummary(entityType.created_at)),
+            ui.dli("Last updated", ui.timestampSummary(entityType.updated_at)),
+            ui.dli("Entities link", ui.link(ui.webLink(`/catalog?type=${entityType.identifier}`, runtime))),
+            ui.dli("Settings link", ui.link(ui.webLink(`/catalog/manage/entitytypes/${entityType.identifier}`, runtime))),
+        ], { termWidth: 15 }),
     ];
 }
 function propertiesContent(properties) {