tokenmix 0.4.11 → 0.4.13

package/README.md

@@ -8,6 +8,7 @@ One account, one balance, 160+ models routed automatically across Claude / GPT /
 
 Behind the zero-config CLI is a gateway built to be the **honest, transparent** LLM backend for BYOK coding agents:
 
+- **The model you pick is the model you get.** Your request routes to the real upstream model you named — no silent downgrade to a cheaper one (the grey market's classic "sold Opus, served Haiku"). Model aliases are name normalization only, never a swap.
 - **Transparent, real-time billing.** `tokenmix balance` shows your actual balance, gift credit, and total spent — to micro-USD precision, not opaque "credits". `tokenmix models` lists every model's real price (free models show `$0`, not a dash).
 - **Prompt caching that saves you money — automatically.** Cache hits bill at the discounted rate with nothing to configure: OpenAI / DeepSeek / Gemini / Qwen via their `cached_tokens`, Anthropic via `cache_control` pass-through (cache reads ≈10% of the input price). The savings are yours, and you can see them.
 - **One key, every protocol.** OpenAI Chat Completions, Anthropic Messages, and the Responses API — all on one account, which is why every agent below (terminal and editor alike) runs on a single balance.
@@ -90,6 +91,17 @@ TOKENMIX_LANG=ja npx tokenmix doctor   # 日本語
 TOKENMIX_LANG=fr npx tokenmix doctor   # Français
 ```
 
+## Default model
+
+Agents default to `claude-sonnet-4.6`. Override it for any launch with the `TOKENMIX_DEFAULT_MODEL` environment variable — handy for a cheaper/faster default or for scripting:
+
+```bash
+TOKENMIX_DEFAULT_MODEL=claude-haiku-4.5 npx tokenmix opencode
+TOKENMIX_DEFAULT_MODEL=qwen-flash       npx tokenmix aider
+```
+
+(`tokenmix claude` and `tokenmix codex` speak the Anthropic / Responses protocols, so they need a Claude-family model; the other agents accept any chat model.)
+
 ## Configuration Location
 
 Your TokenMix credentials are stored locally at:

package/dist/commands/agent-runner.js

@@ -62,7 +62,9 @@ export async function runAgent(agent, args) {
         process.exit(1);
     }
     const baseUrl = apiBaseUrl(cfg);
-    const defaultModel = cfg.defaultModel || DEFAULT_MODEL;
+    // TOKENMIX_DEFAULT_MODEL env overrides the model — handy for CI/scripts that want a
+    // cheap model, or as a power-user default. Falls back to stored config, then built-in.
+    const defaultModel = process.env.TOKENMIX_DEFAULT_MODEL || cfg.defaultModel || DEFAULT_MODEL;
     // Refuse early with a friendly message if the agent's binary needs a newer Node
     // than we're running on (Codex/Qwen need 22) — avoids a cryptic npm/install error.
     if (agent.minNode && nodeMajor() < agent.minNode) {

package/dist/commands/welcome.js

@@ -0,0 +1,28 @@
+import chalk from 'chalk';
+import { readConfig } from '../config/store.js';
+import { t } from '../i18n/index.js';
+// Shown for a bare `tokenmix` (no command) — friendly, localized onboarding for
+// first-timers instead of commander's raw help. `tokenmix --help` still prints the
+// full command reference. Adapts to whether the user is logged in yet.
+export async function welcomeCommand() {
+    const cfg = await readConfig();
+    const loggedIn = Boolean(cfg.apiKey);
+    const row = (cmd, desc) => '    ' + chalk.cyan(cmd.padEnd(21)) + chalk.dim(desc);
+    console.log();
+    console.log('  ' + chalk.bold.cyan('TokenMix') + chalk.dim(' — ' + t('welcome.tagline')));
+    console.log();
+    if (loggedIn) {
+        console.log('  ' + chalk.green('✓') + ' ' + t('welcome.loggedIn'));
+        console.log(row('tokenmix opencode', t('welcome.s3')));
+        console.log(row('tokenmix list', t('welcome.s2')));
+    }
+    else {
+        console.log('  ' + chalk.bold(t('welcome.start')));
+        console.log(row('1. tokenmix login', t('welcome.s1')));
+        console.log(row('2. tokenmix list', t('welcome.s2')));
+        console.log(row('3. tokenmix opencode', t('welcome.s3')));
+    }
+    console.log();
+    console.log('  ' + chalk.dim(t('welcome.more')));
+    console.log();
+}

package/dist/i18n/messages.js

@@ -6,6 +6,14 @@
 // `{name}`-style placeholders are filled by t() at call time.
 export const en = {
     'common.notLoggedIn': 'Not logged in. Run `tokenmix login` first.',
+    // welcome screen (bare `tokenmix`, no args — onboarding for first-time users)
+    'welcome.tagline': 'one account, 160+ models, every open-source coding agent',
+    'welcome.start': 'Get started:',
+    'welcome.s1': 'log in (opens a browser, ~10s)',
+    'welcome.s2': 'see all 11 supported agents',
+    'welcome.s3': 'configure & launch one',
+    'welcome.loggedIn': "You're logged in — launch an agent:",
+    'welcome.more': 'More: `tokenmix --help` for all commands · `tokenmix balance` for your balance',
     // login
     'login.keyMustStart': 'API key should start with sk-tm-',
     'login.verifying': 'Verifying API key against {baseUrl} ...',
@@ -175,6 +183,13 @@ export const en = {
 };
 export const zh = {
     'common.notLoggedIn': '未登录，请先运行 `tokenmix login`。',
+    'welcome.tagline': '一个账户、160+ 模型、对接所有开源编程 agent',
+    'welcome.start': '快速开始：',
+    'welcome.s1': '登录（打开浏览器，约 10 秒）',
+    'welcome.s2': '查看支持的 11 个 agent',
+    'welcome.s3': '配置并启动一个',
+    'welcome.loggedIn': '你已登录 —— 启动一个 agent：',
+    'welcome.more': '更多：`tokenmix --help` 查看全部命令 · `tokenmix balance` 查看余额',
     // login
     'login.keyMustStart': 'API 密钥应以 sk-tm- 开头',
     'login.verifying': '正在通过 {baseUrl} 校验 API 密钥 ...',
@@ -337,6 +352,13 @@ export const zh = {
 };
 export const ja = {
     'common.notLoggedIn': 'ログインしていません。まず `tokenmix login` を実行してください。',
+    'welcome.tagline': '1 つのアカウントで 160+ モデル、あらゆるオープンソース・コーディング agent に対応',
+    'welcome.start': 'はじめに：',
+    'welcome.s1': 'ログイン（ブラウザが開きます、約 10 秒）',
+    'welcome.s2': 'サポートされている 11 の agent を表示',
+    'welcome.s3': '設定して起動',
+    'welcome.loggedIn': 'ログイン済みです —— agent を起動：',
+    'welcome.more': 'その他：`tokenmix --help` で全コマンド · `tokenmix balance` で残高',
     'login.keyMustStart': 'API キーは sk-tm- で始まる必要があります',
     'login.verifying': '{baseUrl} で API キーを検証しています ...',
     'login.verifyFailed': 'API キーの検証に失敗しました。https://tokenmix.ai/dashboard/keys で確認してください',
@@ -484,6 +506,13 @@ export const ja = {
 };
 export const ko = {
     'common.notLoggedIn': '로그인되어 있지 않습니다. 먼저 `tokenmix login`을 실행하세요.',
+    'welcome.tagline': '하나의 계정으로 160+ 모델, 모든 오픈소스 코딩 agent 지원',
+    'welcome.start': '시작하기:',
+    'welcome.s1': '로그인 (브라우저가 열립니다, 약 10초)',
+    'welcome.s2': '지원되는 11개 agent 보기',
+    'welcome.s3': '설정하고 실행',
+    'welcome.loggedIn': '로그인되었습니다 —— agent를 실행하세요:',
+    'welcome.more': '더 보기: `tokenmix --help` 모든 명령 · `tokenmix balance` 잔액',
     'login.keyMustStart': 'API 키는 sk-tm- 로 시작해야 합니다',
     'login.verifying': '{baseUrl} 에서 API 키를 확인하는 중 ...',
     'login.verifyFailed': 'API 키 확인에 실패했습니다. https://tokenmix.ai/dashboard/keys 에서 확인하세요',
@@ -631,6 +660,13 @@ export const ko = {
 };
 export const es = {
     'common.notLoggedIn': 'No has iniciado sesión. Ejecuta `tokenmix login` primero.',
+    'welcome.tagline': 'una cuenta, 160+ modelos, todos los agentes de programación de código abierto',
+    'welcome.start': 'Empezar:',
+    'welcome.s1': 'inicia sesión (abre el navegador, ~10 s)',
+    'welcome.s2': 've los 11 agentes compatibles',
+    'welcome.s3': 'configura y lanza uno',
+    'welcome.loggedIn': 'Has iniciado sesión: lanza un agente:',
+    'welcome.more': 'Más: `tokenmix --help` para todos los comandos · `tokenmix balance` para tu saldo',
     'login.keyMustStart': 'La clave de API debe empezar por sk-tm-',
     'login.verifying': 'Verificando la clave de API en {baseUrl} ...',
     'login.verifyFailed': 'Falló la verificación de la clave de API. Compruébala en https://tokenmix.ai/dashboard/keys',
@@ -778,6 +814,13 @@ export const es = {
 };
 export const fr = {
     'common.notLoggedIn': 'Non connecté. Exécutez d’abord `tokenmix login`.',
+    'welcome.tagline': 'un seul compte, 160+ modèles, tous les agents de codage open source',
+    'welcome.start': 'Démarrer :',
+    'welcome.s1': 'connectez-vous (ouvre un navigateur, ~10 s)',
+    'welcome.s2': 'voir les 11 agents pris en charge',
+    'welcome.s3': 'configurer et lancer un agent',
+    'welcome.loggedIn': 'Vous êtes connecté — lancez un agent :',
+    'welcome.more': 'Plus : `tokenmix --help` pour toutes les commandes · `tokenmix balance` pour votre solde',
     'login.keyMustStart': 'La clé API doit commencer par sk-tm-',
     'login.verifying': 'Vérification de la clé API sur {baseUrl} ...',
     'login.verifyFailed': 'Échec de la vérification de la clé API. Vérifiez sur https://tokenmix.ai/dashboard/keys',

package/dist/program.js

@@ -7,6 +7,7 @@ import { topupCommand } from './commands/topup.js';
 import { modelsCommand } from './commands/models.js';
 import { listCommand } from './commands/list.js';
 import { doctorCommand } from './commands/doctor.js';
+import { welcomeCommand } from './commands/welcome.js';
 import { registerAgentCommands } from './commands/agent-runner.js';
 import { t } from './i18n/index.js';
 // Read version from package.json so we never have to bump it in two places.
@@ -22,7 +23,9 @@ export function buildProgram(deps = {}) {
     program
         .name('tokenmix')
         .description(t('cmd.program'))
-        .version(pkg.version);
+        .version(pkg.version)
+        // Bare `tokenmix` (no command) shows a friendly onboarding screen, not raw help.
+        .action(welcomeCommand);
     program
         .command('login')
         .description(t('cmd.login'))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokenmix",
-  "version": "0.4.11",
+  "version": "0.4.13",
   "description": "Zero-config CLI to use any open-source coding agent with TokenMix as the unified LLM backend.",
   "type": "module",
   "bin": {