tokenmix 0.4.10 → 0.4.12

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.
@@ -30,6 +31,7 @@ npx tokenmix continue          # print Continue config.yaml snippet
 npx tokenmix codex             # install + configure + start Codex
 npx tokenmix qwen              # install + configure + start Qwen Code
 npx tokenmix goose             # configure + start Goose (install it first)
+npx tokenmix openhands         # configure + start OpenHands (install it first)
 ```
 
 ### Alternative login modes
@@ -53,6 +55,7 @@ npx tokenmix login --key sk-tm-...             # supply API key directly (for CI
 | [Codex](https://github.com/openai/codex) | `npm i -g @openai/codex` | full auto |
 | [Qwen Code](https://github.com/QwenLM/qwen-code) | `npm i -g @qwen-code/qwen-code` | full auto |
 | [Goose](https://github.com/block/goose) | [install script](https://block.github.io/goose) | semi auto |
+| [OpenHands](https://github.com/All-Hands-AI/OpenHands) | `uv tool install openhands` (Python 3.12+) | semi auto |
 
 ## Commands
 
@@ -75,6 +78,7 @@ tokenmix continue                   Print Continue config.yaml snippet
 tokenmix codex [args...]            Launch Codex via TokenMix
 tokenmix qwen [args...]             Launch Qwen Code via TokenMix
 tokenmix goose [args...]            Launch Goose via TokenMix
+tokenmix openhands [args...]        Launch OpenHands via TokenMix
 ```
 
 ## Language
@@ -87,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/agents/openhands.js

@@ -0,0 +1,55 @@
+import { commandExists, run, captureRun } from '../utils/exec.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) {
+        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 };
+    }
+}
+async function configure(apiKey, baseUrl, defaultModel) {
+    // OpenHands reads LLM_API_KEY/LLM_MODEL/LLM_BASE_URL but ONLY when launched with
+    // --override-with-envs (injected in launch()). LLM_MODEL needs a LiteLLM provider
+    // prefix — `openai/` routes to the OpenAI-compatible path. Verified end-to-end.
+    return {
+        envVars: {
+            LLM_API_KEY: apiKey,
+            LLM_MODEL: `openai/${defaultModel}`,
+            LLM_BASE_URL: `${baseUrl}/v1`,
+            OPENHANDS_SUPPRESS_BANNER: '1',
+        },
+        notes: [t('openhands.noteUsing'), t('openhands.noteModel', { model: defaultModel })],
+    };
+}
+async function launch(args, env) {
+    // Info-only (`openhands --version`) arrives with an empty env — just forward.
+    if (!env.LLM_BASE_URL) {
+        await run(OPENHANDS_BIN, args, { env });
+        return;
+    }
+    // OpenHands ignores the LLM_* env vars unless --override-with-envs is passed.
+    await run(OPENHANDS_BIN, ['--override-with-envs', ...args], { env });
+}
+export const OpenHandsAgent = {
+    id: 'openhands',
+    displayName: 'OpenHands',
+    description: 'All-Hands-AI/OpenHands — autonomous coding agent (OpenAI-compatible)',
+    installMode: 'manual',
+    installCheck,
+    configure,
+    launch,
+};

package/dist/agents/registry.js

@@ -8,6 +8,7 @@ import { ContinueAgent } from './continue.js';
 import { CodexAgent } from './codex.js';
 import { QwenAgent } from './qwen.js';
 import { GooseAgent } from './goose.js';
+import { OpenHandsAgent } from './openhands.js';
 // Ordered by historical ARPU on tokenmix (highest first). New agents go to the bottom.
 export const AGENTS = [
     OpenCodeAgent,
@@ -20,6 +21,7 @@ export const AGENTS = [
     CodexAgent,
     QwenAgent,
     GooseAgent,
+    OpenHandsAgent,
 ];
 export function findAgent(id) {
     return AGENTS.find((a) => a.id === id);

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/list.js

@@ -39,6 +39,8 @@ function agentDesc(id, fallback) {
             return t('desc.qwen');
         case 'goose':
             return t('desc.goose');
+        case 'openhands':
+            return t('desc.openhands');
         default:
             return fallback;
     }

package/dist/i18n/messages.js

@@ -89,6 +89,7 @@ export const en = {
     'desc.codex': 'openai/codex — OpenAI coding agent CLI',
     'desc.qwen': 'QwenLM/qwen-code — terminal coding agent (OpenAI-compatible)',
     'desc.goose': 'block/goose — on-machine AI agent (OpenAI-compatible)',
+    'desc.openhands': 'All-Hands-AI/OpenHands — autonomous coding agent (OpenAI-compatible)',
     // 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.',
@@ -143,6 +144,10 @@ export const en = {
     // goose configure notes (env-based; Goose appends /v1/chat/completions to OPENAI_HOST)
     'goose.noteUsing': 'Goose will use TokenMix as its OpenAI provider — its keyring/config is left untouched.',
     'goose.noteModel': 'Default model: {model} — override with GOOSE_MODEL.',
+    // openhands configure notes (env via --override-with-envs; LLM_MODEL needs openai/ prefix)
+    'openhands.noteUsing': 'OpenHands will use TokenMix via LiteLLM (--override-with-envs) — your saved config is left untouched.',
+    'openhands.noteModel': 'Default model: openai/{model} — override with LLM_MODEL (keep the openai/ prefix).',
+    'openhands.hintInstall': 'OpenHands is not installed (needs Python 3.12+). Install it, then re-run `tokenmix openhands`:\n    {cmd}',
     'goose.hintInstall': 'Goose is not installed. Install it (see https://block.github.io/goose), then re-run `tokenmix goose`:\n    {cmd}',
     // command / option descriptions (--help)
     'cmd.program': 'Zero-config CLI to use any open-source coding agent with TokenMix as the unified LLM backend.',
@@ -253,6 +258,7 @@ export const zh = {
     'desc.codex': 'openai/codex — OpenAI 编程 agent CLI',
     'desc.qwen': 'QwenLM/qwen-code — 终端编程 agent（OpenAI 兼容）',
     'desc.goose': 'block/goose — 本机 AI agent（OpenAI 兼容）',
+    'desc.openhands': 'All-Hands-AI/OpenHands — 自主编程 agent（OpenAI 兼容）',
     // install hints
     'install.willInstallVia': '将自动安装：{cmd}',
     'aider.hintNeedPython': 'Aider 需要 Python 3。请从 https://python.org/downloads 安装 Python 3，然后重新运行 `tokenmix aider`。',
@@ -301,6 +307,9 @@ export const zh = {
     'qwen.noteModel': '默认模型：{model} —— 可用 OPENAI_MODEL 或 `qwen --model` 覆盖。',
     'goose.noteUsing': 'Goose 将以 TokenMix 作为其 OpenAI provider —— 不会改动它的 keyring/配置。',
     'goose.noteModel': '默认模型：{model} —— 可用 GOOSE_MODEL 覆盖。',
+    'openhands.noteUsing': 'OpenHands 将通过 LiteLLM（--override-with-envs）使用 TokenMix —— 不会改动你已保存的配置。',
+    'openhands.noteModel': '默认模型：openai/{model} —— 可用 LLM_MODEL 覆盖（保留 openai/ 前缀）。',
+    'openhands.hintInstall': 'OpenHands 未安装（需要 Python 3.12+）。请先安装，然后重新运行 `tokenmix openhands`：\n    {cmd}',
     'goose.hintInstall': 'Goose 未安装。请先安装（见 https://block.github.io/goose），然后重新运行 `tokenmix goose`：\n    {cmd}',
     // command / option descriptions (--help)
     'cmd.program': '零配置 CLI：以 TokenMix 作为统一 LLM 后端，驱动任意开源编程 agent。',
@@ -402,6 +411,7 @@ export const ja = {
     'desc.codex': 'openai/codex — OpenAI のコーディング agent CLI',
     'desc.qwen': 'QwenLM/qwen-code — ターミナルのコーディング agent（OpenAI 互換）',
     'desc.goose': 'block/goose — オンマシン AI agent（OpenAI 互換）',
+    '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 のログインは保存済みなので自動的に反映されます。',
@@ -445,6 +455,9 @@ export const ja = {
     'qwen.noteModel': 'デフォルトモデル：{model} — OPENAI_MODEL または `qwen --model` で上書きできます。',
     'goose.noteUsing': 'Goose は TokenMix を OpenAI プロバイダーとして使用します —— keyring/設定は変更されません。',
     'goose.noteModel': 'デフォルトモデル：{model} — GOOSE_MODEL で上書きできます。',
+    'openhands.noteUsing': 'OpenHands は LiteLLM（--override-with-envs）経由で TokenMix を使用します —— 保存済みの設定は変更されません。',
+    'openhands.noteModel': 'デフォルトモデル：openai/{model} — LLM_MODEL で上書きできます（openai/ プレフィックスは残してください）。',
+    'openhands.hintInstall': 'OpenHands がインストールされていません（Python 3.12+ が必要）。インストールしてから `tokenmix openhands` を再実行してください：\n    {cmd}',
     'goose.hintInstall': 'Goose がインストールされていません。インストール（https://block.github.io/goose 参照）してから `tokenmix goose` を再実行してください：\n    {cmd}',
     'cmd.program': 'TokenMix を統一 LLM バックエンドとして、あらゆるオープンソースのコーディング agent を使うためのゼロ設定 CLI。',
     'cmd.login': 'TokenMix にログイン（デフォルト：ブラウザでのデバイス認証）',
@@ -545,6 +558,7 @@ export const ko = {
     'desc.codex': 'openai/codex — OpenAI 코딩 agent CLI',
     'desc.qwen': 'QwenLM/qwen-code — 터미널 코딩 agent (OpenAI 호환)',
     'desc.goose': 'block/goose — 온디바이스 AI agent (OpenAI 호환)',
+    '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 로그인이 이미 저장되어 있어 자동으로 적용됩니다.',
@@ -588,6 +602,9 @@ export const ko = {
     'qwen.noteModel': '기본 모델: {model} — OPENAI_MODEL 또는 `qwen --model`으로 재정의할 수 있습니다.',
     'goose.noteUsing': 'Goose는 TokenMix를 OpenAI provider로 사용합니다 — keyring/설정은 변경되지 않습니다.',
     'goose.noteModel': '기본 모델: {model} — GOOSE_MODEL로 재정의할 수 있습니다.',
+    'openhands.noteUsing': 'OpenHands는 LiteLLM(--override-with-envs)을 통해 TokenMix를 사용합니다 — 저장된 설정은 변경되지 않습니다.',
+    'openhands.noteModel': '기본 모델: openai/{model} — LLM_MODEL로 재정의할 수 있습니다(openai/ 접두사 유지).',
+    'openhands.hintInstall': 'OpenHands가 설치되어 있지 않습니다(Python 3.12+ 필요). 설치 후 `tokenmix openhands`를 다시 실행하세요:\n    {cmd}',
     'goose.hintInstall': 'Goose가 설치되어 있지 않습니다. 설치(https://block.github.io/goose 참조) 후 `tokenmix goose`를 다시 실행하세요:\n    {cmd}',
     'cmd.program': 'TokenMix를 통합 LLM 백엔드로 사용하여 모든 오픈소스 코딩 agent를 쓰는 제로 설정 CLI.',
     'cmd.login': 'TokenMix에 로그인 (기본값: 브라우저 기기 인증)',
@@ -688,6 +705,7 @@ export const es = {
     'desc.codex': 'openai/codex — CLI del agente de programación de OpenAI',
     'desc.qwen': 'QwenLM/qwen-code — agente de programación de terminal (compatible con OpenAI)',
     'desc.goose': 'block/goose — agente de IA en tu máquina (compatible con OpenAI)',
+    '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.',
@@ -731,6 +749,9 @@ export const es = {
     'qwen.noteModel': 'Modelo por defecto: {model} — anúlalo con OPENAI_MODEL o `qwen --model`.',
     'goose.noteUsing': 'Goose usará TokenMix como su proveedor de OpenAI: su keyring/configuración no se modifica.',
     'goose.noteModel': 'Modelo por defecto: {model} — anúlalo con GOOSE_MODEL.',
+    'openhands.noteUsing': 'OpenHands usará TokenMix mediante LiteLLM (--override-with-envs): tu configuración guardada no se modifica.',
+    'openhands.noteModel': 'Modelo por defecto: openai/{model} — anúlalo con LLM_MODEL (mantén el prefijo openai/).',
+    'openhands.hintInstall': 'OpenHands no está instalado (requiere Python 3.12+). Instálalo y vuelve a ejecutar `tokenmix openhands`:\n    {cmd}',
     'goose.hintInstall': 'Goose no está instalado. Instálalo (consulta https://block.github.io/goose) y vuelve a ejecutar `tokenmix goose`:\n    {cmd}',
     '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)',
@@ -831,6 +852,7 @@ export const fr = {
     'desc.codex': 'openai/codex — CLI de l’agent de codage d’OpenAI',
     'desc.qwen': 'QwenLM/qwen-code — agent de codage en terminal (compatible OpenAI)',
     'desc.goose': 'block/goose — agent IA sur votre machine (compatible OpenAI)',
+    '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.',
@@ -874,6 +896,9 @@ export const fr = {
     'qwen.noteModel': 'Modèle par défaut : {model} — remplacez-le avec OPENAI_MODEL ou `qwen --model`.',
     'goose.noteUsing': 'Goose utilisera TokenMix comme fournisseur OpenAI — son keyring/sa configuration n’est pas modifié.',
     'goose.noteModel': 'Modèle par défaut : {model} — remplacez-le avec GOOSE_MODEL.',
+    'openhands.noteUsing': 'OpenHands utilisera TokenMix via LiteLLM (--override-with-envs) — votre configuration enregistrée n’est pas modifiée.',
+    'openhands.noteModel': 'Modèle par défaut : openai/{model} — remplacez-le avec LLM_MODEL (gardez le préfixe openai/).',
+    'openhands.hintInstall': 'OpenHands n’est pas installé (nécessite Python 3.12+). Installez-le, puis relancez `tokenmix openhands` :\n    {cmd}',
     'goose.hintInstall': 'Goose n’est pas installé. Installez-le (voir https://block.github.io/goose), puis relancez `tokenmix goose` :\n    {cmd}',
     '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)',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokenmix",
-  "version": "0.4.10",
+  "version": "0.4.12",
   "description": "Zero-config CLI to use any open-source coding agent with TokenMix as the unified LLM backend.",
   "type": "module",
   "bin": {
@@ -33,6 +33,7 @@
     "codex",
     "qwen-code",
     "goose",
+    "openhands",
     "coding-agent"
   ],
   "license": "MIT",