tokenmix 0.4.9 → 0.4.11

package/README.md

@@ -29,6 +29,8 @@ npx tokenmix roo               # print Roo Code VSCode configuration
 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
@@ -51,6 +53,8 @@ npx tokenmix login --key sk-tm-...             # supply API key directly (for CI
 | [Continue](https://github.com/continuedev/continue) | VSCode / JetBrains | config-only |
 | [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
 
@@ -72,6 +76,8 @@ tokenmix roo                        Print Roo Code configuration
 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

package/dist/agents/goose.js

@@ -0,0 +1,53 @@
+import { commandExists, run, captureRun } from '../utils/exec.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) {
+        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 };
+    }
+}
+async function configure(apiKey, baseUrl, defaultModel) {
+    // Goose reads GOOSE_PROVIDER/GOOSE_MODEL + OPENAI_HOST/OPENAI_API_KEY. NOTE:
+    // OPENAI_HOST is the BARE host — Goose appends /v1/chat/completions itself, so we
+    // pass baseUrl WITHOUT /v1 (unlike every other agent). GOOSE_DISABLE_KEYRING
+    // avoids an interactive keyring prompt. Verified end-to-end against tokenmix.
+    return {
+        envVars: {
+            GOOSE_PROVIDER: 'openai',
+            GOOSE_MODEL: defaultModel,
+            OPENAI_HOST: baseUrl,
+            OPENAI_API_KEY: apiKey,
+            GOOSE_DISABLE_KEYRING: '1',
+        },
+        notes: [t('goose.noteUsing'), t('goose.noteModel', { model: defaultModel })],
+    };
+}
+async function launch(args, env) {
+    // Pure pass-through: `tokenmix goose run -t "..."` → `goose run -t "..."` with our
+    // env. No flag injection, so info-only (`goose --version`) needs no special-casing.
+    await run(GOOSE_BIN, args, { env });
+}
+export const GooseAgent = {
+    id: 'goose',
+    displayName: 'Goose',
+    description: 'block/goose — on-machine AI agent (OpenAI-compatible)',
+    installMode: 'manual',
+    installCheck,
+    configure,
+    launch,
+};

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

@@ -7,6 +7,8 @@ import { RooAgent } from './roo.js';
 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,
@@ -18,6 +20,8 @@ export const AGENTS = [
     ContinueAgent,
     CodexAgent,
     QwenAgent,
+    GooseAgent,
+    OpenHandsAgent,
 ];
 export function findAgent(id) {
     return AGENTS.find((a) => a.id === id);

package/dist/commands/list.js

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

package/dist/i18n/messages.js

@@ -88,6 +88,8 @@ export const en = {
     'desc.continue': 'continuedev/continue — VSCode/JetBrains extension (config file)',
     '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.',
@@ -139,6 +141,14 @@ export const en = {
     // qwen configure notes (env-based like aider; launched with --auth-type openai)
     'qwen.noteUsing': 'Qwen Code will use TokenMix via its OpenAI-compatible mode — your ~/.qwen/settings.json is left untouched.',
     'qwen.noteModel': 'Default model: {model} — override with OPENAI_MODEL or `qwen --model`.',
+    // 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.',
     'cmd.login': 'Log in to TokenMix (default: browser device authorization)',
@@ -247,6 +257,8 @@ export const zh = {
     'desc.continue': 'continuedev/continue — VSCode/JetBrains 扩展（配置文件）',
     '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`。',
@@ -293,6 +305,12 @@ export const zh = {
     'codex.noteModel': '默认模型：{model} —— 可用 `--config model=...` 覆盖。',
     'qwen.noteUsing': 'Qwen Code 将通过其 OpenAI 兼容模式使用 TokenMix —— 不会改动你的 ~/.qwen/settings.json。',
     '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。',
     'cmd.login': '登录 TokenMix（默认：浏览器设备授权）',
@@ -392,6 +410,8 @@ export const ja = {
     'desc.continue': 'continuedev/continue — VSCode/JetBrains 拡張機能（設定ファイル）',
     '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 のログインは保存済みなので自動的に反映されます。',
@@ -433,6 +453,12 @@ export const ja = {
     'codex.noteModel': 'デフォルトモデル：{model} — `--config model=...` で上書きできます。',
     'qwen.noteUsing': 'Qwen Code は OpenAI 互換モードで TokenMix を使用します —— ~/.qwen/settings.json は変更されません。',
     '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 にログイン（デフォルト：ブラウザでのデバイス認証）',
     'cmd.loginKey': 'API キーを直接貼り付け（ブラウザ認証をスキップ、CI に便利）',
@@ -531,6 +557,8 @@ export const ko = {
     'desc.continue': 'continuedev/continue — VSCode/JetBrains 확장 (설정 파일)',
     '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 로그인이 이미 저장되어 있어 자동으로 적용됩니다.',
@@ -572,6 +600,12 @@ export const ko = {
     'codex.noteModel': '기본 모델: {model} — `--config model=...`으로 재정의할 수 있습니다.',
     'qwen.noteUsing': 'Qwen Code는 OpenAI 호환 모드로 TokenMix를 사용합니다 — ~/.qwen/settings.json은 변경되지 않습니다.',
     '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에 로그인 (기본값: 브라우저 기기 인증)',
     'cmd.loginKey': 'API 키를 직접 붙여넣기 (브라우저 절차 생략, CI에 유용)',
@@ -670,6 +704,8 @@ export const es = {
     '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',
     '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.',
@@ -711,6 +747,12 @@ export const es = {
     'codex.noteModel': 'Modelo por defecto: {model} — anúlalo con `--config model=...`.',
     'qwen.noteUsing': 'Qwen Code usará TokenMix mediante su modo compatible con OpenAI: tu ~/.qwen/settings.json no se modifica.',
     '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)',
     'cmd.loginKey': 'Pega una clave de API directamente (omite el navegador, útil para CI)',
@@ -809,6 +851,8 @@ export const fr = {
     'desc.continue': 'continuedev/continue — extension VSCode/JetBrains (fichier de configuration)',
     '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.',
@@ -850,6 +894,12 @@ export const fr = {
     'codex.noteModel': 'Modèle par défaut : {model} — remplacez-le avec `--config model=...`.',
     'qwen.noteUsing': 'Qwen Code utilisera TokenMix via son mode compatible OpenAI — votre ~/.qwen/settings.json n’est pas modifié.',
     '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)',
     '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.9",
+  "version": "0.4.11",
   "description": "Zero-config CLI to use any open-source coding agent with TokenMix as the unified LLM backend.",
   "type": "module",
   "bin": {
@@ -32,6 +32,8 @@
     "continue",
     "codex",
     "qwen-code",
+    "goose",
+    "openhands",
     "coding-agent"
   ],
   "license": "MIT",