@codexapi/codexclaude 2.0.22 → 2.0.24

package/CUSTOMIZATIONS.md

@@ -1,13 +1,14 @@
-# Magnetapi Client Customizations
+# MagnetAPI.org Codex CLI Customizations
 
-`codexclaude` tracks the managed coding runtime while keeping a thin Magnetapi Client launcher layer. Future upgrades must preserve this file's behavior before a package is published.
+`codexclaude` tracks the managed coding runtime while keeping a thin MagnetAPI.org Codex CLI launcher layer. Future upgrades must preserve this file's behavior before a package is published.
 
 ## Runtime
 
-- Customer-facing app name: `Magnetapi Client`
-- Local launcher version: `2.0.22`
-- Bundled official runtime dependency: `@openai/codex@0.144.3`
-- Required install command: `npm install -g https://codexapi.pro/downloads/codexapi-codexclaude-2.0.22.tgz`
+- Customer-facing app name: `MagnetAPI.org Codex CLI`
+- Local launcher version: `2.0.24`
+- Bundled official runtime dependency: `@openai/codex@0.144.4`
+- Required install command: `npm install -g @codexapi/codexclaude@latest`
+- Hosted fallback: `npm install -g https://codexapi.pro/downloads/codexapi-codexclaude-2.0.24.tgz`
 - Bundled runtime version is managed internally and must not be used for customer update prompts.
 - Launcher update checks may call the CodexAPI.pro version endpoint and `@codexapi/codexclaude` npm metadata only.
 - The launcher must never check `@openai/codex` npm metadata or OpenAI GitHub releases for update notices.
@@ -19,12 +20,13 @@
 - Rewrites `~/.codex/config.toml` before every launch.
 - Deletes stale `~/.codex/version.json` before writing managed config.
 - Launches the bundled platform-native runtime binary directly rather than the upstream npm wrapper.
-- Keeps launcher-owned output branded as `Magnetapi Client`; hardcoded native binary strings require a forked native runtime build if operations wants them removed across all platforms.
+- Keeps launcher-owned output branded as `MagnetAPI.org Codex CLI`; hardcoded native binary strings require a forked native runtime build if operations wants them removed across all platforms.
 - Starts with `--search` by default.
 - Passes unknown commands directly to the bundled runtime after config is applied.
 - Provides `codexclaude changelog` using the managed version endpoint.
 - Does not expose separate `codexclaude status` or `codexclaude usage` commands; wallet information remains a compact pre-launch line.
-- Version `2.0.22` is forced by the backend minimum version and older clients must show an update-required message.
+- Version `2.0.24` is forced by the backend minimum version and older clients must show an update-required message.
+- Mandatory updates present `Upgrade Now` in an interactive terminal, invoke npm with an argument array and no shell interpolation, then stop cleanly so the customer can start `codexclaude` again.
 
 ## Provider Config
 
@@ -51,8 +53,8 @@ The launcher writes a model provider named `codexapi`:
 - Local model catalog: `~/.codexclaude/model_catalog.json`; this keeps the native `/model` picker limited to the supported choices and prevents fallback metadata warnings for GPT-5.6 SOL, SOL Max, SOL Ultra, Opus 4.8, Sonnet 5, and Fable 5.
 - Service tier: omitted by default; `/fast` remains user-controlled and billed server-side when active.
 - TUI status line: `model-with-reasoning`, `fast-mode`, `current-dir`
-- Fable 5 stays visible to the user while the backend applies its custom routed premium path and billing multiplier.
-- GPT-5.6 SOL Max bills at 2x normal SOL usage. GPT-5.6 SOL Ultra bills at 2.5x normal SOL usage.
+- Fable 5 stays visible to the user while the backend applies its server-managed route and billing policy.
+- Premium model billing remains server-managed and is not rendered in the customer model picker or model descriptions.
 
 ## Wallet Display
 
@@ -61,7 +63,7 @@ Before launching the runtime, the launcher calls `/api/v1/wallet/status`, then `
 Expected status line:
 
 ```text
-Magnetapi Client v2.0.22 · gpt-5.6 xhigh · ~/project · Wallet $20.00
+MagnetAPI.org Codex CLI v2.0.24 · gpt-5.6 xhigh · ~/project · Wallet $20.00
 ```
 
 ## Upgrade Checklist
@@ -71,7 +73,7 @@ When updating the bundled runtime:
 1. Update `CODEX_VERSION` in `bin/codexclaude.js`.
 2. Update `@openai/codex` in `package.json` and `package-lock.json`.
 3. Bump the launcher package version.
-4. Keep `APP_DISPLAY_NAME = "Magnetapi Client"`.
+4. Keep `APP_DISPLAY_NAME = "MagnetAPI.org Codex CLI"`.
 5. Keep `DEFAULT_MODEL_ID = "gpt-5.6"`.
 6. Keep `reasoningEffortForModel()` and model-specific visible reasoning.
 7. Keep Full Access defaults: `approval_policy = "never"` and `sandbox_mode = "danger-full-access"`.
@@ -79,7 +81,8 @@ When updating the bundled runtime:
 9. Keep `clearUpstreamUpdateCache()` deleting `~/.codex/version.json`.
 10. Keep direct platform binary launch and do not fall back to the upstream npm wrapper.
 11. Keep update checks limited to `/api/v1/codexclaude/version` and `@codexapi/codexclaude` npm metadata.
-12. Keep the managed `MODELS` map and local model catalog, including SOL Max and SOL Ultra.
-13. Keep bearer username auth and the `X-CodexAPI-*` headers.
-14. Update `README.md`, `CUSTOMIZATIONS.md`, and `codexclaude.md`.
-15. Run `node --check bin/codexclaude.js`, a temporary-home setup test, `npm pack --dry-run`, and endpoint validation before publishing.
+12. Keep the interactive `Upgrade Now` flow installing `@codexapi/codexclaude@latest` without a shell.
+13. Keep the managed `MODELS` map and local model catalog, including SOL Max and SOL Ultra.
+14. Keep bearer username auth and the `X-CodexAPI-*` headers.
+15. Update `README.md`, `CUSTOMIZATIONS.md`, and `codexclaude.md`.
+16. Run `node --check bin/codexclaude.js`, a temporary-home setup test, `npm pack --dry-run`, and endpoint validation before publishing.

package/README.md

@@ -1,13 +1,13 @@
 # codexclaude
 
-`codexclaude` installs the Magnetapi Client for customers who want one coding CLI that can use GPT-5.6, GPT-5.6 SOL, GPT-5.6 SOL Max, GPT-5.6 SOL Ultra, ChatGPT-5.5, Opus 4.8, Sonnet 5, or Fable 5 against the same Token Wallet.
+`codexclaude` installs the MagnetAPI.org Codex CLI for customers who want one coding CLI that can use GPT-5.6, GPT-5.6 SOL, GPT-5.6 SOL Max, GPT-5.6 SOL Ultra, ChatGPT-5.5, Opus 4.8, Sonnet 5, or Fable 5 against the same Token Wallet.
 
-Version `2.0.22` is a required major sync release. It bundles official Codex runtime dependency `@openai/codex@0.144.3`, launches the platform-native runtime binary directly, disables upstream OpenAI update prompts, and applies account, wallet, model, Full Access, GPT-5.6/xhigh defaults, and managed model metadata before each coding session starts.
+Version `2.0.24` is a required client sync release. It bundles official Codex runtime dependency `@openai/codex@0.144.4`, launches the platform-native runtime binary directly, disables upstream OpenAI update prompts, and applies account, wallet, model, Full Access, GPT-5.6/xhigh defaults, and managed model metadata before each coding session starts. Model menus no longer display wallet multiplier notices; billing remains managed by the server.
 
 ## Install Or Update
 
 ```bash
-npm install -g https://codexapi.pro/downloads/codexapi-codexclaude-2.0.22.tgz
+npm install -g @codexapi/codexclaude@latest
 ```
 
 This does not delete local session history. The update replaces the `codexclaude` launcher package, refreshes the bundled runtime dependency, and rewrites the managed provider config the next time `codexclaude setup`, `codexclaude login`, or `codexclaude start` runs.
@@ -16,7 +16,7 @@ This does not delete local session history. The update replaces the `codexclaude
 
 The launcher checks CodexAPI.pro's managed version endpoint and the `@codexapi/codexclaude` npm package metadata only. It must never check `@openai/codex` npm metadata or OpenAI GitHub releases for customer update prompts.
 
-Version `2.0.22` is currently enforced as the minimum supported version, so older launchers show a required update message with the exact hosted tarball command above.
+Version `2.0.24` is currently enforced as the minimum supported version. A compatible older launcher presents `Upgrade Now`; selecting it installs `@codexapi/codexclaude@latest`, confirms completion, and asks the customer to start `codexclaude` again. Non-interactive terminals print the same npm command instead of hanging for input.
 
 ## First Login
 
@@ -44,7 +44,7 @@ Switch model:
 codexclaude model
 ```
 
-Available model labels are `GPT-5.6`, `GPT-5.6 SOL Max`, `GPT-5.6 SOL Ultra`, `GPT-5.6 SOL`, `ChatGPT-5.5`, `Opus 4.8`, `Sonnet 5`, and `Fable 5`. SOL Max bills at 2x normal SOL usage. SOL Ultra bills at 2.5x normal SOL usage. All models use a Responses-compatible endpoint and the same customer Token Wallet.
+Available model labels are `GPT-5.6`, `GPT-5.6 SOL Max`, `GPT-5.6 SOL Ultra`, `GPT-5.6 SOL`, `ChatGPT-5.5`, `Opus 4.8`, `Sonnet 5`, and `Fable 5`. All models use a Responses-compatible endpoint and the same customer Token Wallet.
 
 Show current launcher changes:
 
@@ -57,7 +57,7 @@ codexclaude changelog
 Before launching the coding runtime, the app prints a compact status line like:
 
 ```text
-Magnetapi Client v2.0.22 · gpt-5.6 xhigh · ~/project · Wallet $20.00
+MagnetAPI.org Codex CLI v2.0.24 · gpt-5.6 xhigh · ~/project · Wallet $20.00
 ```
 
 ## Preserved Customizations
@@ -67,7 +67,7 @@ Magnetapi Client v2.0.22 · gpt-5.6 xhigh · ~/project · Wallet $20.00
 - Service-specific Responses-compatible provider for the dashboard account that logged in.
 - Full Access defaults: approval policy `never` and sandbox mode `danger-full-access`.
 - Model-specific visible reasoning in the local UI while the API server keeps upstream runtime effort server-managed.
-- A local `~/.codexclaude/model_catalog.json` file so the native `/model` picker lists only the supported Magnetapi Client choices, including SOL Max and SOL Ultra.
+- A local `~/.codexclaude/model_catalog.json` file so the native `/model` picker lists only the supported MagnetAPI.org Codex CLI choices, including SOL Max and SOL Ultra.
 - No default fast service tier. Fast mode is billed only when the user enables it inside the client.
 - Token Wallet balance lookup before launch without exposing separate `status` or `usage` launcher commands.
 - Backend-identifying request headers so the API can enforce account and plan rules server-side.

package/bin/codexclaude.js

@@ -10,9 +10,9 @@ import { stdin as input, stdout as output } from "node:process";
 
 const require = createRequire(import.meta.url);
 
-const APP_VERSION = "2.0.22";
-const CODEX_VERSION = "0.144.3";
-const APP_DISPLAY_NAME = "Magnetapi Client";
+const APP_VERSION = "2.0.24";
+const CODEX_VERSION = "0.144.4";
+const APP_DISPLAY_NAME = "MagnetAPI.org Codex CLI";
 const DEFAULT_MODEL_ID = "gpt-5.6";
 const DEFAULT_DISPLAY_REASONING_EFFORT = "xhigh";
 const DEFAULT_SERVER_REASONING_EFFORT = "xhigh";
@@ -24,7 +24,8 @@ const VERSION_CHECK_PATH = "/api/v1/codexclaude/version";
 const NPM_PACKAGE_NAME = "@codexapi/codexclaude";
 const NPM_LATEST_URL = "https://registry.npmjs.org/@codexapi%2Fcodexclaude/latest";
 const HOSTED_TARBALL_URL = `https://codexapi.pro/downloads/codexapi-codexclaude-${APP_VERSION}.tgz`;
-const UPDATE_COMMAND = `npm install -g ${HOSTED_TARBALL_URL}`;
+const UPDATE_COMMAND = `npm install -g ${NPM_PACKAGE_NAME}@latest`;
+const HOSTED_UPDATE_COMMAND = `npm install -g ${HOSTED_TARBALL_URL}`;
 const CONFIG_DIR = path.join(homedir(), ".codexclaude");
 const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
 const MODEL_CATALOG_FILE = path.join(CONFIG_DIR, "model_catalog.json");
@@ -84,14 +85,12 @@ const MODELS = {
     id: "gpt-5.6-sol-max",
     label: "GPT-5.6 SOL Max",
     aliases: ["2", "gpt-5.6-sol-max", "gpt-5.6-max", "gpt56-max", "sol-max", "max"],
-    premiumLabel: "2x premium billing",
     reasoningEffort: "max",
   },
   "gpt-5.6-sol-ultra": {
     id: "gpt-5.6-sol-ultra",
     label: "GPT-5.6 SOL Ultra",
     aliases: ["3", "gpt-5.6-sol-ultra", "gpt-5.6-ultra", "gpt56-ultra", "sol-ultra", "ultra"],
-    premiumLabel: "2.5x premium billing",
     reasoningEffort: "ultra",
   },
   "gpt-5.6-sol": {
@@ -120,7 +119,6 @@ const MODELS = {
     label: "Fable 5",
     aliases: ["8", "fable", "fable-5", "fabel", "fabel-5", "claude-fable-5", "claude-fabel-5"],
     premium: true,
-    premiumLabel: "2x premium billing",
   },
 };
 
@@ -128,7 +126,7 @@ async function main() {
   ensureExecutable();
   const [command = "start", ...args] = process.argv.slice(2);
   if (["-v", "--version", "version"].includes(command)) {
-    console.log(`${APP_DISPLAY_NAME} ${APP_VERSION}`);
+    console.log(`${APP_DISPLAY_NAME} v${APP_VERSION}`);
     return;
   }
   if (["-h", "--help", "help"].includes(command)) {
@@ -139,7 +137,9 @@ async function main() {
     await printChangelog();
     return;
   }
-  await enforceLauncherVersion();
+  if (await enforceLauncherVersion()) {
+    return;
+  }
   if (command === "login") {
     await loginFlow();
     return;
@@ -173,14 +173,14 @@ async function main() {
 
 function printHelp() {
   console.log(`
-${APP_DISPLAY_NAME} ${APP_VERSION}
+${APP_DISPLAY_NAME} v${APP_VERSION}
 
 Commands:
   codexclaude login       Login with dashboard username/email and password
   codexclaude model       Select GPT-5.6, SOL modes, Opus 4.8, Sonnet 5, or Fable 5
   codexclaude changelog   Show the latest CodexAPI.pro launcher changes
   codexclaude setup       Rewrite ~/.codex/config.toml with Full Access defaults
-  codexclaude start       Start Magnetapi Client with --search
+  codexclaude start       Start ${APP_DISPLAY_NAME} with --search
   codexclaude resume      Resume the latest coding session with --search
   codexclaude logout      Remove saved codexclaude account state
 
@@ -190,7 +190,7 @@ Any other command is passed through to the bundled coding runtime after Magnetap
 
 async function printChangelog() {
   const metadata = await getJson(`${VERSION_CHECK_PATH}?current=${encodeURIComponent(APP_VERSION)}`);
-  console.log(`codexclaude ${metadata?.latestVersion || APP_VERSION}`);
+  console.log(`${APP_DISPLAY_NAME} v${metadata?.latestVersion || APP_VERSION}`);
   console.log(`Required minimum: ${metadata?.minimumVersion || APP_VERSION}`);
   const changes = Array.isArray(metadata?.changes) ? metadata.changes : [];
   if (changes.length) {
@@ -271,7 +271,7 @@ async function loginWithServiceSelection({ username, password, selectedService,
   const loginBody = {
     username,
     password,
-    deviceName: `codexclaude ${APP_VERSION}`,
+    deviceName: `${APP_DISPLAY_NAME} v${APP_VERSION}`,
   };
   if (selectedService) {
     return {
@@ -377,8 +377,7 @@ async function askModel(rl, current) {
   const currentLabel = MODELS[current]?.label || MODELS[DEFAULT_MODEL_ID].label;
   console.log("\nChoose your coding model:");
   Object.values(MODELS).forEach((model, index) => {
-    const premium = model.premiumLabel ? ` (${model.premiumLabel})` : model.premium ? " (2x premium billing)" : "";
-    console.log(`  ${index + 1}. ${model.label}${premium}`);
+    console.log(`  ${index + 1}. ${model.label}`);
   });
   const answer = (await rl.question(`Model [${currentLabel}]: `)).trim().toLowerCase();
   if (!answer) {
@@ -418,7 +417,7 @@ async function postJson(pathname, body, origin = API_ORIGIN) {
 
 async function enforceLauncherVersion() {
   if (isTruthy(process.env.CODEXCLAUDE_DISABLE_UPDATE_CHECK)) {
-    return;
+    return false;
   }
   const params = new URLSearchParams({ current: APP_VERSION });
   let metadata = null;
@@ -428,12 +427,70 @@ async function enforceLauncherVersion() {
     metadata = null;
   }
   if (metadata?.updateRequired || isOlderVersion(APP_VERSION, metadata?.minimumVersion)) {
-    throw new Error(updateRequiredMessage(metadata));
+    await runMandatoryUpgrade(metadata);
+    return true;
   }
   const updateMetadata = optionalUpdateMetadata(metadata, await npmLatestMetadata());
   if (updateMetadata) {
     printOptionalUpdateNotice(updateMetadata);
   }
+  return false;
+}
+
+async function runMandatoryUpgrade(metadata) {
+  const latest = metadata?.latestVersion || "latest";
+  const minimum = metadata?.minimumVersion || latest;
+  const changes = Array.isArray(metadata?.changes) ? metadata.changes.slice(0, 4) : [];
+  console.error(`\n${APP_DISPLAY_NAME} v${latest} is required before your next coding session.`);
+  console.error(`Installed: v${APP_VERSION} · Required: v${minimum}`);
+  for (const change of changes) {
+    console.error(`- ${change}`);
+  }
+  console.error("Your local project files and coding-session history will not be removed.\n");
+
+  let shouldUpgrade = isTruthy(process.env.CODEXCLAUDE_AUTO_UPDATE);
+  if (!shouldUpgrade) {
+    if (!input.isTTY || !output.isTTY) {
+      throw new Error(updateRequiredMessage(metadata));
+    }
+    const rl = readline.createInterface({ input, output });
+    try {
+      console.log("  1. Upgrade Now");
+      console.log("  2. Exit");
+      const answer = (await rl.question("Select [Upgrade Now]: ")).trim().toLowerCase();
+      shouldUpgrade = ["", "1", "upgrade", "upgrade now", "yes", "y"].includes(answer);
+    } finally {
+      rl.close();
+    }
+  }
+  if (!shouldUpgrade) {
+    throw new Error(`Upgrade cancelled. Run ${UPDATE_COMMAND} before starting codexclaude again.`);
+  }
+
+  console.log(`\nDownloading and installing ${NPM_PACKAGE_NAME}@latest...`);
+  const npmCommand = process.platform === "win32" ? "npm.cmd" : "npm";
+  const exitCode = await spawnAndWait(npmCommand, ["install", "-g", `${NPM_PACKAGE_NAME}@latest`]);
+  if (exitCode !== 0) {
+    throw new Error(
+      `Automatic upgrade failed with exit code ${exitCode}. Run ${UPDATE_COMMAND}. ` +
+        `Hosted fallback: ${HOSTED_UPDATE_COMMAND}`,
+    );
+  }
+  console.log(`\nUpgrade complete. Start ${APP_DISPLAY_NAME} again by running: codexclaude`);
+}
+
+async function spawnAndWait(command, args) {
+  return await new Promise((resolve, reject) => {
+    const child = spawn(command, args, { stdio: "inherit", env: process.env, shell: false });
+    child.once("error", reject);
+    child.once("exit", (code, signal) => {
+      if (signal) {
+        reject(new Error(`Upgrade process stopped by ${signal}.`));
+        return;
+      }
+      resolve(code ?? 1);
+    });
+  });
 }
 
 async function getJson(pathname) {
@@ -531,8 +588,8 @@ function updateRequiredMessage(metadata) {
   const latest = metadata?.latestVersion || "latest";
   const minimum = metadata?.minimumVersion || latest;
   return [
-    `Update required: ${APP_DISPLAY_NAME} has updated to codexclaude ${latest}. This major release is required for all users so your local client stays synced with the managed model catalog, Full Access defaults, and provider config.`,
-    `Installed codexclaude: ${APP_VERSION}. Required: ${minimum}. Latest: ${latest}.`,
+    `Update required: ${APP_DISPLAY_NAME} v${latest} is required so your local client stays synced with the managed model catalog, Full Access defaults, and provider config.`,
+    `Installed: v${APP_VERSION}. Required: v${minimum}. Latest: v${latest}.`,
     `Run: ${installCommand}`,
     "Your local session history will not be deleted. The update only replaces the codexclaude launcher and rewrites provider config backups.",
   ].join("\n");
@@ -566,7 +623,7 @@ function printOptionalUpdateNotice(metadata) {
   const border = "─".repeat(64);
   const line = (text) => `│ ${String(text)}`.slice(0, 65).padEnd(65) + "│";
   console.error(`\n┌${border}┐`);
-  console.error(line(`codexclaude ${latest} is available. You can keep coding on ${APP_VERSION}.`));
+  console.error(line(`${APP_DISPLAY_NAME} v${latest} is available. You can keep coding on v${APP_VERSION}.`));
   console.error(line(`Update when ready: ${installCommand}`));
   for (const change of changes) {
     console.error(line(`• ${change}`));
@@ -709,10 +766,10 @@ function modelCatalogDescription(modelId) {
     return "GPT-5.6 coding route with local coding tools and wallet billing.";
   }
   if (modelId === "gpt-5.6-sol-max") {
-    return "GPT-5.6 SOL Max premium coding route with local coding tools and 2x wallet billing.";
+    return "GPT-5.6 SOL Max premium coding route with local coding tools and wallet billing.";
   }
   if (modelId === "gpt-5.6-sol-ultra") {
-    return "GPT-5.6 SOL Ultra premium coding route with local coding tools and 2.5x wallet billing.";
+    return "GPT-5.6 SOL Ultra premium coding route with local coding tools and wallet billing.";
   }
   if (modelId === "gpt-5.6-sol") {
     return "GPT-5.6 SOL native coding route with local coding tools and wallet billing.";

package/codexclaude.md

@@ -5,11 +5,12 @@ This file is the durable handoff for the `@codexapi/codexclaude` package in `/ro
 ## Current Release
 
 - Package name: `@codexapi/codexclaude`
-- Launcher version: `2.0.22`
-- Customer-facing app name: `Magnetapi Client`
-- Bundled runtime dependency: `@openai/codex@0.144.3`
-- Required install command: `npm install -g https://codexapi.pro/downloads/codexapi-codexclaude-2.0.22.tgz`
-- Backend minimum version: `2.0.22`
+- Launcher version: `2.0.24`
+- Customer-facing app name: `MagnetAPI.org Codex CLI`
+- Bundled runtime dependency: `@openai/codex@0.144.4`
+- Required install command: `npm install -g @codexapi/codexclaude@latest`
+- Hosted fallback: `npm install -g https://codexapi.pro/downloads/codexapi-codexclaude-2.0.24.tgz`
+- Backend minimum version: `2.0.24`
 - Default visible model: `GPT-5.6`
 - Default model slug: `gpt-5.6`
 - Default visible reasoning effort: `xhigh`; premium SOL Max and SOL Ultra retain their explicit `max` and `ultra` labels.
@@ -24,13 +25,13 @@ This file is the durable handoff for the `@codexapi/codexclaude` package in `/ro
 The launcher must present itself as:
 
 ```text
-Magnetapi Client v2.0.22
+MagnetAPI.org Codex CLI v2.0.24
 ```
 
 Normal pre-launch status should look like:
 
 ```text
-Magnetapi Client v2.0.22 · gpt-5.6 xhigh · ~/project · Wallet $20.00
+MagnetAPI.org Codex CLI v2.0.24 · gpt-5.6 xhigh · ~/project · Wallet $20.00
 ```
 
 Do not show OpenAI update notices, OpenAI npm install commands, OpenAI release links, or the upstream runtime version in launcher-owned output. The package still depends on the official runtime internally, but the customer update surface is ours.
@@ -38,8 +39,8 @@ Do not show OpenAI update notices, OpenAI npm install commands, OpenAI release l
 The launcher command `codexclaude model` must list these customer-visible models:
 
 - `gpt-5.6` displayed as `GPT-5.6`, first and selected by default
-- `gpt-5.6-sol-max` displayed as `GPT-5.6 SOL Max` with 2x premium billing
-- `gpt-5.6-sol-ultra` displayed as `GPT-5.6 SOL Ultra` with 2.5x premium billing
+- `gpt-5.6-sol-max` displayed as `GPT-5.6 SOL Max`
+- `gpt-5.6-sol-ultra` displayed as `GPT-5.6 SOL Ultra`
 - `gpt-5.6-sol` displayed as `GPT-5.6 SOL`
 - `gpt-5.5` displayed as `ChatGPT-5.5`
 - `claude-opus-4-8` displayed as `Opus 4.8`
@@ -55,11 +56,11 @@ GPT-5.6 must be the default when a new config is created or a legacy config cont
 - `https://codexapi.pro/api/v1/codexclaude/version`
 - `https://registry.npmjs.org/@codexapi%2Fcodexclaude/latest`
 
-It must not check `@openai/codex` npm metadata, OpenAI GitHub releases, or any upstream OpenAI update endpoint. Version `2.0.22` is a forced release: the backend `minimumVersion` equals `2.0.22`, and older clients must show an update-required message with the hosted tarball command.
+It must not check `@openai/codex` npm metadata, OpenAI GitHub releases, or any upstream OpenAI update endpoint. Version `2.0.24` is a forced release: the backend `minimumVersion` equals `2.0.24`. Compatible older launchers offer an interactive `Upgrade Now` action that invokes `npm install -g @codexapi/codexclaude@latest` without shell interpolation. Non-interactive terminals print the exact update command and exit instead of waiting for input. After a successful update, the old process exits and tells the customer to start `codexclaude` again.
 
 The launcher writes `check_for_update_on_startup = false` and removes `~/.codex/version.json` so the bundled runtime does not display stale upstream update prompts. The launcher also resolves the platform-native runtime binary directly from the optional package (`@openai/codex-linux-x64`, `@openai/codex-darwin-arm64`, and so on). Do not fall back to the upstream npm wrapper, because that wrapper can re-enable upstream managed update behavior.
 
-The optional platform-native runtime packages can still contain upstream README files and hardcoded native strings inside the binary. Launcher-owned output must say `Magnetapi Client`; replacing native binary text itself requires a maintained forked native runtime build for every supported platform. Until such a fork exists, do not re-enable the upstream npm wrapper and do not present upstream update notices to customers.
+The optional platform-native runtime packages can still contain upstream README files and hardcoded native strings inside the binary. Launcher-owned output must say `MagnetAPI.org Codex CLI`; replacing native binary text itself requires a maintained forked native runtime build for every supported platform. Until such a fork exists, do not re-enable the upstream npm wrapper and do not present upstream update notices to customers.
 
 ## Generated Config Contract
 
@@ -83,7 +84,7 @@ base_url = "<service Responses URL>"
 experimental_bearer_token = "<customer System Token/API username>"
 wire_api = "responses"
 supports_websockets = false
-http_headers = { "X-CodexAPI-Client" = "codexclaude", "X-CodexAPI-Client-Version" = "2.0.22", "X-CodexAPI-Selected-Model" = "<selected model>" }
+http_headers = { "X-CodexAPI-Client" = "codexclaude", "X-CodexAPI-Client-Version" = "2.0.24", "X-CodexAPI-Selected-Model" = "<selected model>" }
 
 [tui]
 status_line = ["model-with-reasoning", "fast-mode", "current-dir"]
@@ -115,7 +116,7 @@ The saved `username` is the System Token/API username returned by the service an
 
 The launcher is not the source of truth for upstream runtime routing. Admin Manage Models controls execution routing server-side. The launcher must preserve the user-selected model slug and pass it through the Responses request so billing, logs, and the dashboard can record what the user chose.
 
-CodexAPI.pro and ChatPlus Claude-family models use the CodexAPI.pro Claude-compatible Responses endpoint. MyAPI.world and MagnetAPI.org accounts keep their own API origins. Fable 5 remains visible as `claude-fable-5` while the backend applies the premium model behavior and billing. SOL Max bills at 2x normal SOL usage, and SOL Ultra bills at 2.5x normal SOL usage.
+CodexAPI.pro and ChatPlus Claude-family models use the CodexAPI.pro Claude-compatible Responses endpoint. MyAPI.world and MagnetAPI.org accounts keep their own API origins. Fable 5 remains visible as `claude-fable-5` while the backend applies the premium model behavior and billing. Premium billing stays server-managed and is not added to assistant output or customer model descriptions.
 
 ## Upgrade Checklist
 
@@ -125,17 +126,18 @@ When updating the bundled runtime dependency:
 2. Run `npm install @openai/codex@<version> --save-exact`.
 3. Bump `package.json` and `package-lock.json` to a new `@codexapi/codexclaude` version.
 4. Update `APP_VERSION` and `CODEX_VERSION` in `bin/codexclaude.js`.
-5. Preserve `APP_DISPLAY_NAME = "Magnetapi Client"`.
+5. Preserve `APP_DISPLAY_NAME = "MagnetAPI.org Codex CLI"`.
 6. Preserve `DEFAULT_MODEL_ID = "gpt-5.6"`.
 7. Preserve `DISPLAY_REASONING_EFFORT = "xhigh"` and `SERVER_REASONING_EFFORT = "xhigh"` unless operations explicitly changes the launcher-visible contract.
 8. Preserve Full Access defaults and the local model catalog.
 9. Preserve direct platform-native binary launch.
 10. Preserve update checks through our version endpoint and `@codexapi/codexclaude` npm metadata only.
-11. Preserve deletion of `~/.codex/version.json` and `check_for_update_on_startup = false`.
-12. Update customer setup scripts on CodexAPI.pro, ChatPlus.chat, MyAPI.world, MagnetAPI.org, and VIP pages to use the exact hosted tarball command.
-13. Update backend `CODEXCLAUDE_LATEST_VERSION`, `CODEXCLAUDE_MIN_VERSION`, and hosted tarball URL.
-14. Update this file, `README.md`, and `CUSTOMIZATIONS.md`.
-15. Run validation and publish.
+11. Preserve the interactive `Upgrade Now` flow and shell-free npm invocation.
+12. Preserve deletion of `~/.codex/version.json` and `check_for_update_on_startup = false`.
+13. Update customer setup scripts on CodexAPI.pro, ChatPlus.chat, MyAPI.world, MagnetAPI.org, and VIP pages to use the current release.
+14. Update backend `CODEXCLAUDE_LATEST_VERSION`, `CODEXCLAUDE_MIN_VERSION`, and hosted tarball URL.
+15. Update this file, `README.md`, and `CUSTOMIZATIONS.md`.
+16. Run validation and publish.
 
 ## Validation Commands
 
@@ -153,7 +155,7 @@ tmp_home="$(mktemp -d)"
 mkdir -p "$tmp_home/.codexclaude"
 cat > "$tmp_home/.codexclaude/config.json" <<'JSON'
 {
-  "version": "2.0.22",
+  "version": "2.0.24",
   "serviceId": "codexapi",
   "serviceLabel": "CodexAPI.pro",
   "apiOrigin": "https://codexapi.pro",
@@ -190,10 +192,23 @@ After packaging, copy the tarball to the public downloads directories, restart t
 
 ```bash
 curl -fsS "https://codexapi.pro/api/v1/codexclaude/version?current=2.0.17"
-curl -fsSI "https://codexapi.pro/downloads/codexapi-codexclaude-2.0.22.tgz"
+curl -fsSI "https://codexapi.pro/downloads/codexapi-codexclaude-2.0.24.tgz"
 ```
 
-The version endpoint must report `latestVersion = 2.0.22`, `minimumVersion = 2.0.22`, and `updateRequired = true` for old clients.
+The version endpoint must report `latestVersion = 2.0.24`, `minimumVersion = 2.0.24`, and `updateRequired = true` for old clients.
+
+## Version 2.0.24 Changes
+
+- Updated the bundled runtime dependency to `@openai/codex@0.144.4`.
+- Changed launcher-owned titles, help, status, terminal title, and version output to `MagnetAPI.org Codex CLI v2.0.24`.
+- Added the interactive mandatory `Upgrade Now` action backed by `@codexapi/codexclaude@latest`.
+- Preserved dashboard login, wallet status, Full Access, managed models, web search, local tools, and upstream update suppression.
+
+## Version 2.0.23 Changes
+
+- Removed wallet multiplier notices from the customer model picker and model descriptions.
+- Kept premium billing and route selection server-managed without altering assistant output.
+- Required older clients to synchronize so the removed notices cannot persist locally.
 
 ## Version 2.0.22 Changes
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codexapi/codexclaude",
-  "version": "2.0.22",
-  "description": "Magnetapi Client launcher for ChatGPT-5.5, Opus 4.8, Sonnet 5, and Fable 5.",
+  "version": "2.0.24",
+  "description": "MagnetAPI.org Codex CLI for GPT-5.6, Opus 4.8, Sonnet 5, and Fable 5.",
   "license": "Apache-2.0",
   "type": "module",
   "bin": {
@@ -17,7 +17,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@openai/codex": "0.144.3"
+    "@openai/codex": "0.144.4"
   },
   "publishConfig": {
     "access": "public"