tokenmix 0.4.6 → 0.4.7

package/README.md

@@ -18,6 +18,7 @@ npx tokenmix kilo              # print Kilo Code VSCode configuration
 npx tokenmix cline             # print Cline VSCode configuration
 npx tokenmix roo               # print Roo Code VSCode configuration
 npx tokenmix continue          # print Continue config.yaml snippet
+npx tokenmix codex             # install + configure + start Codex
 ```
 
 ### Alternative login modes
@@ -38,6 +39,7 @@ npx tokenmix login --key sk-tm-...             # supply API key directly (for CI
 | [Cline](https://github.com/cline/cline) | VSCode extension | config-only |
 | [Roo Code](https://github.com/RooCodeInc/Roo-Code) | VSCode extension | config-only |
 | [Continue](https://github.com/continuedev/continue) | VSCode / JetBrains | config-only |
+| [Codex](https://github.com/openai/codex) | `npm i -g @openai/codex` | full auto |
 
 ## Commands
 
@@ -57,6 +59,7 @@ tokenmix kilo                       Print Kilo Code configuration
 tokenmix cline                      Print Cline configuration
 tokenmix roo                        Print Roo Code configuration
 tokenmix continue                   Print Continue config.yaml snippet
+tokenmix codex [args...]            Launch Codex via TokenMix
 ```
 
 ## Language

package/dist/agents/codex.js

@@ -0,0 +1,80 @@
+import { commandExists, run, captureRun } from '../utils/exec.js';
+import { t } from '../i18n/index.js';
+const CODEX_BIN = 'codex';
+const CODEX_NPM_PACKAGE = '@openai/codex';
+// Codex custom provider id. Must NOT collide with Codex's reserved built-in
+// provider ids (openai / ollama / lmstudio).
+const PROVIDER_ID = 'tokenmix';
+// Env var Codex reads for the bearer token (the provider's `env_key`). We set it
+// at launch from the user's TokenMix key — nothing is written to ~/.codex.
+const KEY_ENV = 'TOKENMIX_API_KEY';
+async function installCheck() {
+    const bin = await commandExists(CODEX_BIN);
+    if (!bin) {
+        const cmd = `npm install -g ${CODEX_NPM_PACKAGE}`;
+        return {
+            installed: false,
+            hint: t('install.willInstallVia', { cmd }),
+            installCmd: cmd,
+        };
+    }
+    try {
+        const v = await captureRun(CODEX_BIN, ['--version']);
+        return { installed: true, version: v.stdout.trim() };
+    }
+    catch {
+        return { installed: true };
+    }
+}
+async function install() {
+    await run('npm', ['install', '-g', CODEX_NPM_PACKAGE]);
+}
+async function configure(apiKey, baseUrl, defaultModel) {
+    // We do NOT write ~/.codex/config.toml. Codex accepts a whole custom provider
+    // via `--config` overrides at launch, and reads the key from the env var named
+    // by the provider's env_key — so we pass everything through env and inject the
+    // overrides in launch(). This never touches the user's Codex config or login.
+    return {
+        envVars: {
+            [KEY_ENV]: apiKey,
+            TOKENMIX_BASE_URL: `${baseUrl}/v1`,
+        },
+        notes: [t('codex.noteUsing'), t('codex.noteModel', { model: defaultModel })],
+    };
+}
+// Build the `--config key=value` overrides that register tokenmix as a custom
+// OpenAI-compatible provider. wire_api MUST be "responses": Codex 0.135+ dropped
+// support for "chat" (openai/codex#7782), and tokenmix's gateway implements the
+// Responses API specifically for Codex clients (POST /v1/responses).
+export function providerOverrides(baseUrl, model) {
+    return [
+        '--config', `model_provider="${PROVIDER_ID}"`,
+        '--config', `model="${model}"`,
+        '--config', `model_providers.${PROVIDER_ID}.name="TokenMix"`,
+        '--config', `model_providers.${PROVIDER_ID}.base_url="${baseUrl}"`,
+        '--config', `model_providers.${PROVIDER_ID}.env_key="${KEY_ENV}"`,
+        '--config', `model_providers.${PROVIDER_ID}.wire_api="responses"`,
+    ];
+}
+async function launch(args, env) {
+    const baseUrl = env.TOKENMIX_BASE_URL;
+    // Info-only invocations (`codex --version` / `--help`) reach launch with an
+    // empty env (no credentials). Just forward — don't inject a half-built provider.
+    if (!baseUrl) {
+        await run(CODEX_BIN, args, { env });
+        return;
+    }
+    const model = env.TOKENMIX_DEFAULT_MODEL ?? 'claude-sonnet-4.6';
+    // Our overrides go first so user-supplied args (e.g. `--config model=...`) win.
+    await run(CODEX_BIN, [...providerOverrides(baseUrl, model), ...args], { env });
+}
+export const CodexAgent = {
+    id: 'codex',
+    displayName: 'Codex',
+    description: 'openai/codex — OpenAI coding agent CLI',
+    installMode: 'auto-npm',
+    installCheck,
+    install,
+    configure,
+    launch,
+};

package/dist/agents/registry.js

@@ -5,6 +5,7 @@ import { KiloAgent } from './kilo.js';
 import { ClineAgent } from './cline.js';
 import { RooAgent } from './roo.js';
 import { ContinueAgent } from './continue.js';
+import { CodexAgent } from './codex.js';
 // Ordered by historical ARPU on tokenmix (highest first). New agents go to the bottom.
 export const AGENTS = [
     OpenCodeAgent,
@@ -14,6 +15,7 @@ export const AGENTS = [
     ClineAgent,
     RooAgent,
     ContinueAgent,
+    CodexAgent,
 ];
 export function findAgent(id) {
     return AGENTS.find((a) => a.id === id);

package/dist/commands/list.js

@@ -33,6 +33,8 @@ function agentDesc(id, fallback) {
             return t('desc.roo');
         case 'continue':
             return t('desc.continue');
+        case 'codex':
+            return t('desc.codex');
         default:
             return fallback;
     }

package/dist/i18n/messages.js

@@ -85,6 +85,7 @@ export const en = {
     'desc.cline': 'cline/cline — VSCode extension (config-only)',
     'desc.roo': 'RooCodeInc/Roo-Code — VSCode extension (config-only)',
     'desc.continue': 'continuedev/continue — VSCode/JetBrains extension (config file)',
+    'desc.codex': 'openai/codex — OpenAI coding agent CLI',
     // install hints
     'install.willInstallVia': 'Will install via: {cmd}',
     'aider.hintNeedPython': 'Aider requires Python 3. Install Python 3 from https://python.org/downloads, then come back and run `tokenmix aider` again.',
@@ -130,6 +131,9 @@ export const en = {
     'continue.noteKeepPrivate': 'Keep this API key private — anyone with it can spend your TokenMix balance.',
     'continue.hintMarketplace': 'Install "Continue" from the VSCode marketplace, then add the config below.',
     'continue.hintNoVscode': 'VSCode not detected on PATH. Install VSCode, then add the Continue extension, then use the config below.',
+    // codex configure notes (auto-npm CLI; launched with --config provider injection)
+    'codex.noteUsing': 'Codex will use TokenMix via an OpenAI-compatible provider — your ~/.codex/config.toml is left untouched.',
+    'codex.noteModel': 'Default model: {model} — override with `--config model=...`.',
     // command / option descriptions (--help)
     'cmd.program': 'Zero-config CLI to use any open-source coding agent with TokenMix as the unified LLM backend.',
     'cmd.login': 'Log in to TokenMix (default: browser device authorization)',
@@ -234,6 +238,7 @@ export const zh = {
     'desc.cline': 'cline/cline — VSCode 扩展（仅配置）',
     'desc.roo': 'RooCodeInc/Roo-Code — VSCode 扩展（仅配置）',
     'desc.continue': 'continuedev/continue — VSCode/JetBrains 扩展（配置文件）',
+    'desc.codex': 'openai/codex — OpenAI 编程 agent CLI',
     // install hints
     'install.willInstallVia': '将自动安装：{cmd}',
     'aider.hintNeedPython': 'Aider 需要 Python 3。请从 https://python.org/downloads 安装 Python 3，然后重新运行 `tokenmix aider`。',
@@ -276,6 +281,8 @@ export const zh = {
     'continue.noteKeepPrivate': '请妥善保管此 API 密钥 —— 任何人拿到它都能消耗你的 TokenMix 余额。',
     'continue.hintMarketplace': '从 VSCode 应用市场安装 "Continue"，然后添加下面的配置。',
     'continue.hintNoVscode': '未在 PATH 中检测到 VSCode。请先安装 VSCode，再添加 Continue 扩展，然后使用下面的配置。',
+    'codex.noteUsing': 'Codex 将通过 OpenAI 兼容的 provider 使用 TokenMix —— 不会改动你的 ~/.codex/config.toml。',
+    'codex.noteModel': '默认模型：{model} —— 可用 `--config model=...` 覆盖。',
     // command / option descriptions (--help)
     'cmd.program': '零配置 CLI：以 TokenMix 作为统一 LLM 后端，驱动任意开源编程 agent。',
     'cmd.login': '登录 TokenMix（默认：浏览器设备授权）',
@@ -371,6 +378,7 @@ export const ja = {
     'desc.cline': 'cline/cline — VSCode 拡張機能（設定のみ）',
     'desc.roo': 'RooCodeInc/Roo-Code — VSCode 拡張機能（設定のみ）',
     'desc.continue': 'continuedev/continue — VSCode/JetBrains 拡張機能（設定ファイル）',
+    'desc.codex': 'openai/codex — OpenAI のコーディング agent CLI',
     'install.willInstallVia': '次の方法でインストールします：{cmd}',
     'aider.hintNeedPython': 'Aider には Python 3 が必要です。https://python.org/downloads から Python 3 をインストールし、再度 `tokenmix aider` を実行してください。',
     'aider.hintNotInstalled': 'Aider はインストールされていません。別のターミナルで次を実行してください：\n    {cmd}\nその後 `tokenmix aider` を再実行してください — TokenMix のログインは保存済みなので自動的に反映されます。',
@@ -408,6 +416,8 @@ export const ja = {
     'continue.noteKeepPrivate': 'この API キーは公開しないでください — 入手した人は誰でもあなたの TokenMix 残高を使えます。',
     'continue.hintMarketplace': 'VSCode マーケットプレイスから "Continue" をインストールし、下の設定を追加してください。',
     'continue.hintNoVscode': 'PATH に VSCode が見つかりません。VSCode をインストールし、Continue 拡張機能を追加してから、下の設定を使用してください。',
+    'codex.noteUsing': 'Codex は OpenAI 互換プロバイダー経由で TokenMix を使用します — ~/.codex/config.toml は変更されません。',
+    'codex.noteModel': 'デフォルトモデル：{model} — `--config model=...` で上書きできます。',
     'cmd.program': 'TokenMix を統一 LLM バックエンドとして、あらゆるオープンソースのコーディング agent を使うためのゼロ設定 CLI。',
     'cmd.login': 'TokenMix にログイン（デフォルト：ブラウザでのデバイス認証）',
     'cmd.loginKey': 'API キーを直接貼り付け（ブラウザ認証をスキップ、CI に便利）',
@@ -502,6 +512,7 @@ export const ko = {
     'desc.cline': 'cline/cline — VSCode 확장 (설정 전용)',
     'desc.roo': 'RooCodeInc/Roo-Code — VSCode 확장 (설정 전용)',
     'desc.continue': 'continuedev/continue — VSCode/JetBrains 확장 (설정 파일)',
+    'desc.codex': 'openai/codex — OpenAI 코딩 agent CLI',
     'install.willInstallVia': '다음 방법으로 설치합니다: {cmd}',
     'aider.hintNeedPython': 'Aider에는 Python 3가 필요합니다. https://python.org/downloads 에서 Python 3를 설치한 뒤 다시 `tokenmix aider`를 실행하세요.',
     'aider.hintNotInstalled': 'Aider가 설치되어 있지 않습니다. 다른 터미널에서 다음을 실행하세요:\n    {cmd}\n그런 다음 다시 `tokenmix aider`를 실행하세요 — TokenMix 로그인이 이미 저장되어 있어 자동으로 적용됩니다.',
@@ -539,6 +550,8 @@ export const ko = {
     'continue.noteKeepPrivate': '이 API 키를 비공개로 유지하세요 — 키를 가진 사람은 누구나 당신의 TokenMix 잔액을 쓸 수 있습니다.',
     'continue.hintMarketplace': 'VSCode 마켓플레이스에서 "Continue"를 설치한 뒤 아래 설정을 추가하세요.',
     'continue.hintNoVscode': 'PATH에서 VSCode를 찾을 수 없습니다. VSCode를 설치하고 Continue 확장을 추가한 뒤 아래 설정을 사용하세요.',
+    'codex.noteUsing': 'Codex는 OpenAI 호환 provider를 통해 TokenMix를 사용합니다 — ~/.codex/config.toml은 변경되지 않습니다.',
+    'codex.noteModel': '기본 모델: {model} — `--config model=...`으로 재정의할 수 있습니다.',
     'cmd.program': 'TokenMix를 통합 LLM 백엔드로 사용하여 모든 오픈소스 코딩 agent를 쓰는 제로 설정 CLI.',
     'cmd.login': 'TokenMix에 로그인 (기본값: 브라우저 기기 인증)',
     'cmd.loginKey': 'API 키를 직접 붙여넣기 (브라우저 절차 생략, CI에 유용)',
@@ -633,6 +646,7 @@ export const es = {
     'desc.cline': 'cline/cline — extensión de VSCode (solo configuración)',
     'desc.roo': 'RooCodeInc/Roo-Code — extensión de VSCode (solo configuración)',
     'desc.continue': 'continuedev/continue — extensión de VSCode/JetBrains (archivo de configuración)',
+    'desc.codex': 'openai/codex — CLI del agente de programación de OpenAI',
     'install.willInstallVia': 'Se instalará mediante: {cmd}',
     'aider.hintNeedPython': 'Aider requiere Python 3. Instala Python 3 desde https://python.org/downloads y vuelve a ejecutar `tokenmix aider`.',
     'aider.hintNotInstalled': 'Aider no está instalado. Ejecuta esto en otra terminal:\n    {cmd}\nLuego vuelve a ejecutar `tokenmix aider`: tu sesión de TokenMix ya está guardada, así que se detectará automáticamente.',
@@ -670,6 +684,8 @@ export const es = {
     'continue.noteKeepPrivate': 'Mantén privada esta clave de API: cualquiera que la tenga puede gastar tu saldo de TokenMix.',
     'continue.hintMarketplace': 'Instala "Continue" desde el marketplace de VSCode y luego añade la configuración de abajo.',
     'continue.hintNoVscode': 'No se detectó VSCode en el PATH. Instala VSCode, añade la extensión Continue y luego usa la configuración de abajo.',
+    'codex.noteUsing': 'Codex usará TokenMix mediante un proveedor compatible con OpenAI: tu ~/.codex/config.toml no se modifica.',
+    'codex.noteModel': 'Modelo por defecto: {model} — anúlalo con `--config model=...`.',
     'cmd.program': 'CLI sin configuración para usar cualquier agent de programación de código abierto con TokenMix como backend LLM unificado.',
     'cmd.login': 'Inicia sesión en TokenMix (predeterminado: autorización de dispositivo por navegador)',
     'cmd.loginKey': 'Pega una clave de API directamente (omite el navegador, útil para CI)',
@@ -764,6 +780,7 @@ export const fr = {
     'desc.cline': 'cline/cline — extension VSCode (configuration seule)',
     'desc.roo': 'RooCodeInc/Roo-Code — extension VSCode (configuration seule)',
     'desc.continue': 'continuedev/continue — extension VSCode/JetBrains (fichier de configuration)',
+    'desc.codex': 'openai/codex — CLI de l’agent de codage d’OpenAI',
     'install.willInstallVia': 'Sera installé via : {cmd}',
     'aider.hintNeedPython': 'Aider nécessite Python 3. Installez Python 3 depuis https://python.org/downloads, puis relancez `tokenmix aider`.',
     'aider.hintNotInstalled': 'Aider n’est pas installé. Exécutez ceci dans un autre terminal :\n    {cmd}\nPuis relancez `tokenmix aider` — votre connexion TokenMix est déjà enregistrée, elle sera donc prise en compte automatiquement.',
@@ -801,6 +818,8 @@ export const fr = {
     'continue.noteKeepPrivate': 'Gardez cette clé API privée — quiconque la détient peut dépenser votre solde TokenMix.',
     'continue.hintMarketplace': 'Installez « Continue » depuis la marketplace VSCode, puis ajoutez la configuration ci-dessous.',
     'continue.hintNoVscode': 'VSCode introuvable dans le PATH. Installez VSCode, ajoutez l’extension Continue, puis utilisez la configuration ci-dessous.',
+    'codex.noteUsing': 'Codex utilisera TokenMix via un fournisseur compatible OpenAI — votre ~/.codex/config.toml n’est pas modifié.',
+    'codex.noteModel': 'Modèle par défaut : {model} — remplacez-le avec `--config model=...`.',
     'cmd.program': 'CLI sans configuration pour utiliser n’importe quel agent de codage open source avec TokenMix comme backend LLM unifié.',
     'cmd.login': 'Se connecter à TokenMix (par défaut : autorisation de l’appareil via le navigateur)',
     'cmd.loginKey': 'Coller directement une clé API (ignore le navigateur, utile pour la CI)',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokenmix",
-  "version": "0.4.6",
+  "version": "0.4.7",
   "description": "Zero-config CLI to use any open-source coding agent with TokenMix as the unified LLM backend.",
   "type": "module",
   "bin": {
@@ -30,6 +30,7 @@
     "cline",
     "roo-code",
     "continue",
+    "codex",
     "coding-agent"
   ],
   "license": "MIT",