codex-copilot-dx 0.6.6 → 0.6.8

package/README.md

@@ -37,6 +37,10 @@ breaking release. For a one-off run without a global install, use
 `npm exec --yes --package=codex-copilot-dx@latest -- ccdx`.
 Run `ccdx <command> --help` (including `auth login claude --help` and
 `pms status --help`) for command-specific behavior and side-effect details.
+The read-only `usage`, `models`, `auth status`, and `pms status` commands use
+aligned tables in interactive terminals. Redirected or piped output keeps the
+legacy plain-text layout for script compatibility; use `--format table` or
+`--format plain` to choose explicitly.
 
 To query the models currently advertised as selectable for the saved Codex
 Copilot account, run:
@@ -47,7 +51,8 @@ ccdx models
 
 This performs a fresh, read-only GitHub Copilot model-directory lookup without
 starting the adapter, opening device login, reading the local model cache, or
-consuming an inference request. It lists model IDs by provider with their
+consuming an inference request. It lists model IDs in a provider, API, and
+preview-status table with their
 advertised API capabilities and reports the live Claude/Anthropic count. A model
 being advertised does not guarantee that a later inference request will avoid
 quota, rate-limit, or policy enforcement.
@@ -111,9 +116,11 @@ active account or profile. GPT requests continue to use the bearer supplied by
 the current PM profile; exact enabled Anthropic model IDs use the isolated
 CCDX Claude profile. Neither credential is copied into the other application.
 
-The current patch recipe supports only an exact, unmodified PM Studio 2.9.7 bundle on
-macOS. Authorize the isolated Claude profile first, quit PM Studio and its
-updater, then run the one-time setup command:
+The current patch recipes support only the exact, unmodified PM Studio 2.9.7
+and 2.9.10 bundles on macOS. This is exact-version support, not a version range:
+2.9.11 and other unknown builds remain unsupported until they receive their own
+verified recipe. Authorize the isolated Claude profile first, quit PM Studio
+and its updater, then run the one-time setup command:
 
 ```bash
 ccdx auth login claude --reauth --github-login <personal-github-login>
@@ -140,22 +147,31 @@ does not attempt a second automatic write: it preserves the verified backup,
 retains any diagnostic stage still present, and prints recovery paths. Repeating
 setup for the exact installed recipe is idempotent.
 
+The official 2.9.10 artifact can fail macOS's vendor-signature verifier even
+though its signing metadata remains readable. CCDX does not generally ignore
+that failure: the 2.9.10 exception is accepted only when the complete App tree,
+including every file, mode, symlink, and non-volatile extended attribute,
+matches the frozen official fingerprint. The staged and installed CCDX patch
+must still pass strict ad-hoc signature verification and match the complete
+patched-tree record in the backup manifest.
+
 The patch is App-wide: every PM profile sends its Copilot API traffic through
 the loopback-only `/pm-ccdx/*` relay. Run ordinary `ccdx` before opening PM
 Studio; if port 2026 is unavailable, PM Copilot requests cannot connect. The
-relay explicitly supports only the PM 2.9.7 Copilot paths discovered in the
-validated bundle (`GET /models` and `POST /chat/completions`, `/responses`, and
+relay explicitly supports only the Copilot paths discovered in the validated
+2.9.7 and 2.9.10 bundles (`GET /models` and `POST /chat/completions`, `/responses`, and
 `/embeddings`) and is not a general-purpose proxy.
 
 Patching replaces the vendor signature with an ad-hoc signature. PM Studio's
 updater is not disabled; an official update may overwrite the patch or may
 require reinstalling the official App. Setup prints the verified backup and
 manifest paths plus the version-matched restore procedure. Never restore a
-2.9.7 backup over a newer PM Studio installation.
+backup over a different PM Studio version or build.
 
 To restore, first quit PM Studio and its updater. Use the exact verified backup
 path printed by setup as `BACKUP_APP`, then confirm that both the installed App
-and backup still report version/build `2.9.7/2.9.7`:
+and backup still report the same version/build printed by setup (`2.9.7/2.9.7`
+or `2.9.10/2.9.10`):
 
 ```bash
 BACKUP_APP="<verified-backup-path-from-ccdx-pms-setup>"
@@ -165,8 +181,8 @@ BACKUP_APP="<verified-backup-path-from-ccdx-pms-setup>"
 /usr/bin/plutil -extract CFBundleVersion raw -o - "$BACKUP_APP/Contents/Info.plist"
 ```
 
-Only when all four values match `2.9.7`, move the patched App aside, restore the
-complete vendor-signed backup, and verify it before launch:
+Only when all four values match the one exact recipe, move the patched App
+aside, restore the complete vendor bundle, and verify it before launch:
 
 ```bash
 RECOVERY_DIR="$(/usr/bin/mktemp -d '/Applications/CCDX-PM-Studio-recovery.XXXXXX')"
@@ -174,12 +190,16 @@ PATCHED_APP="$RECOVERY_DIR/PM Studio.app"
 mv "/Applications/PM Studio.app" "$PATCHED_APP"
 /usr/bin/ditto --rsrc --extattr --acl "$BACKUP_APP" "/Applications/PM Studio.app"
 /usr/bin/codesign --verify --deep --strict --verbose=2 "/Applications/PM Studio.app"
+ccdx pms status
 ```
 
-If the version check, copy, or signature verification fails, do not launch the
-restored App. Keep the moved patched bundle at `$PATCHED_APP` and reinstall the official PM Studio
-instead of applying a 2.9.7 backup to unknown content. CCDX never runs these
-restore commands or `sudo` automatically.
+For 2.9.10, the vendor `codesign` command may report the documented upstream
+signature failure; in that case the App-patch row from `ccdx pms status` must
+still classify the restored bundle as exact supported clean content rather than
+integrity drift. If the version check, copy, or both verification paths fail,
+do not launch the restored App. Keep the moved patched bundle at `$PATCHED_APP`
+and reinstall the official PM Studio instead of applying a version-mismatched
+backup. CCDX never runs these restore commands or `sudo` automatically.
 
 To change the model used by Codex Auto-review, run:
 
@@ -384,6 +404,10 @@ The adapter records token usage metadata to `~/.local/share/codex-copilot-dx/usa
 ccdx usage
 ```
 
+The summary covers the retained current usage log and its single rotated
+backup, not an unbounded lifetime history. Its table reports recorded usage
+responses and per-model input, cache-read, output, and total token metadata.
+
 ### Debug logging
 
 Set `CCDX_LOG_PATH=1` to mirror terminal logs to `~/.local/share/codex-copilot-dx/debug.log`, or set `CCDX_LOG_PATH` to a custom file. Add `CCDX_LOG_LEVEL=debug` to include upstream request attempts, retry causes, status codes, and timings. Debug logs do not include prompts, completions, request bodies, or authorization tokens.

package/bin/cli.mjs

@@ -47,7 +47,10 @@ if (CLI.command === "version") {
   process.exit(0);
 }
 if (CLI.command === "usage") {
-  await printUsageSummary();
+  await printUsageSummary({
+    format: CLI.outputFormat || "auto",
+    output: process.stdout,
+  });
   process.exit(0);
 }
 if (CLI.command === "auth") {
@@ -59,6 +62,8 @@ if (CLI.command === "auth") {
       reauth: CLI.reauth,
       expectedLogin: CLI.expectedLogin,
       commandName: CLI_NAME,
+      format: CLI.outputFormat || "auto",
+      output: process.stdout,
     });
     if (result.output) console.log(result.output);
     if (result.action === "login") {
@@ -97,7 +102,11 @@ if (CLI.command === "status") {
 if (CLI.command === "models") {
   try {
     const catalog = await fetchLiveCopilotModels({ profile: CLI.profile });
-    console.log(formatLiveCopilotModels(catalog, { commandName: CLI_NAME }));
+    console.log(formatLiveCopilotModels(catalog, {
+      commandName: CLI_NAME,
+      format: CLI.outputFormat || "auto",
+      output: process.stdout,
+    }));
     process.exit(0);
   } catch (e) {
     console.error(status("err", e.message));
@@ -127,7 +136,11 @@ if (CLI.command === "pms") {
   try {
     if (CLI.action === "status") {
       const { runPmStudioStatus } = await import("../src/pm-studio-status.mjs");
-      const result = await runPmStudioStatus({ commandName: CLI_NAME });
+      const result = await runPmStudioStatus({
+        commandName: CLI_NAME,
+        format: CLI.outputFormat || "auto",
+        output: process.stdout,
+      });
       process.exit(result.ok ? 0 : 1);
     }
     const { runPmStudioSetup } = await import("../src/pm-studio-setup.mjs");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-copilot-dx",
-  "version": "0.6.6",
+  "version": "0.6.8",
   "description": "Use Codex Desktop, Claude Code, and Claude App with GitHub Copilot",
   "author": "Dale Xiao",
   "type": "module",

package/src/cli-auth.mjs

@@ -24,6 +24,12 @@ import { saveModelCache } from "./model-cache.mjs";
 import { isClaudeCopilotModel } from "./models.mjs";
 import { profileRouting } from "./profile-routing.mjs";
 import { status } from "./status.mjs";
+import {
+  cliOutputFormat,
+  cliOutputWidth,
+  formatResponsiveCliTable,
+  terminalCell,
+} from "./cli-table.mjs";
 
 const CLIENT_ID = "Iv1.b507a08c87ecfe98";
 const SCOPE = "read:user";
@@ -479,7 +485,7 @@ function onlineStatusLine(name, profile) {
   return status("ok", `${name} online: ${account}${online.models} models, ${online.claudeModels} Claude`);
 }
 
-export function formatAuthStatus(snapshot = authStatus(), { commandName = "ccdx" } = {}) {
+function authStatusPlainLines(snapshot, { commandName }) {
   const claudeLabel = snapshot.profiles.claude.configured
     ? `${accountLabel(snapshot.profiles.claude)} [isolated profile]`
     : "inherits Codex [no isolated profile]";
@@ -493,7 +499,95 @@ export function formatAuthStatus(snapshot = authStatus(), { commandName = "ccdx"
     status(claudeKind, `Claude: ${claudeLabel}`),
     onlineStatusLine("Claude", snapshot.profiles.claude),
     status("info", `Routing: responses -> ${snapshot.routing.responses}; messages -> ${snapshot.routing.messages}`),
-  ].filter(Boolean).join("\n");
+  ].filter(Boolean);
+}
+
+function authTableOnline(profile) {
+  const online = profile.online;
+  if (!online) return { state: "[INFO] not checked", models: "—", claudeModels: "—" };
+  if (online.inherited) return { state: "[INFO] inherits Codex", models: "—", claudeModels: "—" };
+  if (!online.ok) {
+    const httpStatus = online.httpStatus ? ` (HTTP ${online.httpStatus})` : "";
+    return {
+      state: `[WARN] ${online.reason || "unavailable"}${httpStatus}`,
+      models: "—",
+      claudeModels: "—",
+    };
+  }
+  return {
+    state: `[OK] verified${online.login ? ` as ${online.login}` : ""}`,
+    models: Number.isFinite(online.models) ? String(online.models) : "—",
+    claudeModels: Number.isFinite(online.claudeModels) ? String(online.claudeModels) : "—",
+  };
+}
+
+function authTableRow(name, profile, { claude = false } = {}) {
+  const inherited = claude && !profile.configured;
+  const online = authTableOnline(profile);
+  const local = inherited
+    ? "[INFO] inherits Codex"
+    : profile.valid
+      ? "[OK] ready"
+      : `[WARN] ${accountLabel(profile)}`;
+  const account = inherited ? "inherits Codex" : accountLabel(profile);
+  const mode = inherited ? "inherited" : claude ? "isolated" : "legacy path";
+  return {
+    profile: name,
+    account,
+    mode,
+    local,
+    online: online.state,
+    models: online.models,
+    claudeModels: online.claudeModels,
+  };
+}
+
+export function formatAuthStatus(snapshot = authStatus(), {
+  commandName = "ccdx",
+  format = "plain",
+  output = process.stdout,
+  width = cliOutputWidth(output),
+} = {}) {
+  const plainLines = authStatusPlainLines(snapshot, { commandName });
+  if (cliOutputFormat(format, output) === "plain") {
+    return plainLines.join("\n");
+  }
+
+  const rows = [
+    authTableRow("Codex", snapshot.profiles.codex),
+    authTableRow("Claude", snapshot.profiles.claude, { claude: true }),
+  ];
+  const table = formatResponsiveCliTable({
+    columns: [
+      { key: "profile", label: "PROFILE" },
+      { key: "account", label: "ACCOUNT" },
+      { key: "mode", label: "MODE" },
+      { key: "local", label: "LOCAL" },
+      { key: "online", label: "ONLINE" },
+      { key: "models", label: "MODELS", align: "right" },
+      { key: "claudeModels", label: "CLAUDE", align: "right" },
+    ],
+    compactColumns: [
+      { key: "profile", label: "PROFILE" },
+      { key: "local", label: "LOCAL" },
+      { key: "online", label: "ONLINE" },
+    ],
+    rows,
+    width,
+  });
+  if (format === "auto" && table.overflow) {
+    return plainLines.map((line) => terminalCell(line, { fallback: "" })).join("\n");
+  }
+  const lines = [
+    `${commandName} auth status`,
+    "",
+    table.output,
+  ];
+  if (table.compact) {
+    lines.push("", "Details:", ...plainLines.slice(1, -1).map((line) => terminalCell(line, { fallback: "" })));
+  }
+  lines.push(terminalCell(plainLines.at(-1), { fallback: "" }));
+  return lines.join("\n");
 }
 
 export async function runAuthCommand({
@@ -503,11 +597,13 @@ export async function runAuthCommand({
   reauth = false,
   expectedLogin = "",
   commandName = "ccdx",
+  format = "plain",
+  output = process.stdout,
   ...options
 } = {}) {
   if (action === "status") {
     const snapshot = online ? await authStatusOnline(options) : authStatus(options);
-    return { action, output: formatAuthStatus(snapshot, { commandName }), snapshot };
+    return { action, output: formatAuthStatus(snapshot, { commandName, format, output }), snapshot };
   }
   if (profile !== AUTH_PROFILE_CLAUDE) throw new Error("Only the isolated Claude profile can be changed by this command");
   if (action === "login") return { action, ...(await authorizeClaudeProfile({ ...options, reauth, expectedLogin })) };

package/src/cli-models.mjs

@@ -11,6 +11,12 @@ import {
   isClaudeCopilotModel,
 } from "./models.mjs";
 import { status } from "./status.mjs";
+import {
+  cliOutputFormat,
+  cliOutputWidth,
+  formatResponsiveCliTable,
+  terminalCell,
+} from "./cli-table.mjs";
 
 const DEFAULT_MODELS_TIMEOUT_MS = 10000;
 const SUPPORTED_ENDPOINTS = [
@@ -166,21 +172,22 @@ export async function fetchLiveCopilotModels({
   }
 }
 
-export function formatLiveCopilotModels(catalog, { commandName = "ccdx" } = {}) {
-  const models = Array.isArray(catalog?.models) ? catalog.models : [];
-  const profile = catalog?.profile === AUTH_PROFILE_CLAUDE ? AUTH_PROFILE_CLAUDE : AUTH_PROFILE_CODEX;
+function liveCatalogHeader(catalog, { commandName, profile, models }) {
   const responses = models.filter((model) => model.endpoints.includes("responses")).length;
   const chat = models.filter((model) => model.endpoints.includes("chat")).length;
   const claude = models.filter(isClaudeCopilotCatalogEntry).length;
-  const lines = [
+  return [
     `${commandName} models${profile === AUTH_PROFILE_CLAUDE ? " --profile claude" : ""}`,
     status("ok", `Live catalog from ${safeText(catalog?.upstreamHost, "GitHub Copilot")}: ${models.length} selectable of ${Number(catalog?.advertised) || 0} advertised`),
     status("info", `Responses: ${responses}; Chat: ${chat}; Claude/Anthropic: ${claude}`),
   ];
+}
 
+function formatLiveCopilotModelsPlain(catalog, { commandName, profile, models }, { sanitize = false } = {}) {
+  const lines = liveCatalogHeader(catalog, { commandName, profile, models });
   if (!models.length) {
     lines.push(status("warn", "No selectable models were advertised for this account"));
-    return lines.join("\n");
+    return (sanitize ? lines.map((line) => terminalCell(line, { fallback: "" })) : lines).join("\n");
   }
 
   let vendor = "";
@@ -192,5 +199,53 @@ export function formatLiveCopilotModels(catalog, { commandName = "ccdx" } = {})
     const flags = [...model.endpoints, ...(model.preview ? ["preview"] : [])];
     lines.push(`  ${model.id} [${flags.join(", ")}]`);
   }
+  return (sanitize ? lines.map((line) => terminalCell(line, { fallback: "" })) : lines).join("\n");
+}
+
+export function formatLiveCopilotModels(catalog, {
+  commandName = "ccdx",
+  format = "plain",
+  output = process.stdout,
+  width = cliOutputWidth(output),
+} = {}) {
+  const models = Array.isArray(catalog?.models) ? catalog.models : [];
+  const profile = catalog?.profile === AUTH_PROFILE_CLAUDE ? AUTH_PROFILE_CLAUDE : AUTH_PROFILE_CODEX;
+  const context = { commandName, profile, models };
+  if (cliOutputFormat(format, output) === "plain") {
+    return formatLiveCopilotModelsPlain(catalog, context);
+  }
+
+  const lines = liveCatalogHeader(catalog, context);
+  if (!models.length) {
+    lines.push(status("warn", "No selectable models were advertised for this account"));
+    return lines.join("\n");
+  }
+
+  const rows = models.map((model) => ({
+    vendor: model.vendor,
+    model: model.id,
+    vendorModel: `${model.vendor}/${model.id}`,
+    apis: model.endpoints.join(", "),
+    preview: model.preview ? "yes" : "no",
+  }));
+  const table = formatResponsiveCliTable({
+    columns: [
+      { key: "vendor", label: "VENDOR" },
+      { key: "model", label: "MODEL" },
+      { key: "apis", label: "APIS" },
+      { key: "preview", label: "PREVIEW" },
+    ],
+    compactColumns: [
+      { key: "vendorModel", label: "VENDOR/MODEL" },
+      { key: "apis", label: "APIS" },
+      { key: "preview", label: "PREVIEW" },
+    ],
+    rows,
+    width,
+  });
+  if (format === "auto" && table.overflow) {
+    return formatLiveCopilotModelsPlain(catalog, context, { sanitize: true });
+  }
+  lines.push("", table.output);
   return lines.join("\n");
 }

package/src/cli-options.mjs

@@ -60,6 +60,18 @@ function checkedProfile(value, { allowAll = false } = {}) {
   return profile;
 }
 
+function checkedOutputFormat(value) {
+  const format = value || "";
+  if (!new Set(["table", "plain"]).has(format)) {
+    throw new Error(`Format must be table or plain: ${value}`);
+  }
+  return format;
+}
+
+function outputFormatOption(value) {
+  return value ? { outputFormat: checkedOutputFormat(value) } : {};
+}
+
 function baseCommand(command, extra = {}) {
   return {
     command,
@@ -137,28 +149,42 @@ export function parseCliArgs(args = []) {
     return baseCommand("status");
   }
   if (command === "usage") {
-    if (rest.length) unexpectedArgs(rest);
-    return baseCommand("usage");
+    const options = parseOptions(rest, new Map([["--format", "value"]]));
+    return baseCommand("usage", outputFormatOption(options["--format"]));
   }
   if (PM_COMMANDS.has(command)) {
     const [action, ...pmsArgs] = rest;
     if (!action) throw new Error("Missing pms action: expected setup or status");
     if (!new Set(["setup", "status"]).has(action)) throw new Error(`Unknown pms action: ${action}`);
-    if (pmsArgs.length) unexpectedArgs(pmsArgs);
-    return baseCommand("pms", { action });
+    if (action === "setup") {
+      if (pmsArgs.length) unexpectedArgs(pmsArgs);
+      return baseCommand("pms", { action });
+    }
+    const options = parseOptions(pmsArgs, new Map([["--format", "value"]]));
+    return baseCommand("pms", {
+      action,
+      ...outputFormatOption(options["--format"]),
+    });
   }
   if (command === "models") {
-    const options = parseOptions(rest, new Map([["--profile", "value"]]));
+    const options = parseOptions(rest, new Map([
+      ["--profile", "value"],
+      ["--format", "value"],
+    ]));
     return {
       ...baseCommand("models"),
       profile: checkedProfile(options["--profile"]),
+      ...outputFormatOption(options["--format"]),
     };
   }
   if (command === "auth") {
     const [action, ...authArgs] = rest;
     if (!action) throw new Error("Missing auth action: expected status or login");
     if (action === "status") {
-      const options = parseOptions(authArgs, new Map([["--online", "flag"]]));
+      const options = parseOptions(authArgs, new Map([
+        ["--online", "flag"],
+        ["--format", "value"],
+      ]));
       return {
         ...baseCommand("auth"),
         action: "status",
@@ -166,6 +192,7 @@ export function parseCliArgs(args = []) {
         online: Boolean(options["--online"]),
         expectedLogin: "",
         reauth: false,
+        ...outputFormatOption(options["--format"]),
       };
     }
     if (action === "login") {
@@ -259,16 +286,16 @@ export function cliCommandName() {
 function topicHelp(name, topic) {
   const sections = {
     start: `Usage:\n  ${name} [start] [--configure-claude-app] [--show-request-id]\n\nStarts or reuses the local adapter, updates Codex and Claude Code configuration, and attempts to open Codex or ChatGPT when auto-launch is enabled and supported.\n--configure-claude-app also creates or updates the managed Claude App gateway profile.`,
-    auth: `Usage:\n  ${name} auth status [--online]\n  ${name} auth login claude [--github-login <login>] [--reauth]\n\nShows the two account profiles or configures the isolated Claude account. Device login starts only when no reusable local Copilot credential is available or --reauth is used.`,
-    "auth status": `Usage:\n  ${name} auth status [--online]\n\nShows account routing without exposing credentials. --online also verifies both configured Copilot entitlements and model catalogs.`,
+    auth: `Usage:\n  ${name} auth status [--online] [--format table|plain]\n  ${name} auth login claude [--github-login <login>] [--reauth]\n\nShows the two account profiles or configures the isolated Claude account. Device login starts only when no reusable local Copilot credential is available or --reauth is used.`,
+    "auth status": `Usage:\n  ${name} auth status [--online] [--format table|plain]\n\nShows account routing without exposing credentials. --online also verifies both configured Copilot entitlements and model catalogs. Interactive terminals use a table by default.`,
     "auth login": `Usage:\n  ${name} auth login claude [--github-login <login>] [--reauth]\n\nReuses a compatible local Copilot credential when possible. --reauth forces GitHub Device Flow.`,
     doctor: `Usage:\n  ${name} doctor [--online] [--compat] [--profile codex|claude|all]\n\nChecks local credentials, client configuration, PM Studio state, and the adapter. --online validates account entitlement; --compat sends minimal inference requests and consumes a small amount of Copilot usage.`,
     status: `Usage:\n  ${name} status\n\nShows bounded runtime, routing, performance, cache, queue, and PM relay metrics from a running adapter.`,
-    models: `Usage:\n  ${name} models [--profile codex|claude]\n\nPerforms a fresh, read-only Copilot model-directory lookup for one saved profile.`,
-    pms: `Usage:\n  ${name} pms status\n  ${name} pms setup\n  ${name} pm-studio status\n  ${name} pm-studio setup\n\nInspects or installs the version-locked PM Studio loopback patch. setup modifies the installed app only after all preflight checks pass.`,
+    models: `Usage:\n  ${name} models [--profile codex|claude] [--format table|plain]\n\nPerforms a fresh, read-only Copilot model-directory lookup for one saved profile. Interactive terminals use a table by default.`,
+    pms: `Usage:\n  ${name} pms status [--format table|plain]\n  ${name} pms setup\n  ${name} pm-studio status [--format table|plain]\n  ${name} pm-studio setup\n\nInspects or installs the version-locked PM Studio loopback patch. setup modifies the installed app only after all preflight checks pass.`,
     "pms setup": `Usage:\n  ${name} pms setup\n\nBacks up, patches, verifies, and ad-hoc signs an exactly supported PM Studio bundle. Unknown versions and drift are never modified.`,
-    "pms status": `Usage:\n  ${name} pms status\n\nRead-only inspection of the installed PM Studio version, patch integrity, Claude profile, and relay availability.`,
-    usage: `Usage:\n  ${name} usage\n\nSummarizes local token usage metadata without reading prompt or completion content.`,
+    "pms status": `Usage:\n  ${name} pms status [--format table|plain]\n\nRead-only inspection of the installed PM Studio version, patch integrity, Claude profile, and relay availability. Interactive terminals use a table by default.`,
+    usage: `Usage:\n  ${name} usage [--format table|plain]\n\nSummarizes local token usage metadata without reading prompt or completion content. Interactive terminals use a table by default.`,
     "auto-review-model": `Usage:\n  ${name} auto-review-model\n\nInteractively selects an enabled Responses model for Codex Auto-review.`,
     update: `Usage:\n  ${name} update [npm|github]\n\nUpdates the global package from the configured npm registry or GitHub main. With no source, an interactive terminal prompts for one.`,
     version: `Usage:\n  ${name} --version`,
@@ -282,14 +309,14 @@ export function cliHelp(commandName = "ccdx", topic = "") {
   if (normalizedTopic) return topicHelp(name, normalizedTopic);
   return `Usage:
   ${name} [start] [--configure-claude-app] [--show-request-id]
-  ${name} auth status [--online]
+  ${name} auth status [--online] [--format table|plain]
   ${name} auth login claude [--github-login <login>] [--reauth]
   ${name} doctor [--online] [--compat] [--profile codex|claude|all]
   ${name} status
-  ${name} models [--profile codex|claude]
-  ${name} pms status
+  ${name} models [--profile codex|claude] [--format table|plain]
+  ${name} pms status [--format table|plain]
   ${name} pms setup
-  ${name} usage
+  ${name} usage [--format table|plain]
   ${name} auto-review-model
   ${name} update [npm|github]
   ${name} --version

package/src/cli-table.mjs

@@ -0,0 +1,114 @@
+import { stripVTControlCharacters } from "node:util";
+
+const DEFAULT_TERMINAL_COLUMNS = 120;
+const COMBINING_MARK = /\p{Mark}/u;
+const EMOJI = /\p{Extended_Pictographic}|\p{Regional_Indicator}/u;
+const SIMPLE_WIDTH = /^[\u0020-\u007e\u2014]*$/;
+let graphemeSegmenter;
+
+function wideCodePoint(codePoint) {
+  return codePoint >= 0x1100 && (
+    codePoint <= 0x115f
+    || codePoint === 0x2329
+    || codePoint === 0x232a
+    || (codePoint >= 0x2e80 && codePoint <= 0xa4cf && codePoint !== 0x303f)
+    || (codePoint >= 0xac00 && codePoint <= 0xd7a3)
+    || (codePoint >= 0xf900 && codePoint <= 0xfaff)
+    || (codePoint >= 0xfe10 && codePoint <= 0xfe19)
+    || (codePoint >= 0xfe30 && codePoint <= 0xfe6f)
+    || (codePoint >= 0xff00 && codePoint <= 0xff60)
+    || (codePoint >= 0xffe0 && codePoint <= 0xffe6)
+    || (codePoint >= 0x20000 && codePoint <= 0x3fffd)
+  );
+}
+
+function graphemeWidth(segment) {
+  if (EMOJI.test(segment)) return 2;
+  let width = 0;
+  for (const character of segment) {
+    const codePoint = character.codePointAt(0);
+    if (codePoint === 0x200d || (codePoint >= 0xfe00 && codePoint <= 0xfe0f) || COMBINING_MARK.test(character)) continue;
+    width += wideCodePoint(codePoint) ? 2 : 1;
+  }
+  return width;
+}
+
+function displayWidth(value) {
+  if (SIMPLE_WIDTH.test(value)) return value.length;
+  graphemeSegmenter ||= new Intl.Segmenter("en", { granularity: "grapheme" });
+  let width = 0;
+  for (const { segment } of graphemeSegmenter.segment(value)) width += graphemeWidth(segment);
+  return width;
+}
+
+function padding(length) {
+  return length > 0 ? " ".repeat(length) : "";
+}
+
+function padded(value, width, align) {
+  const spaces = padding(width - displayWidth(value));
+  return align === "right" ? `${spaces}${value}` : `${value}${spaces}`;
+}
+
+export function terminalCell(value, { fallback = "—" } = {}) {
+  if (value === undefined || value === null) return fallback;
+  const text = stripVTControlCharacters(String(value))
+    .replace(/[\u0000-\u001f\u007f-\u009f]/g, " ")
+    .replace(/[\u061c\u200b\u200e\u200f\u202a-\u202e\u2060\u2066-\u2069\ufeff]/g, "")
+    .replace(/\s+/g, " ")
+    .trim();
+  return text || fallback;
+}
+
+export function cliOutputFormat(format = "auto", output = process.stdout) {
+  if (format === "table" || format === "plain") return format;
+  return output?.isTTY === true ? "table" : "plain";
+}
+
+export function cliOutputWidth(output = process.stdout) {
+  const columns = Number(output?.columns);
+  return Number.isSafeInteger(columns) && columns > 0 ? columns : DEFAULT_TERMINAL_COLUMNS;
+}
+
+export function formatCliTable({ columns, rows, gap = 2 }) {
+  const normalizedColumns = columns.map((column) => ({
+    ...column,
+    label: terminalCell(column.label, { fallback: "" }),
+  }));
+  const normalizedRows = rows.map((row) => Object.fromEntries(normalizedColumns.map((column) => [
+    column.key,
+    terminalCell(row[column.key]),
+  ])));
+  const widths = normalizedColumns.map((column) => Math.max(
+    displayWidth(column.label),
+    ...normalizedRows.map((row) => displayWidth(row[column.key])),
+  ));
+  const line = (values) => normalizedColumns
+    .map((column, index) => padded(values[column.key], widths[index], column.align))
+    .join(" ".repeat(gap))
+    .trimEnd();
+  const header = Object.fromEntries(normalizedColumns.map((column) => [column.key, column.label]));
+  const separator = Object.fromEntries(normalizedColumns.map((column, index) => [
+    column.key,
+    "-".repeat(widths[index]),
+  ]));
+  return [line(header), line(separator), ...normalizedRows.map(line)].join("\n");
+}
+
+export function cliTableWidth(table) {
+  return Math.max(0, ...String(table).split("\n").map(displayWidth));
+}
+
+export function formatResponsiveCliTable({ columns, compactColumns, rows, width = DEFAULT_TERMINAL_COLUMNS, gap = 2 }) {
+  const full = formatCliTable({ columns, rows, gap });
+  const fullWidth = cliTableWidth(full);
+  if (!compactColumns?.length || fullWidth <= width) {
+    return { output: full, compact: false, overflow: fullWidth > width };
+  }
+  const compact = formatCliTable({ columns: compactColumns, rows, gap });
+  return {
+    output: compact,
+    compact: true,
+    overflow: cliTableWidth(compact) > width,
+  };
+}