tokenmix 0.4.12 → 0.4.13

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.12",
+  "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": {