@barekey/cli 0.5.8 → 0.5.9

package/dist/commands/audit.js

@@ -2,6 +2,7 @@ import { createCliAuthProvider } from "../auth-provider.js";
 import { requireLocalSession, toJsonOutput } from "../command-utils.js";
 import { AuditListResponseSchema } from "../contracts/index.js";
 import { postJson } from "../http.js";
+import { info, muted, subtle, strong } from "../output/theme.js";
 import { promptForOrganizationSlug } from "./target-prompts.js";
 async function runAuditList(options) {
     const local = await requireLocalSession();
@@ -25,11 +26,11 @@ async function runAuditList(options) {
         return;
     }
     if (response.items.length === 0) {
-        console.log("No audit events found.");
+        console.log(subtle("No audit events found."));
         return;
     }
     for (const item of response.items) {
-        console.log(`${new Date(item.occurredAtMs).toISOString()} ${item.category} ${item.title}`);
+        console.log(`${muted(new Date(item.occurredAtMs).toISOString())} ${info(item.category)} ${strong(item.title)}`);
     }
 }
 export function registerAuditCommands(program) {

package/dist/commands/auth.js

@@ -9,6 +9,7 @@ import { clearConfig, deleteCredentials, saveConfig, saveCredentials, } from "..
 import { CliSessionResponseSchema, DevicePollResponseSchema, DeviceStartResponseSchema, RefreshResponseSchema, } from "../contracts/index.js";
 import { getJson, postJson } from "../http.js";
 import { formatWhoamiWithAvatar } from "../output/avatar.js";
+import { accent, muted, strong, success } from "../output/theme.js";
 import { requireLocalSession, resolveBaseUrl, toJsonOutput } from "../command-utils.js";
 function resolveClientName() {
     const configured = process.env.BAREKEY_CLIENT_NAME?.trim() ||
@@ -60,8 +61,8 @@ async function runLogin(options) {
         const verificationUri = resolveVerificationUri(baseUrl, started.verificationUri);
         loading.stop("Authorization initialized");
         loadingActive = false;
-        console.log(`${pc.bold("Open")}: ${verificationUri}`);
-        console.log(`${pc.bold("Code")}: ${started.userCode}`);
+        console.log(`${accent("Open")} ${muted(verificationUri)}`);
+        console.log(`${accent("Code")} ${strong(started.userCode)}`);
         try {
             await open(verificationUri);
         }
@@ -115,7 +116,7 @@ async function runLogin(options) {
             });
             pollSpinner.stop("Login approved");
             pollActive = false;
-            outro(`Signed in as ${pc.bold(resolveDisplayName(refreshed))}.`);
+            outro(`${success("Signed in as")} ${pc.bold(resolveDisplayName(refreshed))}.`);
             return;
         }
         pollSpinner.stop("Timed out");
@@ -143,7 +144,7 @@ async function runLogout() {
     });
     await deleteCredentials(local.accountId);
     await clearConfig();
-    console.log("Logged out.");
+    console.log(success("Logged out."));
 }
 async function runWhoami(options) {
     const local = await requireLocalSession();

package/dist/commands/billing.js

@@ -2,6 +2,7 @@ import { createCliAuthProvider } from "../auth-provider.js";
 import { requireLocalSession, toJsonOutput } from "../command-utils.js";
 import { BillingCatalogResponseSchema, BillingStatusResponseSchema } from "../contracts/index.js";
 import { getJson, postJson } from "../http.js";
+import { accent, info, muted, strong, subtle, warning } from "../output/theme.js";
 import { promptForOrganizationSlug } from "./target-prompts.js";
 async function runBillingCatalog(options) {
     const local = await requireLocalSession();
@@ -14,8 +15,8 @@ async function runBillingCatalog(options) {
         toJsonOutput(true, response);
         return;
     }
-    console.log(`Plans: ${response.variants.length}`);
-    console.log(`Metered features: ${Object.values(response.featureIds).join(", ")}`);
+    console.log(`${subtle("Plans")} ${strong(String(response.variants.length))}`);
+    console.log(`${subtle("Metered features")} ${info(Object.values(response.featureIds).join(", "))}`);
 }
 async function runBillingStatus(options) {
     const local = await requireLocalSession();
@@ -35,9 +36,9 @@ async function runBillingStatus(options) {
         toJsonOutput(true, response);
         return;
     }
-    console.log(`Tier: ${response.currentTier ?? "none"}`);
-    console.log(`Product: ${response.currentProductId ?? "none"}`);
-    console.log(`Can manage billing: ${response.canManageBilling ? "yes" : "no"}`);
+    console.log(`${subtle("Tier")} ${warning(response.currentTier ?? "none")}`);
+    console.log(`${subtle("Product")} ${muted(response.currentProductId ?? "none")}`);
+    console.log(`${subtle("Can manage billing")} ${response.canManageBilling ? accent("yes") : muted("no")}`);
 }
 export function registerBillingCommands(program) {
     const billing = program.command("billing").description("Billing information");

package/dist/commands/env.js

@@ -5,6 +5,7 @@ import { addTargetOptions, dotenvEscape, parseChance, requireLocalSession, resol
 import { EnvEvaluateBatchResponseSchema, EnvEvaluateResponseSchema, EnvListResponseSchema, EnvPullResponseSchema, EnvWriteResponseSchema, } from "../contracts/index.js";
 import { postJson } from "../http.js";
 import { collectOptionValues, parseRolloutFunction, parseRolloutMilestones, parseVisibility, } from "./env-helpers.js";
+import { accent, info, muted, strong, subtle, success, warning } from "../output/theme.js";
 async function resolveEnvAccess(options) {
     const local = await requireLocalSession();
     const target = await resolveTarget(options, local);
@@ -98,7 +99,7 @@ async function runEnvGet(name, options) {
         toJsonOutput(true, value);
         return;
     }
-    console.log(renderScalar(value.value));
+    console.log(`${accent(resolvedName)} ${subtle("=")} ${strong(renderScalar(value.value))}`);
 }
 async function runEnvGetMany(options) {
     const namesCsv = await promptForRequiredText(options.names, "Which variable names do you want, comma-separated?");
@@ -126,7 +127,7 @@ async function runEnvGetMany(options) {
         return;
     }
     for (const value of [...response.values].sort((left, right) => left.name.localeCompare(right.name))) {
-        console.log(`${value.name}=${renderScalar(value.value)}`);
+        console.log(`${accent(value.name)}${subtle("=")}${strong(renderScalar(value.value))}`);
     }
 }
 async function runEnvList(options) {
@@ -147,7 +148,7 @@ async function runEnvList(options) {
         return;
     }
     if (response.variables.length === 0) {
-        console.log("No variables found.");
+        console.log(subtle("No variables found."));
         return;
     }
     for (const row of response.variables) {
@@ -155,7 +156,9 @@ async function runEnvList(options) {
         const rolloutSuffix = row.kind === "rollout"
             ? ` ${row.rolloutFunction ?? "linear"}(${row.rolloutMilestones?.length ?? 0} milestones)`
             : "";
-        console.log(`${row.name}  ${row.visibility}  ${row.kind}  ${row.declaredType}${chanceSuffix}${rolloutSuffix}`);
+        const formattedChanceSuffix = chanceSuffix.length > 0 ? muted(chanceSuffix) : "";
+        const formattedRolloutSuffix = rolloutSuffix.length > 0 ? muted(rolloutSuffix) : "";
+        console.log(`${strong(row.name)}  ${muted(row.visibility)}  ${info(row.kind)}  ${accent(row.declaredType)}${formattedChanceSuffix}${formattedRolloutSuffix}`);
     }
 }
 async function runEnvWrite(operation, name, value, options) {
@@ -223,7 +226,7 @@ async function runEnvWrite(operation, name, value, options) {
         toJsonOutput(true, result);
         return;
     }
-    console.log(`Created: ${result.createdCount}, Updated: ${result.updatedCount}, Deleted: ${result.deletedCount}`);
+    console.log(`${success("Created")} ${strong(String(result.createdCount))} ${subtle("•")} ${warning("Updated")} ${strong(String(result.updatedCount))} ${subtle("•")} ${muted("Deleted")} ${strong(String(result.deletedCount))}`);
 }
 async function runEnvDelete(name, options) {
     const resolvedName = await promptForRequiredText(name, "What's the name of the variable to delete?");
@@ -279,7 +282,7 @@ async function runEnvDelete(name, options) {
         toJsonOutput(true, result);
         return;
     }
-    console.log(`Deleted: ${result.deletedCount}`);
+    console.log(`${success("Deleted")} ${strong(String(result.deletedCount))}`);
 }
 async function runEnvPull(options) {
     const { local, target, accessToken } = await resolveEnvAccess(options);
@@ -303,11 +306,11 @@ async function runEnvPull(options) {
         : `${sortedKeys.map((keyName) => `${keyName}=${dotenvEscape(response.byName[keyName] ?? "")}`).join("\n")}\n`;
     if (options.out) {
         await writeFile(options.out, output, "utf8");
-        console.log(`Wrote ${options.out}`);
+        console.log(`${success("Wrote")} ${muted(options.out)}`);
         return;
     }
     if (options.redact && !process.stdout.isTTY) {
-        console.log(`Pulled ${response.values.length} variables.`);
+        console.log(`${success("Pulled")} ${strong(String(response.values.length))} ${muted("variables.")}`);
         return;
     }
     process.stdout.write(output);

package/dist/commands/init.js

@@ -1,6 +1,7 @@
 import { writeFile } from "node:fs/promises";
 import path from "node:path";
 import { promptForOrganizationSlug, promptForProjectSlug, promptForStageSlug, } from "./target-prompts.js";
+import { muted, success } from "../output/theme.js";
 async function runInit(options) {
     const orgSlug = await promptForOrganizationSlug(options.org);
     const projectSlug = await promptForProjectSlug(orgSlug, options.project);
@@ -16,7 +17,7 @@ async function runInit(options) {
         },
     }, null, 2)}\n`;
     await writeFile(configPath, contents, "utf8");
-    console.log(`Wrote ${configPath}`);
+    console.log(`${success("Wrote")} ${muted(configPath)}`);
 }
 export function registerInitCommand(program) {
     program

package/dist/commands/org.js

@@ -3,6 +3,7 @@ import { createCliAuthProvider } from "../auth-provider.js";
 import { requireLocalSession, toJsonOutput } from "../command-utils.js";
 import { OrganizationsResponseSchema } from "../contracts/index.js";
 import { getJson, postJson } from "../http.js";
+import { accent, info, muted, strong, subtle, success } from "../output/theme.js";
 async function promptForName(name) {
     const existing = name?.trim();
     if (existing && existing.length > 0) {
@@ -36,11 +37,11 @@ async function runOrgList(options) {
         return;
     }
     if (response.organizations.length === 0) {
-        console.log("No organizations found.");
+        console.log(subtle("No organizations found."));
         return;
     }
     for (const organization of response.organizations) {
-        console.log(`${organization.name} (${organization.slug}) ${organization.role}`);
+        console.log(`${strong(organization.name)} ${muted(`(${organization.slug})`)} ${info(organization.role)}`);
     }
 }
 async function runOrgCreate(name, options) {
@@ -62,7 +63,7 @@ async function runOrgCreate(name, options) {
         return;
     }
     const organization = response.organization;
-    console.log(`Created organization ${organization.name} (${organization.slug}).`);
+    console.log(`${success("Created")} ${accent("organization")} ${strong(organization.name)} ${muted(`(${organization.slug})`)}`);
 }
 export function registerOrgCommands(program) {
     const org = program.command("org").description("Organization management");

package/dist/commands/project.js

@@ -1,6 +1,7 @@
 import { cancel, confirm, isCancel, text } from "@clack/prompts";
 import { toJsonOutput } from "../command-utils.js";
 import { createProjectForOrganization, deleteProjectForOrganization, listProjectsForOrganization, promptForOrganizationSlug, promptForProjectSlug, } from "./target-prompts.js";
+import { accent, info, muted, strong, subtle, success } from "../output/theme.js";
 async function promptForProjectName(name) {
     const existing = name?.trim();
     if (existing && existing.length > 0) {
@@ -27,11 +28,11 @@ async function runProjectList(options) {
         return;
     }
     if (projects.length === 0) {
-        console.log("No projects found.");
+        console.log(subtle("No projects found."));
         return;
     }
     for (const project of projects) {
-        console.log(`${project.name} (${project.slug}) secrets=${project.secretCount}`);
+        console.log(`${strong(project.name)} ${muted(`(${project.slug})`)} ${info(`secrets=${project.secretCount}`)}`);
     }
 }
 async function runProjectCreate(name, options) {
@@ -42,7 +43,7 @@ async function runProjectCreate(name, options) {
         toJsonOutput(true, project);
         return;
     }
-    console.log(`Created project ${project.name} (${project.slug}).`);
+    console.log(`${success("Created")} ${accent("project")} ${strong(project.name)} ${muted(`(${project.slug})`)}`);
 }
 export function registerProjectCommands(program) {
     const project = program.command("project").description("Project management");
@@ -94,6 +95,6 @@ export function registerProjectCommands(program) {
             toJsonOutput(true, response);
             return;
         }
-        console.log(`Deleted project ${response.deletedProjectSlug}.`);
+        console.log(`${success("Deleted")} ${accent("project")} ${muted(response.deletedProjectSlug)}`);
     });
 }

package/dist/commands/stage.js

@@ -1,6 +1,7 @@
 import { cancel, confirm, isCancel, text } from "@clack/prompts";
 import { toJsonOutput } from "../command-utils.js";
 import { createStageForProject, deleteStageForProject, listStagesForProject, promptForOrganizationSlug, promptForProjectSlug, promptForStageSlug, renameStageForProject, } from "./target-prompts.js";
+import { accent, info, muted, strong, subtle, success, warning } from "../output/theme.js";
 async function promptForStageName(name) {
     const existing = name?.trim();
     if (existing && existing.length > 0) {
@@ -28,11 +29,11 @@ async function runStageList(options) {
         return;
     }
     if (stages.length === 0) {
-        console.log("No stages found.");
+        console.log(subtle("No stages found."));
         return;
     }
     for (const stage of stages) {
-        console.log(`${stage.name} (${stage.slug}) variables=${stage.variableCount}`);
+        console.log(`${strong(stage.name)} ${muted(`(${stage.slug})`)} ${info(`variables=${stage.variableCount}`)}`);
     }
 }
 async function runStageCreate(name, options) {
@@ -44,7 +45,7 @@ async function runStageCreate(name, options) {
         toJsonOutput(true, stage);
         return;
     }
-    console.log(`Created stage ${stage.name} (${stage.slug}).`);
+    console.log(`${success("Created")} ${accent("stage")} ${strong(stage.name)} ${muted(`(${stage.slug})`)}`);
 }
 export function registerStageCommands(program) {
     const stage = program.command("stage").description("Stage management");
@@ -85,7 +86,7 @@ export function registerStageCommands(program) {
             toJsonOutput(true, stage);
             return;
         }
-        console.log(`Renamed stage ${stage.slug} to ${stage.name}.`);
+        console.log(`${warning("Renamed")} ${accent("stage")} ${muted(stage.slug)} ${subtle("→")} ${strong(stage.name)}`);
     });
     stage
         .command("delete")
@@ -120,6 +121,6 @@ export function registerStageCommands(program) {
             toJsonOutput(true, response);
             return;
         }
-        console.log(`Deleted stage ${response.deletedStageSlug}.`);
+        console.log(`${success("Deleted")} ${accent("stage")} ${muted(response.deletedStageSlug)}`);
     });
 }

package/dist/commands/typegen.js

@@ -1,30 +1,30 @@
-import pc from "picocolors";
 import { createCliAuthProvider } from "../auth-provider.js";
 import { addTargetOptions, requireLocalSession, resolveTarget, } from "../command-utils.js";
 import { TypegenManifestSchema } from "../contracts/index.js";
 import { getJson } from "../http.js";
 import { loadRuntimeConfig } from "../runtime-config.js";
 import { writeInstalledSdkGeneratedTypes, } from "../typegen/core.js";
+import { accent, info, muted, strong, success, warning } from "../output/theme.js";
 const DEFAULT_TYPEGEN_WATCH_INTERVAL_MS = 5_000;
 export function formatTypegenResultMessage(result) {
     const title = result.written
-        ? pc.green(pc.bold("Typegen complete"))
-        : pc.cyan(pc.bold("Typegen already up to date"));
+        ? success(strong("Typegen complete"))
+        : info(strong("Typegen already up to date"));
     const detail = result.written
         ? "Fresh SDK types are ready in your installed @barekey/sdk package."
         : "Your installed @barekey/sdk package already has the latest generated types.";
     return [
         title,
-        detail,
-        `${pc.bold("Server types")}: ${result.serverPath}`,
-        `${pc.bold("Public types")}: ${result.publicPath}`,
+        muted(detail),
+        `${accent("Server types")} ${muted(result.serverPath)}`,
+        `${accent("Public types")} ${muted(result.publicPath)}`,
     ].join("\n");
 }
 export function formatTypegenWatchStartedMessage(input) {
     return [
-        pc.cyan(pc.bold("Watching Barekey typegen")),
-        `Target: ${pc.bold(`${input.organization}/${input.project}@${input.environment}`)}`,
-        `Polling every ${pc.bold(`${input.intervalMs}ms`)}. Press ${pc.bold("Ctrl+C")} to stop.`,
+        info(strong("Watching Barekey typegen")),
+        `${accent("Target")} ${strong(`${input.organization}/${input.project}@${input.environment}`)}`,
+        `${warning("Polling every")} ${strong(`${input.intervalMs}ms`)}${muted(". Press Ctrl+C to stop.")}`,
     ].join("\n");
 }
 export function parseTypegenWatchInterval(value) {

package/dist/index.js

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 import { Command } from "commander";
-import pc from "picocolors";
 import { registerAuthCommands } from "./commands/auth.js";
 import { registerAuditCommands } from "./commands/audit.js";
 import { registerBillingCommands } from "./commands/billing.js";
@@ -11,8 +10,13 @@ import { registerProjectCommands } from "./commands/project.js";
 import { registerStageCommands } from "./commands/stage.js";
 import { registerTypegenCommand } from "./commands/typegen.js";
 import { CLI_DESCRIPTION, CLI_NAME, CLI_VERSION } from "./constants.js";
+import { danger } from "./output/theme.js";
 const program = new Command();
 program.name(CLI_NAME).description(CLI_DESCRIPTION).version(CLI_VERSION);
+program.configureOutput({
+    writeErr: (message) => process.stderr.write(message),
+    outputError: (message, write) => write(danger(message)),
+});
 registerAuthCommands(program);
 registerAuditCommands(program);
 registerBillingCommands(program);
@@ -24,6 +28,6 @@ registerEnvCommands(program);
 registerTypegenCommand(program);
 program.parseAsync(process.argv).catch((error) => {
     const message = error instanceof Error ? error.message : "Command failed.";
-    console.error(pc.red(message));
+    console.error(danger(message));
     process.exitCode = 1;
 });

package/dist/output/theme.d.ts

@@ -0,0 +1,112 @@
+declare const MINECRAFT_HEX: {
+    readonly "1": "#0000AA";
+    readonly "6": "#FFAA00";
+    readonly "7": "#AAAAAA";
+    readonly "8": "#555555";
+    readonly a: "#55FF55";
+    readonly b: "#55FFFF";
+    readonly c: "#FF5555";
+    readonly e: "#FFFF55";
+};
+type MinecraftColorCode = keyof typeof MINECRAFT_HEX;
+/**
+ * Returns whether styled terminal output should be emitted.
+ *
+ * @returns `true` when stdout is interactive and color has not been disabled.
+ * @remarks This keeps human output colorful while preserving clean automation output in dumb/no-color terminals.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function supportsCliColor(): boolean;
+/**
+ * Applies one Minecraft-style truecolor swatch to a string.
+ *
+ * @param code The legacy Minecraft color code to emulate.
+ * @param value The text to colorize.
+ * @returns The styled string, or the original text when colors are disabled.
+ * @remarks This uses truecolor ANSI so the palette stays stable across modern terminals.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function mc(code: MinecraftColorCode, value: string): string;
+/**
+ * Styles one primary CLI label.
+ *
+ * @param value The label text.
+ * @returns The highlighted label.
+ * @remarks Gold is used as the main CLI accent color.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function accent(value: string): string;
+/**
+ * Styles one positive/success string.
+ *
+ * @param value The text to colorize.
+ * @returns The success-colored string.
+ * @remarks Green is used for successful actions and positive counts.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function success(value: string): string;
+/**
+ * Styles one informational string.
+ *
+ * @param value The text to colorize.
+ * @returns The info-colored string.
+ * @remarks Aqua is used for list metadata and secondary highlights.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function info(value: string): string;
+/**
+ * Styles one warning string.
+ *
+ * @param value The text to colorize.
+ * @returns The warning-colored string.
+ * @remarks Bright yellow is used for cautionary or count summary output.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function warning(value: string): string;
+/**
+ * Styles one muted metadata string.
+ *
+ * @param value The text to colorize.
+ * @returns The muted string.
+ * @remarks Gray is used for low-emphasis metadata like slugs and file paths.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function muted(value: string): string;
+/**
+ * Styles one subtle low-contrast string.
+ *
+ * @param value The text to colorize.
+ * @returns The subtle string.
+ * @remarks Dark gray is used for separators, labels, and empty-state output.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function subtle(value: string): string;
+/**
+ * Styles one failure/error string.
+ *
+ * @param value The text to colorize.
+ * @returns The danger-colored string.
+ * @remarks Red is reserved for errors and destructive outcomes.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function danger(value: string): string;
+/**
+ * Styles one prominent value with bold emphasis.
+ *
+ * @param value The text to emphasize.
+ * @returns The bold string.
+ * @remarks This intentionally leaves color choice to the caller.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function strong(value: string): string;
+export {};

package/dist/output/theme.js

@@ -0,0 +1,149 @@
+import pc from "picocolors";
+const MINECRAFT_HEX = {
+    "1": "#0000AA",
+    "6": "#FFAA00",
+    "7": "#AAAAAA",
+    "8": "#555555",
+    "a": "#55FF55",
+    "b": "#55FFFF",
+    "c": "#FF5555",
+    "e": "#FFFF55",
+};
+/**
+ * Returns whether styled terminal output should be emitted.
+ *
+ * @returns `true` when stdout is interactive and color has not been disabled.
+ * @remarks This keeps human output colorful while preserving clean automation output in dumb/no-color terminals.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function supportsCliColor() {
+    if (!process.stdout.isTTY) {
+        return false;
+    }
+    if ((process.env.NO_COLOR ?? "").trim().length > 0) {
+        return false;
+    }
+    return (process.env.TERM ?? "").toLowerCase() !== "dumb";
+}
+function hexToRgb(hex) {
+    const normalized = hex.replace(/^#/, "");
+    return {
+        red: Number.parseInt(normalized.slice(0, 2), 16),
+        green: Number.parseInt(normalized.slice(2, 4), 16),
+        blue: Number.parseInt(normalized.slice(4, 6), 16),
+    };
+}
+/**
+ * Applies one Minecraft-style truecolor swatch to a string.
+ *
+ * @param code The legacy Minecraft color code to emulate.
+ * @param value The text to colorize.
+ * @returns The styled string, or the original text when colors are disabled.
+ * @remarks This uses truecolor ANSI so the palette stays stable across modern terminals.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function mc(code, value) {
+    if (!supportsCliColor()) {
+        return value;
+    }
+    const { red, green, blue } = hexToRgb(MINECRAFT_HEX[code]);
+    return `\u001b[38;2;${red};${green};${blue}m${value}\u001b[39m`;
+}
+/**
+ * Styles one primary CLI label.
+ *
+ * @param value The label text.
+ * @returns The highlighted label.
+ * @remarks Gold is used as the main CLI accent color.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function accent(value) {
+    return mc("6", value);
+}
+/**
+ * Styles one positive/success string.
+ *
+ * @param value The text to colorize.
+ * @returns The success-colored string.
+ * @remarks Green is used for successful actions and positive counts.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function success(value) {
+    return mc("a", value);
+}
+/**
+ * Styles one informational string.
+ *
+ * @param value The text to colorize.
+ * @returns The info-colored string.
+ * @remarks Aqua is used for list metadata and secondary highlights.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function info(value) {
+    return mc("b", value);
+}
+/**
+ * Styles one warning string.
+ *
+ * @param value The text to colorize.
+ * @returns The warning-colored string.
+ * @remarks Bright yellow is used for cautionary or count summary output.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function warning(value) {
+    return mc("e", value);
+}
+/**
+ * Styles one muted metadata string.
+ *
+ * @param value The text to colorize.
+ * @returns The muted string.
+ * @remarks Gray is used for low-emphasis metadata like slugs and file paths.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function muted(value) {
+    return mc("7", value);
+}
+/**
+ * Styles one subtle low-contrast string.
+ *
+ * @param value The text to colorize.
+ * @returns The subtle string.
+ * @remarks Dark gray is used for separators, labels, and empty-state output.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function subtle(value) {
+    return mc("8", value);
+}
+/**
+ * Styles one failure/error string.
+ *
+ * @param value The text to colorize.
+ * @returns The danger-colored string.
+ * @remarks Red is reserved for errors and destructive outcomes.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function danger(value) {
+    return mc("c", value);
+}
+/**
+ * Styles one prominent value with bold emphasis.
+ *
+ * @param value The text to emphasize.
+ * @returns The bold string.
+ * @remarks This intentionally leaves color choice to the caller.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function strong(value) {
+    return pc.bold(value);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barekey/cli",
-  "version": "0.5.8",
+  "version": "0.5.9",
   "description": "Barekey command line interface",
   "type": "module",
   "bin": {

package/src/commands/audit.ts

@@ -4,6 +4,7 @@ import { createCliAuthProvider } from "../auth-provider.js";
 import { requireLocalSession, toJsonOutput, type EnvTargetOptions } from "../command-utils.js";
 import { AuditListResponseSchema } from "../contracts/index.js";
 import { postJson } from "../http.js";
+import { info, muted, subtle, strong } from "../output/theme.js";
 import { promptForOrganizationSlug } from "./target-prompts.js";
 
 async function runAuditList(
@@ -36,12 +37,14 @@ async function runAuditList(
   }
 
   if (response.items.length === 0) {
-    console.log("No audit events found.");
+    console.log(subtle("No audit events found."));
     return;
   }
 
   for (const item of response.items) {
-    console.log(`${new Date(item.occurredAtMs).toISOString()} ${item.category} ${item.title}`);
+    console.log(
+      `${muted(new Date(item.occurredAtMs).toISOString())} ${info(item.category)} ${strong(item.title)}`,
+    );
   }
 }
 

package/src/commands/auth.ts

@@ -22,6 +22,7 @@ import {
 } from "../contracts/index.js";
 import { getJson, postJson } from "../http.js";
 import { formatWhoamiWithAvatar } from "../output/avatar.js";
+import { accent, muted, strong, success } from "../output/theme.js";
 import { requireLocalSession, resolveBaseUrl, toJsonOutput } from "../command-utils.js";
 
 function resolveClientName(): string | undefined {
@@ -88,8 +89,8 @@ async function runLogin(options: { baseUrl?: string }): Promise<void> {
 
     loading.stop("Authorization initialized");
     loadingActive = false;
-    console.log(`${pc.bold("Open")}: ${verificationUri}`);
-    console.log(`${pc.bold("Code")}: ${started.userCode}`);
+    console.log(`${accent("Open")} ${muted(verificationUri)}`);
+    console.log(`${accent("Code")} ${strong(started.userCode)}`);
 
     try {
       await open(verificationUri);
@@ -149,7 +150,7 @@ async function runLogin(options: { baseUrl?: string }): Promise<void> {
 
       pollSpinner.stop("Login approved");
       pollActive = false;
-      outro(`Signed in as ${pc.bold(resolveDisplayName(refreshed))}.`);
+      outro(`${success("Signed in as")} ${pc.bold(resolveDisplayName(refreshed))}.`);
       return;
     }
 
@@ -178,7 +179,7 @@ async function runLogout(): Promise<void> {
   });
   await deleteCredentials(local.accountId);
   await clearConfig();
-  console.log("Logged out.");
+  console.log(success("Logged out."));
 }
 
 async function runWhoami(options: { json?: boolean }): Promise<void> {

package/src/commands/billing.ts

@@ -4,6 +4,7 @@ import { createCliAuthProvider } from "../auth-provider.js";
 import { requireLocalSession, toJsonOutput, type EnvTargetOptions } from "../command-utils.js";
 import { BillingCatalogResponseSchema, BillingStatusResponseSchema } from "../contracts/index.js";
 import { getJson, postJson } from "../http.js";
+import { accent, info, muted, strong, subtle, warning } from "../output/theme.js";
 import { promptForOrganizationSlug } from "./target-prompts.js";
 
 async function runBillingCatalog(options: { json?: boolean }) {
@@ -19,8 +20,10 @@ async function runBillingCatalog(options: { json?: boolean }) {
     return;
   }
 
-  console.log(`Plans: ${response.variants.length}`);
-  console.log(`Metered features: ${Object.values(response.featureIds).join(", ")}`);
+  console.log(`${subtle("Plans")} ${strong(String(response.variants.length))}`);
+  console.log(
+    `${subtle("Metered features")} ${info(Object.values(response.featureIds).join(", "))}`,
+  );
 }
 
 async function runBillingStatus(options: EnvTargetOptions & { json?: boolean }) {
@@ -43,9 +46,11 @@ async function runBillingStatus(options: EnvTargetOptions & { json?: boolean })
     return;
   }
 
-  console.log(`Tier: ${response.currentTier ?? "none"}`);
-  console.log(`Product: ${response.currentProductId ?? "none"}`);
-  console.log(`Can manage billing: ${response.canManageBilling ? "yes" : "no"}`);
+  console.log(`${subtle("Tier")} ${warning(response.currentTier ?? "none")}`);
+  console.log(`${subtle("Product")} ${muted(response.currentProductId ?? "none")}`);
+  console.log(
+    `${subtle("Can manage billing")} ${response.canManageBilling ? accent("yes") : muted("no")}`,
+  );
 }
 
 export function registerBillingCommands(program: Command): void {

package/src/commands/env.ts

@@ -29,6 +29,7 @@ import {
   type CliRolloutFunction,
   type CliVisibility,
 } from "./env-helpers.js";
+import { accent, info, muted, strong, subtle, success, warning } from "../output/theme.js";
 
 type EnvWriteOptions = EnvTargetOptions & {
   ab?: string;
@@ -158,7 +159,7 @@ async function runEnvGet(
     return;
   }
 
-  console.log(renderScalar(value.value));
+  console.log(`${accent(resolvedName)} ${subtle("=")} ${strong(renderScalar(value.value))}`);
 }
 
 async function runEnvGetMany(
@@ -201,7 +202,7 @@ async function runEnvGetMany(
   }
 
   for (const value of [...response.values].sort((left, right) => left.name.localeCompare(right.name))) {
-    console.log(`${value.name}=${renderScalar(value.value)}`);
+    console.log(`${accent(value.name)}${subtle("=")}${strong(renderScalar(value.value))}`);
   }
 }
 
@@ -225,7 +226,7 @@ async function runEnvList(options: EnvTargetOptions & { json?: boolean }): Promi
   }
 
   if (response.variables.length === 0) {
-    console.log("No variables found.");
+    console.log(subtle("No variables found."));
     return;
   }
 
@@ -235,8 +236,10 @@ async function runEnvList(options: EnvTargetOptions & { json?: boolean }): Promi
       row.kind === "rollout"
         ? ` ${row.rolloutFunction ?? "linear"}(${row.rolloutMilestones?.length ?? 0} milestones)`
         : "";
+    const formattedChanceSuffix = chanceSuffix.length > 0 ? muted(chanceSuffix) : "";
+    const formattedRolloutSuffix = rolloutSuffix.length > 0 ? muted(rolloutSuffix) : "";
     console.log(
-      `${row.name}  ${row.visibility}  ${row.kind}  ${row.declaredType}${chanceSuffix}${rolloutSuffix}`,
+      `${strong(row.name)}  ${muted(row.visibility)}  ${info(row.kind)}  ${accent(row.declaredType)}${formattedChanceSuffix}${formattedRolloutSuffix}`,
     );
   }
 }
@@ -320,7 +323,7 @@ async function runEnvWrite(
   }
 
   console.log(
-    `Created: ${result.createdCount}, Updated: ${result.updatedCount}, Deleted: ${result.deletedCount}`,
+    `${success("Created")} ${strong(String(result.createdCount))} ${subtle("•")} ${warning("Updated")} ${strong(String(result.updatedCount))} ${subtle("•")} ${muted("Deleted")} ${strong(String(result.deletedCount))}`,
   );
 }
 
@@ -390,7 +393,7 @@ async function runEnvDelete(
     return;
   }
 
-  console.log(`Deleted: ${result.deletedCount}`);
+  console.log(`${success("Deleted")} ${strong(String(result.deletedCount))}`);
 }
 
 async function runEnvPull(
@@ -426,12 +429,12 @@ async function runEnvPull(
 
   if (options.out) {
     await writeFile(options.out, output, "utf8");
-    console.log(`Wrote ${options.out}`);
+    console.log(`${success("Wrote")} ${muted(options.out)}`);
     return;
   }
 
   if (options.redact && !process.stdout.isTTY) {
-    console.log(`Pulled ${response.values.length} variables.`);
+    console.log(`${success("Pulled")} ${strong(String(response.values.length))} ${muted("variables.")}`);
     return;
   }
 

package/src/commands/init.ts

@@ -9,6 +9,7 @@ import {
   promptForProjectSlug,
   promptForStageSlug,
 } from "./target-prompts.js";
+import { muted, success } from "../output/theme.js";
 
 async function runInit(options: EnvTargetOptions & { path?: string }) {
   const orgSlug = await promptForOrganizationSlug(options.org);
@@ -30,7 +31,7 @@ async function runInit(options: EnvTargetOptions & { path?: string }) {
   )}\n`;
 
   await writeFile(configPath, contents, "utf8");
-  console.log(`Wrote ${configPath}`);
+  console.log(`${success("Wrote")} ${muted(configPath)}`);
 }
 
 export function registerInitCommand(program: Command): void {

package/src/commands/org.ts

@@ -5,6 +5,7 @@ import { createCliAuthProvider } from "../auth-provider.js";
 import { requireLocalSession, toJsonOutput } from "../command-utils.js";
 import { OrganizationsResponseSchema } from "../contracts/index.js";
 import { getJson, postJson } from "../http.js";
+import { accent, info, muted, strong, subtle, success } from "../output/theme.js";
 
 async function promptForName(name: string | undefined): Promise<string> {
   const existing = name?.trim();
@@ -42,12 +43,14 @@ async function runOrgList(options: { json?: boolean }) {
   }
 
   if (response.organizations.length === 0) {
-    console.log("No organizations found.");
+    console.log(subtle("No organizations found."));
     return;
   }
 
   for (const organization of response.organizations) {
-    console.log(`${organization.name} (${organization.slug}) ${organization.role}`);
+    console.log(
+      `${strong(organization.name)} ${muted(`(${organization.slug})`)} ${info(organization.role)}`,
+    );
   }
 }
 
@@ -78,7 +81,9 @@ async function runOrgCreate(
   }
 
   const organization = (response as { organization: { name: string; slug: string } }).organization;
-  console.log(`Created organization ${organization.name} (${organization.slug}).`);
+  console.log(
+    `${success("Created")} ${accent("organization")} ${strong(organization.name)} ${muted(`(${organization.slug})`)}`,
+  );
 }
 
 export function registerOrgCommands(program: Command): void {

package/src/commands/project.ts

@@ -9,6 +9,7 @@ import {
   promptForOrganizationSlug,
   promptForProjectSlug,
 } from "./target-prompts.js";
+import { accent, info, muted, strong, subtle, success } from "../output/theme.js";
 
 async function promptForProjectName(name: string | undefined): Promise<string> {
   const existing = name?.trim();
@@ -39,12 +40,14 @@ async function runProjectList(options: EnvTargetOptions & { json?: boolean }) {
   }
 
   if (projects.length === 0) {
-    console.log("No projects found.");
+    console.log(subtle("No projects found."));
     return;
   }
 
   for (const project of projects) {
-    console.log(`${project.name} (${project.slug}) secrets=${project.secretCount}`);
+    console.log(
+      `${strong(project.name)} ${muted(`(${project.slug})`)} ${info(`secrets=${project.secretCount}`)}`,
+    );
   }
 }
 
@@ -61,7 +64,9 @@ async function runProjectCreate(
     return;
   }
 
-  console.log(`Created project ${project.name} (${project.slug}).`);
+  console.log(
+    `${success("Created")} ${accent("project")} ${strong(project.name)} ${muted(`(${project.slug})`)}`,
+  );
 }
 
 export function registerProjectCommands(program: Command): void {
@@ -124,7 +129,9 @@ export function registerProjectCommands(program: Command): void {
           return;
         }
 
-        console.log(`Deleted project ${response.deletedProjectSlug}.`);
+        console.log(
+          `${success("Deleted")} ${accent("project")} ${muted(response.deletedProjectSlug)}`,
+        );
       },
     );
 }

package/src/commands/stage.ts

@@ -11,6 +11,7 @@ import {
   promptForStageSlug,
   renameStageForProject,
 } from "./target-prompts.js";
+import { accent, info, muted, strong, subtle, success, warning } from "../output/theme.js";
 
 async function promptForStageName(name: string | undefined): Promise<string> {
   const existing = name?.trim();
@@ -42,12 +43,14 @@ async function runStageList(options: EnvTargetOptions & { json?: boolean }) {
   }
 
   if (stages.length === 0) {
-    console.log("No stages found.");
+    console.log(subtle("No stages found."));
     return;
   }
 
   for (const stage of stages) {
-    console.log(`${stage.name} (${stage.slug}) variables=${stage.variableCount}`);
+    console.log(
+      `${strong(stage.name)} ${muted(`(${stage.slug})`)} ${info(`variables=${stage.variableCount}`)}`,
+    );
   }
 }
 
@@ -65,7 +68,9 @@ async function runStageCreate(
     return;
   }
 
-  console.log(`Created stage ${stage.name} (${stage.slug}).`);
+  console.log(
+    `${success("Created")} ${accent("stage")} ${strong(stage.name)} ${muted(`(${stage.slug})`)}`,
+  );
 }
 
 export function registerStageCommands(program: Command): void {
@@ -117,7 +122,9 @@ export function registerStageCommands(program: Command): void {
           return;
         }
 
-        console.log(`Renamed stage ${stage.slug} to ${stage.name}.`);
+        console.log(
+          `${warning("Renamed")} ${accent("stage")} ${muted(stage.slug)} ${subtle("→")} ${strong(stage.name)}`,
+        );
       },
     );
 
@@ -161,7 +168,7 @@ export function registerStageCommands(program: Command): void {
           return;
         }
 
-        console.log(`Deleted stage ${response.deletedStageSlug}.`);
+        console.log(`${success("Deleted")} ${accent("stage")} ${muted(response.deletedStageSlug)}`);
       },
     );
 }

package/src/commands/typegen.ts

@@ -1,5 +1,4 @@
 import { Command } from "commander";
-import pc from "picocolors";
 
 import { createCliAuthProvider } from "../auth-provider.js";
 import {
@@ -15,22 +14,23 @@ import {
   type CliTypegenResult,
   writeInstalledSdkGeneratedTypes,
 } from "../typegen/core.js";
+import { accent, info, muted, strong, success, warning } from "../output/theme.js";
 
 const DEFAULT_TYPEGEN_WATCH_INTERVAL_MS = 5_000;
 
 export function formatTypegenResultMessage(result: CliTypegenResult): string {
   const title = result.written
-    ? pc.green(pc.bold("Typegen complete"))
-    : pc.cyan(pc.bold("Typegen already up to date"));
+    ? success(strong("Typegen complete"))
+    : info(strong("Typegen already up to date"));
   const detail = result.written
     ? "Fresh SDK types are ready in your installed @barekey/sdk package."
     : "Your installed @barekey/sdk package already has the latest generated types.";
 
   return [
     title,
-    detail,
-    `${pc.bold("Server types")}: ${result.serverPath}`,
-    `${pc.bold("Public types")}: ${result.publicPath}`,
+    muted(detail),
+    `${accent("Server types")} ${muted(result.serverPath)}`,
+    `${accent("Public types")} ${muted(result.publicPath)}`,
   ].join("\n");
 }
 
@@ -41,9 +41,9 @@ export function formatTypegenWatchStartedMessage(input: {
   intervalMs: number;
 }): string {
   return [
-    pc.cyan(pc.bold("Watching Barekey typegen")),
-    `Target: ${pc.bold(`${input.organization}/${input.project}@${input.environment}`)}`,
-    `Polling every ${pc.bold(`${input.intervalMs}ms`)}. Press ${pc.bold("Ctrl+C")} to stop.`,
+    info(strong("Watching Barekey typegen")),
+    `${accent("Target")} ${strong(`${input.organization}/${input.project}@${input.environment}`)}`,
+    `${warning("Polling every")} ${strong(`${input.intervalMs}ms`)}${muted(". Press Ctrl+C to stop.")}`,
   ].join("\n");
 }
 

package/src/index.ts

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 import { Command } from "commander";
-import pc from "picocolors";
 
 import { registerAuthCommands } from "./commands/auth.js";
 import { registerAuditCommands } from "./commands/audit.js";
@@ -12,9 +11,14 @@ import { registerProjectCommands } from "./commands/project.js";
 import { registerStageCommands } from "./commands/stage.js";
 import { registerTypegenCommand } from "./commands/typegen.js";
 import { CLI_DESCRIPTION, CLI_NAME, CLI_VERSION } from "./constants.js";
+import { danger } from "./output/theme.js";
 
 const program = new Command();
 program.name(CLI_NAME).description(CLI_DESCRIPTION).version(CLI_VERSION);
+program.configureOutput({
+  writeErr: (message) => process.stderr.write(message),
+  outputError: (message, write) => write(danger(message)),
+});
 
 registerAuthCommands(program);
 registerAuditCommands(program);
@@ -28,6 +32,6 @@ registerTypegenCommand(program);
 
 program.parseAsync(process.argv).catch((error: unknown) => {
   const message = error instanceof Error ? error.message : "Command failed.";
-  console.error(pc.red(message));
+  console.error(danger(message));
   process.exitCode = 1;
 });

package/src/output/theme.ts

@@ -0,0 +1,166 @@
+import pc from "picocolors";
+
+const MINECRAFT_HEX = {
+  "1": "#0000AA",
+  "6": "#FFAA00",
+  "7": "#AAAAAA",
+  "8": "#555555",
+  "a": "#55FF55",
+  "b": "#55FFFF",
+  "c": "#FF5555",
+  "e": "#FFFF55",
+} as const;
+
+type MinecraftColorCode = keyof typeof MINECRAFT_HEX;
+
+/**
+ * Returns whether styled terminal output should be emitted.
+ *
+ * @returns `true` when stdout is interactive and color has not been disabled.
+ * @remarks This keeps human output colorful while preserving clean automation output in dumb/no-color terminals.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function supportsCliColor(): boolean {
+  if (!process.stdout.isTTY) {
+    return false;
+  }
+
+  if ((process.env.NO_COLOR ?? "").trim().length > 0) {
+    return false;
+  }
+
+  return (process.env.TERM ?? "").toLowerCase() !== "dumb";
+}
+
+function hexToRgb(hex: string): { red: number; green: number; blue: number } {
+  const normalized = hex.replace(/^#/, "");
+  return {
+    red: Number.parseInt(normalized.slice(0, 2), 16),
+    green: Number.parseInt(normalized.slice(2, 4), 16),
+    blue: Number.parseInt(normalized.slice(4, 6), 16),
+  };
+}
+
+/**
+ * Applies one Minecraft-style truecolor swatch to a string.
+ *
+ * @param code The legacy Minecraft color code to emulate.
+ * @param value The text to colorize.
+ * @returns The styled string, or the original text when colors are disabled.
+ * @remarks This uses truecolor ANSI so the palette stays stable across modern terminals.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function mc(code: MinecraftColorCode, value: string): string {
+  if (!supportsCliColor()) {
+    return value;
+  }
+
+  const { red, green, blue } = hexToRgb(MINECRAFT_HEX[code]);
+  return `\u001b[38;2;${red};${green};${blue}m${value}\u001b[39m`;
+}
+
+/**
+ * Styles one primary CLI label.
+ *
+ * @param value The label text.
+ * @returns The highlighted label.
+ * @remarks Gold is used as the main CLI accent color.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function accent(value: string): string {
+  return mc("6", value);
+}
+
+/**
+ * Styles one positive/success string.
+ *
+ * @param value The text to colorize.
+ * @returns The success-colored string.
+ * @remarks Green is used for successful actions and positive counts.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function success(value: string): string {
+  return mc("a", value);
+}
+
+/**
+ * Styles one informational string.
+ *
+ * @param value The text to colorize.
+ * @returns The info-colored string.
+ * @remarks Aqua is used for list metadata and secondary highlights.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function info(value: string): string {
+  return mc("b", value);
+}
+
+/**
+ * Styles one warning string.
+ *
+ * @param value The text to colorize.
+ * @returns The warning-colored string.
+ * @remarks Bright yellow is used for cautionary or count summary output.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function warning(value: string): string {
+  return mc("e", value);
+}
+
+/**
+ * Styles one muted metadata string.
+ *
+ * @param value The text to colorize.
+ * @returns The muted string.
+ * @remarks Gray is used for low-emphasis metadata like slugs and file paths.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function muted(value: string): string {
+  return mc("7", value);
+}
+
+/**
+ * Styles one subtle low-contrast string.
+ *
+ * @param value The text to colorize.
+ * @returns The subtle string.
+ * @remarks Dark gray is used for separators, labels, and empty-state output.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function subtle(value: string): string {
+  return mc("8", value);
+}
+
+/**
+ * Styles one failure/error string.
+ *
+ * @param value The text to colorize.
+ * @returns The danger-colored string.
+ * @remarks Red is reserved for errors and destructive outcomes.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function danger(value: string): string {
+  return mc("c", value);
+}
+
+/**
+ * Styles one prominent value with bold emphasis.
+ *
+ * @param value The text to emphasize.
+ * @returns The bold string.
+ * @remarks This intentionally leaves color choice to the caller.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export function strong(value: string): string {
+  return pc.bold(value);
+}