codex-copilot-dx 0.6.5 → 0.6.7

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.
@@ -120,8 +125,8 @@ ccdx auth login claude --reauth --github-login <personal-github-login>
 ccdx pms setup
 ```
 
-Inspect the installed version, exact patch integrity, isolated Claude profile,
-and relay without changing files:
+Inspect the installed version, exact patch manifest plus executable/signing
+integrity, isolated Claude profile, and live relay routing without changing files:
 
 ```bash
 ccdx pms status
@@ -384,6 +389,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");
@@ -316,6 +329,7 @@ try {
     codexModelRegistry: profileModels.codexRegistry,
     claudeModelRegistry: profileModels.claudeRegistry,
     claudeMode: profileRuntime.claudeMode,
+    isClaudeProfileCurrent: profileRuntime.isClaudeProfileCurrent,
     showRequestId: CLI.showRequestId,
     upstreamTimeoutMs: RUNTIME.upstreamTimeoutMs,
     streamHandshakeTimeoutMs: RUNTIME.streamHandshakeTimeoutMs,

package/package.json

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

package/scripts/benchmark.mjs

@@ -23,6 +23,14 @@ function runProbe(source) {
   return JSON.parse(result.stdout.trim());
 }
 
+function median(values) {
+  const ordered = [...values].sort((left, right) => left - right);
+  const middle = Math.floor(ordered.length / 2);
+  return ordered.length % 2 === 0
+    ? (ordered[middle - 1] + ordered[middle]) / 2
+    : ordered[middle];
+}
+
 function deterministicPixels(byteLength, initialSeed) {
   const pixels = Buffer.alloc(byteLength);
   let seed = initialSeed;
@@ -154,7 +162,7 @@ function largePayloadProbe(targetMiB, concurrency) {
 }
 
 function largeTokenCountProbe(mode) {
-  return runProbe(`
+  const samples = Array.from({ length: 3 }, () => runProbe(`
     const text = "a ".repeat(2 * 1024 * 1024);
     const started = performance.now();
     let tokens;
@@ -174,6 +182,51 @@ function largeTokenCountProbe(mode) {
       rss_mib: +(memory.rss / 1048576).toFixed(1),
       heap_used_mib: +(memory.heapUsed / 1048576).toFixed(1),
     }));
+  `));
+  return {
+    input_mib: samples[0].input_mib,
+    tokens: samples[0].tokens,
+    elapsed_ms: +median(samples.map((sample) => sample.elapsed_ms)).toFixed(1),
+    rss_mib: +median(samples.map((sample) => sample.rss_mib)).toFixed(1),
+    heap_used_mib: +median(samples.map((sample) => sample.heap_used_mib)).toFixed(1),
+    samples: samples.length,
+  };
+}
+
+function toolOutputParseCacheProbe() {
+  return runProbe(`
+    import { enforceResponsesImageLimit } from "./src/responses-image-limit.mjs";
+    import { responsesHistoricalImageStats } from "./src/responses-byte-budget.mjs";
+    import { prepareResponsesChatPayload } from "./src/responses-chat-payload.mjs";
+
+    const item = {
+      type: "function_call_output",
+      call_id: "call_benchmark",
+      output: JSON.stringify([{ type: "input_text", text: "x".repeat(8 * 1024 * 1024) }]),
+    };
+    const source = item.output;
+    const originalParse = JSON.parse;
+    let parseCalls = 0;
+    JSON.parse = function countedParse(value, ...args) {
+      if (value === source) parseCalls += 1;
+      return originalParse.call(this, value, ...args);
+    };
+    const started = performance.now();
+    try {
+      enforceResponsesImageLimit([item]);
+      responsesHistoricalImageStats([item], 1);
+      await prepareResponsesChatPayload({
+        body: { model: "gpt-4o", input: [item] },
+        currentInputStart: 1,
+      }, { payloadOptions: { maxBytes: 30 * 1024 * 1024 } });
+    } finally {
+      JSON.parse = originalParse;
+    }
+    process.stdout.write(JSON.stringify({
+      output_mib: +(Buffer.byteLength(source) / 1048576).toFixed(1),
+      parse_calls: parseCalls,
+      elapsed_ms: +(performance.now() - started).toFixed(1),
+    }));
   `);
 }
 
@@ -373,6 +426,7 @@ if (checkMode) {
     proxy: largeTokenCountProbe("proxy"),
     materialized_array: largeTokenCountProbe("array"),
   };
+  report.tool_output_parse_cache = toolOutputParseCacheProbe();
   report.large_payload_peak = [
     largePayloadProbe(5, 4),
     largePayloadProbe(30, 1),
@@ -409,6 +463,9 @@ if (checkMode) {
   if (proxy.heap_used_mib > array.heap_used_mib * 0.75) {
     failures.push(`token counter heap regression: proxy=${proxy.heap_used_mib}MiB array=${array.heap_used_mib}MiB`);
   }
+  if (report.tool_output_parse_cache.parse_calls !== 1) {
+    failures.push(`stringified tool output parsed ${report.tool_output_parse_cache.parse_calls} times instead of once`);
+  }
   for (const payload of report.large_payload_peak) {
     if (payload.admission_max_active_mib > payload.admission_budget_mib) {
       failures.push(`request admission exceeded its budget at ${payload.target_request_mib}MiB x${payload.concurrency}`);

package/src/adapter.mjs

@@ -215,6 +215,7 @@ export function createAdapterHandler(options = {}) {
         codexModelRegistry,
         claudeModelRegistry,
         claudeMode,
+        isClaudeProfileCurrent: options.isClaudeProfileCurrent,
       })));
       return;
     }

package/src/cli-auth.mjs

@@ -21,8 +21,15 @@ import {
   normalizeGithubIdentity,
 } from "./github-identity.mjs";
 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";
@@ -145,17 +152,7 @@ async function codexIdentity({ home, fetchImpl, signal }) {
 function claudeModels(payload) {
   const models = Array.isArray(payload) ? payload : payload?.data;
   if (!Array.isArray(models)) throw new Error("Claude account model catalog contained no model list");
-  return models.filter((model) => {
-    const id = String(model?.id || "").trim();
-    const vendor = String(model?.vendor || model?.owned_by || "").trim().toLowerCase();
-    const policy = String(model?.policy?.state || "").trim().toLowerCase();
-    const endpoints = Array.isArray(model?.supported_endpoints) ? model.supported_endpoints : [];
-    return Boolean(id)
-      && (id.toLowerCase().startsWith("claude-") || vendor === "anthropic")
-      && model?.model_picker_enabled === true
-      && (!policy || policy === "enabled")
-      && (endpoints.includes("/chat/completions") || endpoints.includes("/v1/messages"));
-  });
+  return models.filter(isClaudeCopilotModel);
 }
 
 function catalogModels(payload) {
@@ -488,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]";
@@ -502,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({
@@ -512,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

@@ -6,7 +6,17 @@ import {
   readAuthProfileCredentials,
 } from "./auth-profile.mjs";
 import { buildHeaders, DEFAULT_API_BASE, FALLBACK_VSCODE_VERSION } from "./copilot.mjs";
+import {
+  isClaudeCopilotCatalogEntry,
+  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 = [
@@ -37,11 +47,15 @@ export function selectableCopilotModels(payload) {
   const models = [];
   const seen = new Set();
   for (const model of data) {
-    if (model?.model_picker_enabled !== true) continue;
-    const policyState = safeText(model?.policy?.state).toLowerCase();
-    if (policyState && policyState !== "enabled") continue;
-    const capabilityType = safeText(model?.capabilities?.type).toLowerCase();
-    if (capabilityType && capabilityType !== "chat") continue;
+    if (isClaudeCopilotCatalogEntry(model)) {
+      if (!isClaudeCopilotModel(model)) continue;
+    } else {
+      if (model?.model_picker_enabled !== true) continue;
+      const policyState = safeText(model?.policy?.state).toLowerCase();
+      if (policyState && policyState !== "enabled") continue;
+      const capabilityType = safeText(model?.capabilities?.type).toLowerCase();
+      if (capabilityType && capabilityType !== "chat") continue;
+    }
 
     const id = safeText(model?.id);
     const endpoints = endpointLabels(model);
@@ -158,22 +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((model) => model.id.toLowerCase().startsWith("claude-")
-    || model.vendor.toLowerCase() === "anthropic").length;
-  const lines = [
+  const claude = models.filter(isClaudeCopilotCatalogEntry).length;
+  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 = "";
@@ -185,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