ocx-cursor 0.2.0 → 0.3.1

package/README.md

@@ -185,6 +185,12 @@ The status output should show `Service: running` and `Gateway: healthy`. The pub
 
 Open Cursor after both checks pass. Models with known reasoning controls show an effort value in the picker. Use `Shift+Command+/` to cycle it.
 
+### Fast mode
+
+OpenAI models whose OpenCodex catalog advertises the `priority` service tier show a Fast toggle in Cursor. Fast is off by default. When enabled, the bridge sends `service_tier: "priority"` to OpenCodex, which increases generation speed and consumes more usage.
+
+Fast requires an OpenCodex version that preserves `service_tier` on its Chat Completions compatibility endpoint. Models without the `priority` tier, including Anthropic subscription models, do not receive the toggle.
+
 ## How requests are routed
 
 ```text
@@ -204,12 +210,15 @@ The gateway API key is generated during `init` and stored in Cursor with macOS S
 | --- | --- |
 | `ocx-cursor init [--base-url URL]` | Install the service, prompt for and test the tunnel, configure Cursor, and sync models. Cursor must be closed. |
 | `ocx-cursor install` | Reinstall or restart the LaunchAgent without changing Cursor's API settings. |
+| `ocx-cursor update` | Download the latest `ocx-cursor` release from npm, reinstall the service, and sync models. |
 | `ocx-cursor sync` | Refresh the active model catalog. The service queues the update while Cursor runs. |
 | `ocx-cursor status` | Show service health, model count, and pending sync state. |
 | `ocx-cursor uninstall` | Remove the LaunchAgent, command link, and bridge home directory. |
 
 `uninstall` leaves Cursor's custom endpoint and model records in its state database.
 
+`update` preserves the existing gateway API key and Cursor endpoint. It updates only this companion package; update OpenCodex separately with your package manager.
+
 ## Model mapping
 
 The bridge maps source model IDs to Cursor aliases:

package/bin/ocx-cursor.mjs

@@ -5,7 +5,7 @@ import process from "node:process";
 import { createInterface } from "node:readline/promises";
 import { configureCursorOpenAI, storedCursorOpenAIBaseUrl } from "../src/cursor-config.mjs";
 import { cursorIsRunning } from "../src/cursor-state.mjs";
-import { installService, prepareInstallSecret, serviceStatus, uninstallService } from "../src/install.mjs";
+import { installService, prepareInstallSecret, serviceStatus, uninstallService, updateService } from "../src/install.mjs";
 import { cursorOpenAIBaseUrl, pendingFile } from "../src/paths.mjs";
 import { runService } from "../src/service.mjs";
 import { normalizeBaseUrl, testTunnel } from "../src/setup.mjs";
@@ -18,6 +18,7 @@ Usage:
                         Install the service, test the tunnel, configure Cursor,
                         and sync models
   ocx-cursor install    Install and start the macOS companion service
+  ocx-cursor update     Install the latest companion release and restart it
   ocx-cursor sync       Sync active OpenCodex models into Cursor
   ocx-cursor status     Show service and model-sync status
   ocx-cursor uninstall  Stop and remove the companion service
@@ -109,6 +110,11 @@ async function main() {
     printSync(await syncNow());
     return;
   }
+  if (command === "update") {
+    process.stdout.write("Updating OpenCodex Cursor Bridge from npm...\n");
+    await updateService();
+    return;
+  }
   if (command === "sync") {
     printSync(await syncNow());
     return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ocx-cursor",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "OpenCodex companion service for Cursor custom models",
   "keywords": [
     "opencodex",

package/src/catalog.mjs

@@ -1,8 +1,15 @@
 import { execFileSync } from "node:child_process";
+import { readFileSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import { homedir } from "node:os";
-import { join } from "node:path";
-import { managedPrefix, opencodexConfigFile, opencodexServiceTokenFile } from "./paths.mjs";
+import { dirname, join, resolve } from "node:path";
+import {
+  codexConfigFile,
+  defaultCodexCatalogFile,
+  managedPrefix,
+  opencodexConfigFile,
+  opencodexServiceTokenFile,
+} from "./paths.mjs";
 
 export const allowedEfforts = ["low", "medium", "high", "xhigh", "max"];
 export const effortLabels = {
@@ -44,7 +51,29 @@ export function sanitizeEfforts(sourceId, configured) {
   return allowedEfforts.filter((effort) => values.includes(effort));
 }
 
-export function normalizeActiveCatalog(configured, active) {
+export function configuredCodexCatalogFile(configFile = codexConfigFile) {
+  try {
+    const content = readFileSync(configFile, "utf8");
+    const match = content.match(/^\s*model_catalog_json\s*=\s*("(?:[^"\\]|\\.)*")\s*$/m);
+    if (match) return resolve(dirname(configFile), JSON.parse(match[1]));
+  } catch {}
+  return defaultCodexCatalogFile;
+}
+
+export function priorityModelIds(catalogFile = configuredCodexCatalogFile()) {
+  try {
+    const payload = JSON.parse(readFileSync(catalogFile, "utf8"));
+    return new Set(payload.models
+      .filter((model) => Array.isArray(model?.service_tiers)
+        && model.service_tiers.some((tier) => tier?.id === "priority"))
+      .map((model) => model.slug || model.id)
+      .filter((id) => typeof id === "string"));
+  } catch {
+    return new Set();
+  }
+}
+
+export function normalizeActiveCatalog(configured, active, fastModelIds = new Set()) {
   const configuredById = new Map(configured
     .filter((model) => typeof model.provider === "string" && typeof model.model === "string")
     .map((model) => [`${model.provider}/${model.model}`, model]));
@@ -69,6 +98,7 @@ export function normalizeActiveCatalog(configured, active) {
       maxOutputTokens: model.capabilities?.max_output_tokens,
       inputModalities,
       reasoningEfforts: sanitizeEfforts(model.id, configuredModel?.reasoningEfforts ?? model.capabilities?.reasoning_effort),
+      supportsFast: fastModelIds.has(model.id),
     });
   }
 
@@ -113,5 +143,6 @@ export async function buildActiveCatalog(options = {}) {
   return normalizeActiveCatalog(
     configuredModels(options.ocxBin),
     await activeModels(options.fetchImpl),
+    options.fastModelIds || priorityModelIds(options.codexCatalogFile),
   );
 }

package/src/cursor-state.mjs

@@ -42,26 +42,55 @@ function effortDefinition(model) {
   };
 }
 
-function effortVariants(model) {
+function fastDefinition() {
+  return {
+    id: "fast",
+    name: "Fast",
+    markdownTooltip: "1.5x speed with increased usage.",
+    parameterType: {
+      booleanParameter: {
+        values: [
+          { value: "false" },
+          { value: "true", displayName: "Fast", increasesModelCost: true },
+        ],
+      },
+    },
+    isCycleableByHotkey: false,
+  };
+}
+
+function modelVariants(model) {
   const parameterId = parameterIdFor(model);
   const selectedDefault = defaultEffort(model);
-  return model.reasoningEfforts.map((effort) => {
-    const displayName = `${model.alias} <span style="color: var(--cursor-text-tertiary);">${effortLabels[effort]}</span>`;
-    const isDefault = effort === selectedDefault;
+  const efforts = model.reasoningEfforts.length > 0 ? model.reasoningEfforts : [null];
+  const fastValues = model.supportsFast ? ["false", "true"] : [null];
+  return efforts.flatMap((effort) => fastValues.map((fast) => {
+    const labels = [effort ? effortLabels[effort] : null, fast === "true" ? "Fast" : null].filter(Boolean);
+    const displayName = labels.length > 0
+      ? `${model.alias} <span style="color: var(--cursor-text-tertiary);">${labels.join(" ")}</span>`
+      : model.alias;
+    const isDefault = (effort === null || effort === selectedDefault) && fast !== "true";
+    const parameters = [
+      ...(effort ? [{ id: parameterId, value: effort }] : []),
+      ...(fast ? [{ id: "fast", value: fast }] : []),
+    ];
+    const suffix = [effort, fast === "true" ? "fast" : null].filter(Boolean).join("-");
     return {
-      parameterValues: [{ id: parameterId, value: effort }],
+      parameterValues: parameters,
       displayName,
       displayNameOutsidePicker: displayName,
       isMaxMode: false,
       ...(isDefault ? { isDefaultMaxConfig: true, isDefaultNonMaxConfig: true } : {}),
-      variantStringRepresentation: `${model.alias}[${parameterId}=${effort}]`,
-      legacySlug: `${model.alias}-${effort}`,
+      variantStringRepresentation: `${model.alias}[${parameters.map(({ id, value }) => `${id}=${value}`).join(",")}]`,
+      legacySlug: suffix ? `${model.alias}-${suffix}` : model.alias,
     };
-  });
+  }));
 }
 
 export function cursorModel(model) {
   const hasEffort = model.reasoningEfforts.length > 0;
+  const hasVariants = hasEffort || model.supportsFast;
+  const variants = hasVariants ? modelVariants(model) : [];
   return {
     name: model.alias,
     defaultOn: false,
@@ -80,9 +109,12 @@ export function cursorModel(model) {
     idAliases: [],
     namedModelSectionIndex: 1,
     cloudAgentEffortModes: [],
-    parameterDefinitions: hasEffort ? [effortDefinition(model)] : [],
-    variants: hasEffort ? effortVariants(model) : [],
-    legacySlugs: model.reasoningEfforts.map((effort) => `${model.alias}-${effort}`),
+    parameterDefinitions: [
+      ...(hasEffort ? [effortDefinition(model)] : []),
+      ...(model.supportsFast ? [fastDefinition()] : []),
+    ],
+    variants,
+    legacySlugs: variants.map(({ legacySlug }) => legacySlug),
     modelPickerBadges: [],
   };
 }
@@ -93,15 +125,18 @@ function syncSelectedModel(state, catalog) {
   const byAlias = new Map(catalog.map((model) => [model.alias, model]));
   for (const selected of composer.selectedModels) {
     const model = byAlias.get(selected.modelId);
-    if (!model || model.reasoningEfforts.length === 0) continue;
+    if (!model || (model.reasoningEfforts.length === 0 && !model.supportsFast)) continue;
     const parameterId = parameterIdFor(model);
-    const current = Array.isArray(selected.parameters)
-      ? selected.parameters.find(({ id }) => id === parameterId)?.value
-      : undefined;
-    selected.parameters = [{
-      id: parameterId,
-      value: model.reasoningEfforts.includes(current) ? current : defaultEffort(model),
-    }];
+    const current = Array.isArray(selected.parameters) ? selected.parameters : [];
+    const effort = current.find(({ id }) => id === parameterId)?.value;
+    const fast = current.find(({ id }) => id === "fast")?.value;
+    selected.parameters = [
+      ...(model.reasoningEfforts.length > 0 ? [{
+        id: parameterId,
+        value: model.reasoningEfforts.includes(effort) ? effort : defaultEffort(model),
+      }] : []),
+      ...(model.supportsFast ? [{ id: "fast", value: fast === "true" ? "true" : "false" }] : []),
+    ];
   }
 }
 

package/src/gateway.mjs

@@ -29,6 +29,13 @@ function suppliedEffort(payload, variantText) {
     || payload.reasoningEffort;
 }
 
+function suppliedFast(variantText) {
+  return variantText
+    ?.split(",")
+    .map((value) => value.split("=", 2))
+    .find(([key]) => key === "fast")?.[1];
+}
+
 export function rewriteModelAliasBody(body, catalog) {
   if (!body?.length) return body;
   let payload;
@@ -42,10 +49,16 @@ export function rewriteModelAliasBody(body, catalog) {
   const variant = /^(opencodex\/.+?)\[([^\]]+)\]$/.exec(payload.model);
   let alias = variant?.[1] || payload.model;
   let effort = suppliedEffort(payload, variant?.[2]);
+  let fast = suppliedFast(variant?.[2]);
   if (!allowedEfforts.includes(effort)) {
-    const legacy = catalog.find((model) => model.reasoningEfforts?.some((value) => payload.model === `${model.alias}-${value}`));
+    const legacy = catalog.find((model) => model.reasoningEfforts?.some((value) => (
+      payload.model === `${model.alias}-${value}` || payload.model === `${model.alias}-${value}-fast`
+    )));
     if (legacy) {
-      effort = legacy.reasoningEfforts.find((value) => payload.model === `${legacy.alias}-${value}`);
+      effort = legacy.reasoningEfforts.find((value) => (
+        payload.model === `${legacy.alias}-${value}` || payload.model === `${legacy.alias}-${value}-fast`
+      ));
+      fast = payload.model.endsWith("-fast") ? "true" : "false";
       alias = legacy.alias;
     }
   }
@@ -55,6 +68,8 @@ export function rewriteModelAliasBody(body, catalog) {
   payload.model = catalogModel?.sourceId
     || (fallbackSourceId.startsWith("claude-") ? `anthropic/${fallbackSourceId}` : fallbackSourceId);
   if (allowedEfforts.includes(effort)) payload.reasoning_effort = effort;
+  if (catalogModel?.supportsFast && fast === "true") payload.service_tier = "priority";
+  if (catalogModel?.supportsFast && fast === "false") delete payload.service_tier;
   delete payload.reasoningEffort;
   return Buffer.from(JSON.stringify(payload));
 }
@@ -77,6 +92,7 @@ export function enrichModelList(active, catalog) {
         supports_tool_use: true,
         supports_streaming: true,
         supports_reasoning: model.reasoningEfforts.length > 0,
+        supports_fast: model.supportsFast,
         supports_vision: model.inputModalities.includes("image"),
         reasoning_effort: model.reasoningEfforts,
       },

package/src/install.mjs

@@ -1,6 +1,7 @@
 import { execFileSync } from "node:child_process";
 import { randomBytes } from "node:crypto";
-import { access, chmod, copyFile, cp, lstat, mkdir, readFile, readlink, rename, rm, symlink, writeFile } from "node:fs/promises";
+import { access, chmod, copyFile, cp, lstat, mkdir, mkdtemp, readFile, readlink, rename, rm, symlink, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import {
@@ -176,6 +177,24 @@ export async function installService() {
   return { installRoot, launchAgentFile, cliLinkFile, secretStatus };
 }
 
+export async function updateService(options = {}) {
+  const execute = options.execFileSync || execFileSync;
+  const ownsTemporaryDirectory = !options.temporaryDirectory;
+  const temporaryDirectory = options.temporaryDirectory || await mkdtemp(join(tmpdir(), "ocx-cursor-update-"));
+  try {
+    execute(options.npmCommand || "npm", [
+      "exec",
+      "--yes",
+      "--package=ocx-cursor@latest",
+      "--",
+      "ocx-cursor",
+      "install",
+    ], { cwd: temporaryDirectory, stdio: "inherit" });
+  } finally {
+    if (ownsTemporaryDirectory) await rm(temporaryDirectory, { recursive: true, force: true });
+  }
+}
+
 export async function uninstallService() {
   bootout(serviceLabel);
   await rm(launchAgentFile, { force: true });

package/src/paths.mjs

@@ -14,6 +14,9 @@ export const stderrFile = join(installRoot, "service.error.log");
 export const launchAgentFile = join(homedir(), "Library", "LaunchAgents", `${serviceLabel}.plist`);
 export const legacyLaunchAgentFile = join(homedir(), "Library", "LaunchAgents", `${legacyServiceLabel}.plist`);
 export const cursorDatabaseFile = join(homedir(), "Library", "Application Support", "Cursor", "User", "globalStorage", "state.vscdb");
+export const codexHome = process.env.CODEX_HOME || join(homedir(), ".codex");
+export const codexConfigFile = join(codexHome, "config.toml");
+export const defaultCodexCatalogFile = join(codexHome, "opencodex-catalog.json");
 export const opencodexConfigFile = join(homedir(), ".opencodex", "config.json");
 export const opencodexServiceTokenFile = join(homedir(), ".opencodex", "service-api-token");
 export const gatewayPort = Number(process.env.OCX_CURSOR_PORT || "10101");