tokenmix 1.4.16 → 1.5.0

package/README.md

@@ -1,5 +1,9 @@
 # TokenMix CLI
 
+[![CI](https://github.com/TokenMixAi/tokenmix-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/TokenMixAi/tokenmix-cli/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/tokenmix.svg)](https://www.npmjs.com/package/tokenmix)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+
 Zero-config CLI to use any open-source coding agent with [TokenMix](https://tokenmix.ai) as the unified LLM backend.
 
 One account, one balance, 160+ models routed automatically across Claude / GPT / Gemini / DeepSeek / Qwen / Moonshot / ...

package/dist/agents/aider.js

@@ -1,4 +1,6 @@
-import { commandExists, run, captureRun } from '../utils/exec.js';
+import { commandExists, run } from '../utils/exec.js';
+import { probeVersion } from './helpers.js';
+import { v1Url, DEFAULT_MODEL } from '../config/store.js';
 import { t } from '../i18n/index.js';
 const AIDER_BIN = 'aider';
 async function installCheck() {
@@ -18,13 +20,7 @@ async function installCheck() {
             hint: t('aider.hintNotInstalled', { cmd: installCmd }),
         };
     }
-    try {
-        const v = await captureRun(AIDER_BIN, ['--version']);
-        return { installed: true, version: v.stdout.trim() };
-    }
-    catch {
-        return { installed: true };
-    }
+    return probeVersion(AIDER_BIN);
 }
 async function configure(apiKey, baseUrl, defaultModel) {
     // Aider reads OPENAI_API_KEY and OPENAI_API_BASE. We pass via env at launch
@@ -32,13 +28,10 @@ async function configure(apiKey, baseUrl, defaultModel) {
     return {
         envVars: {
             OPENAI_API_KEY: apiKey,
-            OPENAI_API_BASE: `${baseUrl}/v1`,
+            OPENAI_API_BASE: v1Url(baseUrl),
             TOKENMIX_DEFAULT_MODEL: defaultModel,
         },
-        notes: [
-            t('aider.noteUsing'),
-            t('aider.noteModel', { model: defaultModel }),
-        ],
+        notes: [t('aider.noteUsing'), t('aider.noteModel', { model: defaultModel })],
     };
 }
 // Aider lets you pick a model with --model OR one of its built-in alias flags
@@ -67,7 +60,7 @@ async function launch(args, env) {
     // Inject our default --model only if the user didn't already pick a model.
     const finalArgs = userSelectedModel(args)
         ? args
-        : ['--model', `openai/${env.TOKENMIX_DEFAULT_MODEL ?? 'claude-sonnet-4.6'}`, ...args];
+        : ['--model', `openai/${env.TOKENMIX_DEFAULT_MODEL ?? DEFAULT_MODEL}`, ...args];
     await run(AIDER_BIN, finalArgs, { env });
 }
 export const AiderAgent = {

package/dist/agents/claude.js

@@ -1,31 +1,13 @@
 import os from 'os';
 import path from 'path';
 import fs from 'fs-extra';
-import { commandExists, run, captureRun } from '../utils/exec.js';
+import { run } from '../utils/exec.js';
+import { npmInstallCheck, npmInstallGlobal } from './helpers.js';
 import { t } from '../i18n/index.js';
 const CLAUDE_BIN = 'claude';
 const CLAUDE_NPM_PACKAGE = '@anthropic-ai/claude-code';
-async function installCheck() {
-    const bin = await commandExists(CLAUDE_BIN);
-    if (!bin) {
-        const cmd = `npm install -g ${CLAUDE_NPM_PACKAGE}`;
-        return {
-            installed: false,
-            hint: t('install.willInstallVia', { cmd }),
-            installCmd: cmd,
-        };
-    }
-    try {
-        const v = await captureRun(CLAUDE_BIN, ['--version']);
-        return { installed: true, version: v.stdout.trim() };
-    }
-    catch {
-        return { installed: true };
-    }
-}
-async function install() {
-    await run('npm', ['install', '-g', CLAUDE_NPM_PACKAGE]);
-}
+const installCheck = () => npmInstallCheck(CLAUDE_BIN, CLAUDE_NPM_PACKAGE);
+const install = () => npmInstallGlobal(CLAUDE_NPM_PACKAGE);
 async function configure(apiKey, baseUrl, _defaultModel) {
     // Claude Code reads:
     //   - env: ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY

package/dist/agents/cline.js

@@ -1,16 +1,10 @@
-import { commandExists } from '../utils/exec.js';
+import { vscodeConfigOnlyCheck } from './helpers.js';
+import { v1Url } from '../config/store.js';
 import { t } from '../i18n/index.js';
-async function installCheck() {
-    // Cline is a config-only agent (VSCode extension). The CLI cannot install the
-    // extension on the user's behalf, so we always proceed to `configure()` and
-    // print the settings — even if VSCode isn't installed locally yet, the user
-    // may be copying the config for another machine.
-    const code = await commandExists('code');
-    return {
-        installed: true,
-        hint: code ? t('cline.hintMarketplace') : t('cline.hintNoVscode'),
-    };
-}
+// Cline is a config-only agent (VSCode extension): the CLI can't install the
+// extension, so installCheck always reports installed and configure() prints the
+// settings to paste (the user may even be copying the config for another machine).
+const installCheck = () => vscodeConfigOnlyCheck('cline.hintMarketplace', 'cline.hintNoVscode');
 async function configure(apiKey, baseUrl, defaultModel) {
     // Cline is a VSCode extension configured through its settings panel
     // (API Provider → "OpenAI Compatible"). Unlike Kilo it exposes no documented
@@ -22,7 +16,7 @@ async function configure(apiKey, baseUrl, defaultModel) {
             t('cline.noteConfigWith'),
             '',
             `  Provider:   OpenAI Compatible`,
-            `  Base URL:   ${baseUrl}/v1`,
+            `  Base URL:   ${v1Url(baseUrl)}`,
             `  API Key:    ${apiKey}`,
             `  Model ID:   ${defaultModel}`,
             '',

package/dist/agents/codex.js

@@ -1,4 +1,6 @@
-import { commandExists, run, captureRun } from '../utils/exec.js';
+import { run } from '../utils/exec.js';
+import { npmInstallCheck, npmInstallGlobal } from './helpers.js';
+import { v1Url, DEFAULT_MODEL } from '../config/store.js';
 import { t } from '../i18n/index.js';
 const CODEX_BIN = 'codex';
 const CODEX_NPM_PACKAGE = '@openai/codex';
@@ -8,27 +10,8 @@ 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]);
-}
+const installCheck = () => npmInstallCheck(CODEX_BIN, CODEX_NPM_PACKAGE);
+const install = () => npmInstallGlobal(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
@@ -37,7 +20,7 @@ async function configure(apiKey, baseUrl, defaultModel) {
     return {
         envVars: {
             [KEY_ENV]: apiKey,
-            TOKENMIX_BASE_URL: `${baseUrl}/v1`,
+            TOKENMIX_BASE_URL: v1Url(baseUrl),
         },
         notes: [t('codex.noteUsing'), t('codex.noteModel', { model: defaultModel })],
     };
@@ -48,12 +31,18 @@ async function configure(apiKey, baseUrl, defaultModel) {
 // 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"`,
+        '--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) {
@@ -64,7 +53,7 @@ async function launch(args, env) {
         await run(CODEX_BIN, args, { env });
         return;
     }
-    const model = env.TOKENMIX_DEFAULT_MODEL ?? 'claude-sonnet-4.6';
+    const model = env.TOKENMIX_DEFAULT_MODEL ?? DEFAULT_MODEL;
     // Our overrides go first so user-supplied args (e.g. `--config model=...`) win.
     await run(CODEX_BIN, [...providerOverrides(baseUrl, model), ...args], { env });
 }

package/dist/agents/continue.js

@@ -1,15 +1,10 @@
-import { commandExists } from '../utils/exec.js';
+import { vscodeConfigOnlyCheck } from './helpers.js';
+import { v1Url } from '../config/store.js';
 import { t } from '../i18n/index.js';
-async function installCheck() {
-    // Continue is a config-only agent (VSCode/JetBrains extension). The CLI cannot
-    // install the extension, so we always proceed to configure() and print the
-    // config the user pastes into ~/.continue/config.yaml.
-    const code = await commandExists('code');
-    return {
-        installed: true,
-        hint: code ? t('continue.hintMarketplace') : t('continue.hintNoVscode'),
-    };
-}
+// Continue is a config-only agent (VSCode/JetBrains extension): the CLI can't
+// install the extension, so installCheck always reports installed and configure()
+// prints the config to paste into ~/.continue/config.yaml.
+const installCheck = () => vscodeConfigOnlyCheck('continue.hintMarketplace', 'continue.hintNoVscode');
 async function configure(apiKey, baseUrl, defaultModel) {
     // Continue is driven by ~/.continue/config.yaml (verified schema: top-level
     // name/version/schema + a `models:` list; each model needs name/provider/model,
@@ -24,7 +19,7 @@ async function configure(apiKey, baseUrl, defaultModel) {
         '  - name: TokenMix',
         '    provider: openai',
         `    model: ${defaultModel}`,
-        `    apiBase: ${baseUrl}/v1`,
+        `    apiBase: ${v1Url(baseUrl)}`,
         `    apiKey: ${apiKey}`,
     ].join('\n');
     return {

package/dist/agents/goose.js

@@ -1,25 +1,19 @@
-import { commandExists, run, captureRun } from '../utils/exec.js';
+import { commandExists, run } from '../utils/exec.js';
+import { probeVersion } from './helpers.js';
 import { t } from '../i18n/index.js';
 const GOOSE_BIN = 'goose';
 // Goose ships as a Rust binary via an official install script. We do NOT auto-run
 // a `curl | bash`; we print it so the user installs it deliberately.
 const GOOSE_INSTALL = 'curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash';
 async function installCheck() {
-    const bin = await commandExists(GOOSE_BIN);
-    if (!bin) {
+    if (!(await commandExists(GOOSE_BIN))) {
         return {
             installed: false,
             hint: t('goose.hintInstall', { cmd: GOOSE_INSTALL }),
             installCmd: GOOSE_INSTALL,
         };
     }
-    try {
-        const v = await captureRun(GOOSE_BIN, ['--version']);
-        return { installed: true, version: v.stdout.trim() };
-    }
-    catch {
-        return { installed: true };
-    }
+    return probeVersion(GOOSE_BIN);
 }
 async function configure(apiKey, baseUrl, defaultModel) {
     // Goose reads GOOSE_PROVIDER/GOOSE_MODEL + OPENAI_HOST/OPENAI_API_KEY. NOTE:

package/dist/agents/helpers.js

@@ -0,0 +1,36 @@
+import { commandExists, run, captureRun } from '../utils/exec.js';
+import { t } from '../i18n/index.js';
+// Shared install-check / install helpers, so each agent descriptor stays a thin
+// declaration instead of repeating the same boilerplate.
+// Best-effort version probe for an installed agent binary. `<bin> --version` is
+// advisory, so a missing or unparseable version still reports installed.
+export async function probeVersion(bin) {
+    try {
+        const v = await captureRun(bin, ['--version']);
+        return { installed: true, version: v.stdout.trim() };
+    }
+    catch {
+        return { installed: true };
+    }
+}
+// Install-check for an agent shipped as a global npm package: present → probe
+// version; absent → offer the `npm install -g <pkg>` command.
+export async function npmInstallCheck(bin, npmPackage) {
+    if (!(await commandExists(bin))) {
+        const cmd = `npm install -g ${npmPackage}`;
+        return { installed: false, hint: t('install.willInstallVia', { cmd }), installCmd: cmd };
+    }
+    return probeVersion(bin);
+}
+// Install a global npm package (the auto-install path for npm-based agents).
+export async function npmInstallGlobal(npmPackage) {
+    await run('npm', ['install', '-g', npmPackage]);
+}
+// Install-check for config-only VSCode-extension agents (Kilo / Cline / Roo /
+// Continue): the CLI can't install the extension, so it's always "installed";
+// the hint nudges toward installing VSCode + the extension when `code` isn't on
+// PATH (vs. the marketplace hint when it is).
+export async function vscodeConfigOnlyCheck(marketplaceHint, noVscodeHint) {
+    const code = await commandExists('code');
+    return { installed: true, hint: code ? t(marketplaceHint) : t(noVscodeHint) };
+}

package/dist/agents/kilo.js

@@ -1,16 +1,10 @@
-import { commandExists } from '../utils/exec.js';
+import { vscodeConfigOnlyCheck } from './helpers.js';
+import { v1Url } from '../config/store.js';
 import { t } from '../i18n/index.js';
-async function installCheck() {
-    // Kilo Code is a config-only agent (VSCode extension). The CLI cannot install
-    // the extension on the user's behalf, so we always proceed to `configure()` and
-    // print the snippet — even if VSCode isn't installed locally yet, the user
-    // may be copying the config for another machine.
-    const code = await commandExists('code');
-    return {
-        installed: true,
-        hint: code ? t('kilo.hintMarketplace') : t('kilo.hintNoVscode'),
-    };
-}
+// Kilo Code is a config-only agent (VSCode extension): the CLI can't install the
+// extension, so installCheck always reports installed and configure() prints the
+// snippet (the user may even be copying the config for another machine).
+const installCheck = () => vscodeConfigOnlyCheck('kilo.hintMarketplace', 'kilo.hintNoVscode');
 async function configure(apiKey, baseUrl, defaultModel) {
     // Kilo Code is a VSCode extension; there is no CLI launcher.
     // We print the configuration values for the user to paste into Kilo settings.
@@ -20,7 +14,7 @@ async function configure(apiKey, baseUrl, defaultModel) {
             t('kilo.noteConfigWith'),
             '',
             `  Provider:      OpenAI Compatible`,
-            `  Base URL:      ${baseUrl}/v1`,
+            `  Base URL:      ${v1Url(baseUrl)}`,
             `  API Key:       ${apiKey}`,
             `  Default Model: ${defaultModel}`,
             '',
@@ -28,7 +22,7 @@ async function configure(apiKey, baseUrl, defaultModel) {
             '',
             JSON.stringify({
                 provider: 'openai-compatible',
-                openAiBaseUrl: `${baseUrl}/v1`,
+                openAiBaseUrl: v1Url(baseUrl),
                 openAiApiKey: apiKey,
                 defaultModelId: defaultModel,
             }, null, 2),

package/dist/agents/opencode.js

@@ -1,7 +1,9 @@
 import os from 'os';
 import path from 'path';
 import fs from 'fs-extra';
-import { commandExists, run, captureRun } from '../utils/exec.js';
+import { run } from '../utils/exec.js';
+import { npmInstallCheck, npmInstallGlobal } from './helpers.js';
+import { v1Url } from '../config/store.js';
 import { t } from '../i18n/index.js';
 const OPENCODE_BIN = 'opencode';
 const OPENCODE_NPM_PACKAGE = 'opencode-ai';
@@ -14,27 +16,8 @@ function configPath() {
     const xdgHome = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config');
     return path.join(xdgHome, 'opencode', 'opencode.json');
 }
-async function installCheck() {
-    const bin = await commandExists(OPENCODE_BIN);
-    if (!bin) {
-        const cmd = `npm install -g ${OPENCODE_NPM_PACKAGE}`;
-        return {
-            installed: false,
-            hint: t('install.willInstallVia', { cmd }),
-            installCmd: cmd,
-        };
-    }
-    try {
-        const v = await captureRun(OPENCODE_BIN, ['--version']);
-        return { installed: true, version: v.stdout.trim() };
-    }
-    catch {
-        return { installed: true };
-    }
-}
-async function install() {
-    await run('npm', ['install', '-g', OPENCODE_NPM_PACKAGE]);
-}
+const installCheck = () => npmInstallCheck(OPENCODE_BIN, OPENCODE_NPM_PACKAGE);
+const install = () => npmInstallGlobal(OPENCODE_NPM_PACKAGE);
 async function configure(apiKey, baseUrl, defaultModel) {
     const filePath = configPath();
     let existing = {};
@@ -51,7 +34,7 @@ async function configure(apiKey, baseUrl, defaultModel) {
         npm: '@ai-sdk/openai-compatible',
         name: 'TokenMix',
         options: {
-            baseURL: `${baseUrl}/v1`,
+            baseURL: v1Url(baseUrl),
             apiKey,
         },
         // Listed models populate /connect picker; users can still type any tokenmix short_id.
@@ -72,10 +55,7 @@ async function configure(apiKey, baseUrl, defaultModel) {
     await fs.writeFile(filePath, JSON.stringify(next, null, 2));
     return {
         configPath: filePath,
-        notes: [
-            t('opencode.noteModel', { model: defaultModel }),
-            t('opencode.noteSwitch'),
-        ],
+        notes: [t('opencode.noteModel', { model: defaultModel }), t('opencode.noteSwitch')],
     };
 }
 async function launch(args) {

package/dist/agents/openhands.js

@@ -1,25 +1,20 @@
-import { commandExists, run, captureRun } from '../utils/exec.js';
+import { commandExists, run } from '../utils/exec.js';
+import { probeVersion } from './helpers.js';
+import { v1Url } from '../config/store.js';
 import { t } from '../i18n/index.js';
 const OPENHANDS_BIN = 'openhands';
 // OpenHands needs Python 3.12+; `uv` pulls a matching Python automatically. We
 // print this rather than auto-running it (it installs a toolchain + Python).
 const OPENHANDS_INSTALL = 'uv tool install openhands --python 3.12';
 async function installCheck() {
-    const bin = await commandExists(OPENHANDS_BIN);
-    if (!bin) {
+    if (!(await commandExists(OPENHANDS_BIN))) {
         return {
             installed: false,
             hint: t('openhands.hintInstall', { cmd: OPENHANDS_INSTALL }),
             installCmd: OPENHANDS_INSTALL,
         };
     }
-    try {
-        const v = await captureRun(OPENHANDS_BIN, ['--version']);
-        return { installed: true, version: v.stdout.trim() };
-    }
-    catch {
-        return { installed: true };
-    }
+    return probeVersion(OPENHANDS_BIN);
 }
 async function configure(apiKey, baseUrl, defaultModel) {
     // OpenHands reads LLM_API_KEY/LLM_MODEL/LLM_BASE_URL but ONLY when launched with
@@ -29,7 +24,7 @@ async function configure(apiKey, baseUrl, defaultModel) {
         envVars: {
             LLM_API_KEY: apiKey,
             LLM_MODEL: `openai/${defaultModel}`,
-            LLM_BASE_URL: `${baseUrl}/v1`,
+            LLM_BASE_URL: v1Url(baseUrl),
             OPENHANDS_SUPPRESS_BANNER: '1',
         },
         notes: [t('openhands.noteUsing'), t('openhands.noteModel', { model: defaultModel })],

package/dist/agents/qwen.js

@@ -1,28 +1,11 @@
-import { commandExists, run, captureRun } from '../utils/exec.js';
+import { run } from '../utils/exec.js';
+import { npmInstallCheck, npmInstallGlobal } from './helpers.js';
+import { v1Url } from '../config/store.js';
 import { t } from '../i18n/index.js';
 const QWEN_BIN = 'qwen';
 const QWEN_NPM_PACKAGE = '@qwen-code/qwen-code';
-async function installCheck() {
-    const bin = await commandExists(QWEN_BIN);
-    if (!bin) {
-        const cmd = `npm install -g ${QWEN_NPM_PACKAGE}`;
-        return {
-            installed: false,
-            hint: t('install.willInstallVia', { cmd }),
-            installCmd: cmd,
-        };
-    }
-    try {
-        const v = await captureRun(QWEN_BIN, ['--version']);
-        return { installed: true, version: v.stdout.trim() };
-    }
-    catch {
-        return { installed: true };
-    }
-}
-async function install() {
-    await run('npm', ['install', '-g', `${QWEN_NPM_PACKAGE}@latest`]);
-}
+const installCheck = () => npmInstallCheck(QWEN_BIN, QWEN_NPM_PACKAGE);
+const install = () => npmInstallGlobal(`${QWEN_NPM_PACKAGE}@latest`);
 async function configure(apiKey, baseUrl, defaultModel) {
     // Qwen Code (a Gemini CLI fork) reads OPENAI_API_KEY / OPENAI_BASE_URL /
     // OPENAI_MODEL when launched with `--auth-type openai` — VERIFIED end-to-end
@@ -31,7 +14,7 @@ async function configure(apiKey, baseUrl, defaultModel) {
     return {
         envVars: {
             OPENAI_API_KEY: apiKey,
-            OPENAI_BASE_URL: `${baseUrl}/v1`,
+            OPENAI_BASE_URL: v1Url(baseUrl),
             OPENAI_MODEL: defaultModel,
         },
         notes: [t('qwen.noteUsing'), t('qwen.noteModel', { model: defaultModel })],

package/dist/agents/registry.js

@@ -23,6 +23,3 @@ export const AGENTS = [
     GooseAgent,
     OpenHandsAgent,
 ];
-export function findAgent(id) {
-    return AGENTS.find((a) => a.id === id);
-}

package/dist/agents/roo.js

@@ -1,15 +1,10 @@
-import { commandExists } from '../utils/exec.js';
+import { vscodeConfigOnlyCheck } from './helpers.js';
+import { v1Url } from '../config/store.js';
 import { t } from '../i18n/index.js';
-async function installCheck() {
-    // Roo Code is a config-only agent (VSCode extension, a Cline fork). The CLI
-    // cannot install the extension, so we always proceed to configure() and print
-    // the settings — the user may also be copying the config for another machine.
-    const code = await commandExists('code');
-    return {
-        installed: true,
-        hint: code ? t('roo.hintMarketplace') : t('roo.hintNoVscode'),
-    };
-}
+// Roo Code is a config-only agent (VSCode extension, a Cline fork): the CLI can't
+// install the extension, so installCheck always reports installed and configure()
+// prints the settings (the user may also be copying the config for another machine).
+const installCheck = () => vscodeConfigOnlyCheck('roo.hintMarketplace', 'roo.hintNoVscode');
 async function configure(apiKey, baseUrl, defaultModel) {
     // Roo Code is configured through its settings panel (API Provider →
     // "OpenAI Compatible"), exactly like Cline. No documented settings.json
@@ -20,7 +15,7 @@ async function configure(apiKey, baseUrl, defaultModel) {
             t('roo.noteConfigWith'),
             '',
             `  Provider:   OpenAI Compatible`,
-            `  Base URL:   ${baseUrl}/v1`,
+            `  Base URL:   ${v1Url(baseUrl)}`,
             `  API Key:    ${apiKey}`,
             `  Model ID:   ${defaultModel}`,
             '',

package/dist/api/client.js

@@ -12,14 +12,17 @@ export function unwrap(resp) {
     if (body && typeof body.code === 'number' && body.code !== 0) {
         throw new ApiError(0, body.message || 'API error');
     }
-    return body?.data ?? body;
+    // Standard success envelope → return the inner `data`. A body with no envelope
+    // (no `data` field — e.g. a raw array) is passed straight through: a deliberate
+    // fallback for endpoints that don't wrap their payload (locked by a unit test).
+    if (body && body.data != null)
+        return body.data;
+    return body;
 }
 function handleAxios(err) {
     const e = err;
     if (e.response) {
-        const msg = e.response.data?.message ||
-            e.response.data?.error?.message ||
-            e.message;
+        const msg = e.response.data?.message || e.response.data?.error?.message || e.message;
         throw new ApiError(e.response.status, msg);
     }
     throw new ApiError(0, `Could not reach the TokenMix API (${e.message || 'network error'}). Check your internet connection or proxy.`);
@@ -56,7 +59,7 @@ export async function listPublicModels(cfg) {
             timeout: REQUEST_TIMEOUT_MS,
         }));
         const list = unwrap(r);
-        return Array.isArray(list) ? list : list?.list ?? [];
+        return Array.isArray(list) ? list : (list?.list ?? []);
     }
     catch (err) {
         handleAxios(err);

package/dist/commands/agent-runner.js

@@ -1,9 +1,8 @@
 import { logger } from '../utils/logger.js';
-import { readConfig, apiBaseUrl } from '../config/store.js';
+import { readConfig, apiBaseUrl, DEFAULT_MODEL } from '../config/store.js';
 import { confirm } from '../utils/prompt.js';
 import { AGENTS } from '../agents/registry.js';
 import { t } from '../i18n/index.js';
-const DEFAULT_MODEL = 'claude-sonnet-4.6';
 // Major version of the running Node (e.g. 22 from "v22.9.0"). Gates agents whose
 // binary needs a newer Node than this process (Codex / Qwen Code require 22).
 export function nodeMajor() {

package/dist/commands/balance.js

@@ -3,9 +3,8 @@ import { logger } from '../utils/logger.js';
 import { openOrHint } from '../utils/browser.js';
 import { readConfig, apiBaseUrl } from '../config/store.js';
 import { fetchWallet } from '../api/client.js';
+import { DASHBOARD_URL, DASHBOARD_CREDITS_URL } from '../config/urls.js';
 import { t } from '../i18n/index.js';
-const DASHBOARD_URL = 'https://tokenmix.ai/dashboard';
-const TOPUP_URL = 'https://tokenmix.ai/dashboard/credits';
 // micro-USD → display string. Mirrors the platform / plugin: 2 decimals for
 // amounts >= $1 (trailing zeros trimmed), more precision for sub-dollar amounts.
 export function formatUSD(microUsd) {
@@ -32,12 +31,16 @@ export async function balanceCommand() {
             console.log(`  ${t('balance.reservedLabel')}: $${formatUSD(w.frozen)}`);
         }
         console.log();
-        logger.dim(t('balance.topupAt', { url: TOPUP_URL }));
+        logger.dim(t('balance.topupAt', { url: DASHBOARD_CREDITS_URL }));
         console.log();
     }
-    catch {
-        // Network / auth hiccup — fall back to the dashboard so the user isn't stuck.
+    catch (err) {
+        // Couldn't fetch the wallet (network failure, or an invalid/expired key).
+        // Surface the reason — consistent with doctor/login — then fall back to the
+        // dashboard so the user isn't stuck.
         logger.warn(t('balance.fetchFailed'));
+        if (err instanceof Error && err.message)
+            logger.dim(err.message);
         logger.step(t('balance.opening', { url: DASHBOARD_URL }));
         await openOrHint(DASHBOARD_URL);
     }

package/dist/commands/doctor.js

@@ -40,6 +40,15 @@ export async function doctorCommand() {
     console.log(chalk.bold(t('doctor.agentStatus')));
     for (const a of AGENTS) {
         const r = await a.installCheck();
+        // Config-only agents (VSCode extensions) have no binary of their own to install,
+        // so installCheck always reports installed:true — labeling them "installed" is
+        // misleading. Show their install mode instead, matching `tokenmix list`.
+        if (a.installMode === 'manual-vscode') {
+            logger.success(`${a.displayName.padEnd(14)} ${chalk.dim(t('list.modeManualVscode'))}`);
+            if (r.hint)
+                console.log(`    ${chalk.dim(r.hint)}`);
+            continue;
+        }
         if (r.installed) {
             logger.success(`${a.displayName.padEnd(14)} ${t('doctor.installed')}${r.version ? ` (${chalk.dim(r.version)})` : ''}`);
             if (r.hint)

package/dist/commands/logout.js

@@ -14,7 +14,8 @@ export async function logoutCommand() {
         try {
             const r = await agent.cleanup();
             if (r.reverted) {
-                logger.success(t('logout.reverted', { name: agent.displayName }) + (r.configPath ? ` (${r.configPath})` : ''));
+                logger.success(t('logout.reverted', { name: agent.displayName }) +
+                    (r.configPath ? ` (${r.configPath})` : ''));
                 if (r.note)
                     logger.dim(`  ${r.note}`);
             }

package/dist/commands/topup.js

@@ -1,8 +1,8 @@
 import { logger } from '../utils/logger.js';
 import { openOrHint } from '../utils/browser.js';
+import { DASHBOARD_CREDITS_URL } from '../config/urls.js';
 import { t } from '../i18n/index.js';
-const TOPUP_URL = 'https://tokenmix.ai/dashboard/credits';
 export async function topupCommand() {
-    logger.step(t('topup.opening', { url: TOPUP_URL }));
-    await openOrHint(TOPUP_URL);
+    logger.step(t('topup.opening', { url: DASHBOARD_CREDITS_URL }));
+    await openOrHint(DASHBOARD_CREDITS_URL);
 }

package/dist/config/store.js

@@ -1,6 +1,14 @@
 import fs from 'fs-extra';
 import { configDir, configFile } from './paths.js';
 export const DEFAULT_API_BASE = 'https://api.tokenmix.ai';
+// The model agents default to when the user hasn't chosen one (overridable via
+// the TOKENMIX_DEFAULT_MODEL env var or stored config). Single source of truth.
+export const DEFAULT_MODEL = 'claude-sonnet-4.6';
+// Append the OpenAI-compatible `/v1` suffix to a base URL, tolerating a trailing
+// slash so `https://host/` doesn't yield `https://host//v1`.
+export function v1Url(baseUrl) {
+    return `${baseUrl.replace(/\/+$/, '')}/v1`;
+}
 export async function readConfig() {
     try {
         const raw = await fs.readFile(configFile(), 'utf-8');

package/dist/config/urls.js

@@ -0,0 +1,3 @@
+// User-facing TokenMix dashboard links the CLI opens in a browser.
+export const DASHBOARD_URL = 'https://tokenmix.ai/dashboard';
+export const DASHBOARD_CREDITS_URL = 'https://tokenmix.ai/dashboard/credits';

package/dist/i18n/messages.js

@@ -102,7 +102,7 @@ export const en = {
     // 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.',
-    'aider.hintNotInstalled': 'Aider is not installed. Run this in another terminal:\n    {cmd}\nThen come back and run `tokenmix aider` again — your TokenMix login is already saved, so it will pick up automatically.',
+    'aider.hintNotInstalled': 'Aider is not installed. Run this in another terminal:\n    {cmd}',
     // opencode configure notes
     'opencode.noteModel': 'Default model set to tokenmix/{model}',
     'opencode.noteSwitch': 'To switch models, run `tokenmix models` or use `/connect` inside OpenCode.',
@@ -279,7 +279,7 @@ export const zh = {
     // install hints
     '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 登录已保存，会自动生效。',
+    'aider.hintNotInstalled': 'Aider 尚未安装。请在另一个终端运行：\n    {cmd}',
     // opencode configure notes
     'opencode.noteModel': '默认模型已设为 tokenmix/{model}',
     'opencode.noteSwitch': '切换模型：运行 `tokenmix models`，或在 OpenCode 内使用 `/connect`。',
@@ -439,7 +439,7 @@ export const ja = {
     'desc.openhands': 'All-Hands-AI/OpenHands — 自律型コーディング agent（OpenAI 互換）',
     '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 のログインは保存済みなので自動的に反映されます。',
+    'aider.hintNotInstalled': 'Aider はインストールされていません。別のターミナルで次を実行してください：\n    {cmd}',
     'opencode.noteModel': 'デフォルトモデルを tokenmix/{model} に設定しました',
     'opencode.noteSwitch': 'モデルを切り替えるには `tokenmix models` を実行するか、OpenCode 内で `/connect` を使用してください。',
     'claude.noteModels': 'tokenmix 経由で利用できる Claude モデル：claude-opus-4.7、claude-sonnet-4.6、claude-haiku-4.5',
@@ -594,7 +594,7 @@ export const ko = {
     'desc.openhands': 'All-Hands-AI/OpenHands — 자율 코딩 agent (OpenAI 호환)',
     '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 로그인이 이미 저장되어 있어 자동으로 적용됩니다.',
+    'aider.hintNotInstalled': 'Aider가 설치되어 있지 않습니다. 다른 터미널에서 다음을 실행하세요:\n    {cmd}',
     'opencode.noteModel': '기본 모델을 tokenmix/{model}(으)로 설정했습니다',
     'opencode.noteSwitch': '모델을 바꾸려면 `tokenmix models`를 실행하거나 OpenCode 안에서 `/connect`를 사용하세요.',
     'claude.noteModels': 'tokenmix를 통해 사용할 수 있는 Claude 모델: claude-opus-4.7, claude-sonnet-4.6, claude-haiku-4.5',
@@ -749,7 +749,7 @@ export const es = {
     'desc.openhands': 'All-Hands-AI/OpenHands — agente de programación autónomo (compatible con 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.',
+    'aider.hintNotInstalled': 'Aider no está instalado. Ejecuta esto en otra terminal:\n    {cmd}',
     'opencode.noteModel': 'Modelo predeterminado establecido en tokenmix/{model}',
     'opencode.noteSwitch': 'Para cambiar de modelo, ejecuta `tokenmix models` o usa `/connect` dentro de OpenCode.',
     'claude.noteModels': 'Modelos de Claude disponibles vía tokenmix: claude-opus-4.7, claude-sonnet-4.6, claude-haiku-4.5',
@@ -904,7 +904,7 @@ export const fr = {
     'desc.openhands': 'All-Hands-AI/OpenHands — agent de codage autonome (compatible 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.',
+    'aider.hintNotInstalled': 'Aider n’est pas installé. Exécutez ceci dans un autre terminal :\n    {cmd}',
     'opencode.noteModel': 'Modèle par défaut défini sur tokenmix/{model}',
     'opencode.noteSwitch': 'Pour changer de modèle, exécutez `tokenmix models` ou utilisez `/connect` dans OpenCode.',
     'claude.noteModels': 'Modèles Claude disponibles via tokenmix : claude-opus-4.7, claude-sonnet-4.6, claude-haiku-4.5',

package/dist/program.js

@@ -33,32 +33,17 @@ export function buildProgram(deps = {}) {
         .option('-p, --paste', t('cmd.loginPaste'))
         .option('-u, --url <baseUrl>', t('cmd.loginUrl'))
         .action(loginCommand);
-    program
-        .command('logout')
-        .description(t('cmd.logout'))
-        .action(logoutCommand);
-    program
-        .command('balance')
-        .description(t('cmd.balance'))
-        .action(balanceCommand);
-    program
-        .command('topup')
-        .description(t('cmd.topup'))
-        .action(topupCommand);
+    program.command('logout').description(t('cmd.logout')).action(logoutCommand);
+    program.command('balance').description(t('cmd.balance')).action(balanceCommand);
+    program.command('topup').description(t('cmd.topup')).action(topupCommand);
     program
         .command('models')
         .description(t('cmd.models'))
         .option('-t, --type <type>', t('cmd.modelsType'))
         .option('-s, --search <keyword>', t('cmd.modelsSearch'))
         .action(modelsCommand);
-    program
-        .command('list')
-        .description(t('cmd.list'))
-        .action(listCommand);
-    program
-        .command('doctor')
-        .description(t('cmd.doctor'))
-        .action(doctorCommand);
+    program.command('list').description(t('cmd.list')).action(listCommand);
+    program.command('doctor').description(t('cmd.doctor')).action(doctorCommand);
     // Register one subcommand per supported agent (opencode, claude, aider, kilo, ...).
     registerAgentCommands(program, deps.runAgent);
     return program;

package/dist/utils/prompt.js

@@ -5,7 +5,7 @@ export async function promptApiKey() {
         type: 'password',
         name: 'apiKey',
         message: t('prompt.pasteKey'),
-        validate: (v) => v && v.startsWith('sk-tm-') ? true : t('login.keyMustStart'),
+        validate: (v) => (v && v.startsWith('sk-tm-') ? true : t('login.keyMustStart')),
     });
     const key = r.apiKey?.trim();
     return key || null;
@@ -25,12 +25,3 @@ export async function confirm(message, initial = true) {
     });
     return Boolean(r.ok);
 }
-export async function select(message, choices) {
-    const r = await prompts({
-        type: 'select',
-        name: 'value',
-        message,
-        choices,
-    });
-    return r.value ?? null;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokenmix",
-  "version": "1.4.16",
+  "version": "1.5.0",
   "description": "Zero-config CLI to use any open-source coding agent with TokenMix as the unified LLM backend.",
   "type": "module",
   "bin": {
@@ -11,6 +11,10 @@
     "dev": "tsx src/cli.ts",
     "start": "node bin/tokenmix.js",
     "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
     "test": "vitest run",
     "test:watch": "vitest",
     "prepublishOnly": "pnpm build"
@@ -36,11 +40,15 @@
     "openhands",
     "coding-agent"
   ],
+  "author": "TokenMix",
   "license": "MIT",
   "homepage": "https://tokenmix.ai",
   "repository": {
     "type": "git",
-    "url": "https://github.com/tokenmix/tokenmix-cli.git"
+    "url": "https://github.com/TokenMixAi/tokenmix-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/TokenMixAi/tokenmix-cli/issues"
   },
   "files": [
     "bin",
@@ -59,12 +67,18 @@
     "which": "^5.0.0"
   },
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^22.9.0",
     "@types/prompts": "^2.4.9",
     "@types/which": "^3.0.4",
+    "eslint": "^10.4.1",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^17.6.0",
+    "prettier": "^3.8.3",
     "tsx": "^4.19.2",
     "typescript": "^5.6.3",
+    "typescript-eslint": "^8.60.0",
     "vitest": "^4.1.7"
   },
   "pnpm": {