agentsw 0.3.0 → 0.5.0

package/README.md

@@ -65,6 +65,11 @@ npx agentsw               # zero install: opens the interactive menu
 npm install -g agentsw    # requires Node >= 22.12
 ```
 
+The provider sync and config management work on Linux, macOS, and Windows. On Windows,
+agentsw stores its own state under `%APPDATA%\agentsw`; native app-data locations are
+used for agents that require them. Set `AGENTSW_HOME` when running from Git Bash/WSL or
+when a portable home directory is desired.
+
 ## Quick start
 
 ```bash
@@ -195,7 +200,11 @@ asw remove myproxy --prune
   `apiKeyEnv: AGENTSW_<ID>_API_KEY`, the key goes into `$DSH_HOME/.credentials.yaml`
   (`refs:`, mode 0600). `$DSH_HOME` defaults to `~/.dsh`.
 - cc-switch's database is opened read-only and never written to.
-- The apps manager (install/upgrade) currently targets macOS/Linux.
+- The apps manager supports native Windows commands for Claude Code, Codex CLI, pi,
+  opencode, Hermes, and DeepSeek Harness. Oh My Pi and prime-agent still need their own
+  Windows installation method; WorkBuddy is installed and updated by its desktop app.
+- `OPENCODE_CONFIG_DIR`, `WORKBUDDY_CONFIG_DIR`, `CODEBUDDY_CONFIG_DIR`, `HERMES_HOME`,
+  and `DSH_HOME` can override native config locations.
 
 ## Language
 

package/README.zh-CN.md

@@ -64,6 +64,10 @@ npx agentsw               # 免安装，直接打开交互菜单
 npm install -g agentsw    # 需要 Node >= 22.12
 ```
 
+供应商同步与配置管理支持 Linux、macOS 和 Windows。Windows 下 agentsw 自身状态默认存放在
+`%APPDATA%\agentsw`，需要原生应用数据目录的智能体会使用对应目录。通过 Git Bash/WSL 运行，
+或需要可移植目录时，可以设置 `AGENTSW_HOME`。
+
 ## 快速开始
 
 ```bash
@@ -190,7 +194,11 @@ asw remove myproxy --prune
   `apiKeyEnv: AGENTSW_<ID>_API_KEY` 引用，密钥写入 `$DSH_HOME/.credentials.yaml`
   的 `refs:`（权限 0600）。`$DSH_HOME` 默认为 `~/.dsh`。
 - cc-switch 的数据库以只读方式打开，永不写入。
-- 安装管理器（install/upgrade）目前仅支持 macOS/Linux。
+- 安装管理器在 Windows 下为 Claude Code、Codex CLI、pi、opencode、Hermes 和 DeepSeek Harness
+  使用原生安装命令。Oh My Pi 与 prime-agent 仍需使用各自的 Windows 安装方式；WorkBuddy
+  由桌面应用自行安装和更新。
+- `OPENCODE_CONFIG_DIR`、`WORKBUDDY_CONFIG_DIR`、`CODEBUDDY_CONFIG_DIR`、`HERMES_HOME` 与
+  `DSH_HOME` 可覆盖原生配置目录。
 
 ## 语言
 

package/dist/apps.js

@@ -1,7 +1,7 @@
 import { execFileSync, execSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
-import { home, readJsonIfExists } from "./fsutil.js";
+import { appDataDir, home, readJsonIfExists } from "./fsutil.js";
 export const appPackages = [
     {
         id: "claude",
@@ -10,6 +10,7 @@ export const appPackages = [
         latest: { kind: "npm", name: "@anthropic-ai/claude-code" },
         installCmd: "curl -fsSL https://claude.ai/install.sh | bash",
         upgradeCmd: "claude update",
+        windowsInstallCmd: "npm install -g @anthropic-ai/claude-code@latest",
     },
     {
         id: "codex",
@@ -17,6 +18,7 @@ export const appPackages = [
         binary: "codex",
         latest: { kind: "npm", name: "@openai/codex" },
         installCmd: "npm install -g @openai/codex@latest",
+        windowsInstallCmd: "npm install -g @openai/codex@latest",
     },
     {
         id: "omp",
@@ -32,6 +34,7 @@ export const appPackages = [
         binary: "pi",
         latest: { kind: "npm", name: "@earendil-works/pi-coding-agent" },
         installCmd: "npm install -g @earendil-works/pi-coding-agent@latest",
+        windowsInstallCmd: "npm install -g @earendil-works/pi-coding-agent@latest",
     },
     {
         id: "prime",
@@ -47,6 +50,7 @@ export const appPackages = [
         latest: { kind: "npm", name: "opencode-ai" },
         installCmd: "curl -fsSL https://opencode.ai/install | bash",
         upgradeCmd: "opencode upgrade",
+        windowsInstallCmd: "npm install -g opencode-ai@latest",
     },
     {
         id: "hermes",
@@ -55,17 +59,20 @@ export const appPackages = [
         latest: { kind: "pypi", name: "hermes-agent" },
         installCmd: "uv tool install hermes-agent || pipx install hermes-agent",
         upgradeCmd: "uv tool upgrade hermes-agent || pipx upgrade hermes-agent",
+        windowsInstallCmd: "uv tool install hermes-agent || pipx install hermes-agent",
+        windowsUpgradeCmd: "uv tool upgrade hermes-agent || pipx upgrade hermes-agent",
     },
     {
         id: "workbuddy",
         name: "WorkBuddy",
         // Electron desktop app: version from its data dir; managed by its own updater.
         localVersion: () => {
-            const j = readJsonIfExists(path.join(home, ".workbuddy", "last-launch.json"));
+            const dir = workbuddyDataDir();
+            const j = readJsonIfExists(path.join(dir, "last-launch.json"));
             const v = (j?.version ?? j?.appVersion);
             if (v)
                 return v;
-            const r = readJsonIfExists(path.join(home, ".workbuddy", "app", "renderer-version.json"));
+            const r = readJsonIfExists(path.join(dir, "app", "renderer-version.json"));
             return r?.version ?? undefined;
         },
     },
@@ -75,13 +82,19 @@ export const appPackages = [
         binary: "dsh",
         latest: { kind: "npm", name: "@deepseek-ai/dsh" },
         installCmd: "npm install -g @deepseek-ai/dsh@latest",
+        windowsInstallCmd: "npm install -g @deepseek-ai/dsh@latest",
     },
 ];
+function workbuddyDataDir() {
+    return process.env.WORKBUDDY_CONFIG_DIR?.trim() || process.env.CODEBUDDY_CONFIG_DIR?.trim() ||
+        (process.platform === "win32" ? appDataDir("workbuddy") : path.join(home, ".workbuddy"));
+}
 const SEMVERISH = /\d+\.\d+(\.\d+)?([-.+][\w.-]+)?/;
 export function installedVersion(app) {
     if (app.binary) {
         try {
-            const out = execFileSync(app.binary, app.versionArgs ?? ["--version"], {
+            const binary = executableName(app.binary);
+            const out = execFileSync(binary, app.versionArgs ?? ["--version"], {
                 encoding: "utf8",
                 timeout: 15000,
                 stdio: ["ignore", "pipe", "pipe"],
@@ -126,7 +139,7 @@ export async function latestVersion(app) {
             case "brew": {
                 // Local tap metadata first (works for taps; refreshed by `brew update`), then core API.
                 try {
-                    const out = execSync(`brew info --json=v2 ${src.name}`, { encoding: "utf8", timeout: 30000 });
+                    const out = execSync(`brew info --json=v2 ${src.name}`, { encoding: "utf8", timeout: 30000, stdio: ["pipe", "pipe", "pipe"] });
                     const data = JSON.parse(out);
                     const stable = data.formulae?.[0]?.versions?.stable;
                     if (stable)
@@ -164,12 +177,38 @@ export function isNewer(installed, latest) {
 export function runShell(command) {
     execSync(command, { stdio: "inherit", env: process.env });
 }
+/** Resolve the platform-specific command while keeping the package table readable. */
+export function appCommand(app, action, platform = process.platform) {
+    if (platform === "win32")
+        return action === "install" ? app.windowsInstallCmd : app.windowsUpgradeCmd ?? app.windowsInstallCmd;
+    return action === "install" ? app.installCmd : app.upgradeCmd ?? app.installCmd;
+}
+function executableName(binary) {
+    if (process.platform !== "win32")
+        return binary;
+    for (const suffix of ["", ".cmd", ".exe", ".bat"]) {
+        const candidate = `${binary}${suffix}`;
+        if (binaryOnPath(candidate))
+            return candidate;
+    }
+    return binary;
+}
 export function binaryOnPath(binary) {
     const dirs = (process.env.PATH ?? "").split(path.delimiter);
     return dirs.some((d) => {
         try {
-            fs.accessSync(path.join(d, binary), fs.constants.X_OK);
-            return true;
+            const names = process.platform === "win32" && !path.extname(binary)
+                ? [binary, ...((process.env.PATHEXT ?? ".COM;.EXE;.BAT;.CMD").split(";").map((s) => `${binary}${s.toLowerCase()}`))]
+                : [binary];
+            return names.some((name) => {
+                try {
+                    fs.accessSync(path.join(d, name), process.platform === "win32" ? fs.constants.F_OK : fs.constants.X_OK);
+                    return true;
+                }
+                catch {
+                    return false;
+                }
+            });
         }
         catch {
             return false;

package/dist/commands.js

@@ -4,10 +4,11 @@ import { loadStore, saveStore, getProvider, configFile } from "./store.js";
 import { scanCandidates, normalizeUrl } from "./import.js";
 import { enrichModels, loadCatalog, searchCatalog } from "./modelsdev.js";
 import { resolveTargets, supportsProtocol, targets } from "./targets/index.js";
-import { discoverProviderModels } from "./discover.js";
-import { appPackages, installedVersion, isNewer, latestVersion, runShell } from "./apps.js";
+import { discoverProviderModels, probeProtocols } from "./discover.js";
+import { appCommand, appPackages, installedVersion, isNewer, latestVersion, runShell } from "./apps.js";
 import { drainPendingWrites, readTextIfExists, setDryRun } from "./fsutil.js";
 import { applyModelFilter } from "./filter.js";
+import { slugFromBaseUrl } from "./slug.js";
 import { t } from "./i18n.js";
 function fail(message) {
     process.stderr.write(pc.red(`error: ${message}\n`));
@@ -57,6 +58,13 @@ function modelRows(models) {
     ]);
 }
 const MODEL_HEADER = ["MODEL", "CTX", "IN", "OUT", "REASONING", "$IN/$OUT per M"];
+/** Print a dim hint when some models have no models.dev metadata. */
+function printUncatalogedHint(models) {
+    const bare = models.filter((m) => m.contextWindow === undefined && !m.cost);
+    if (bare.length > 0) {
+        console.log(pc.dim(`${bare.length} model(s) have no models.dev metadata (shown as "-")`));
+    }
+}
 /** Guess the models.dev provider whose API host matches the configured baseUrl. */
 function guessProviderHint(catalog, baseUrl) {
     if (!catalog)
@@ -178,7 +186,11 @@ export async function cmdAdd(opts) {
     const manualIds = (answers.models ?? "").split(",").map((s) => s.trim()).filter(Boolean);
     let modelIds = manualIds;
     const modelFilter = parseFilterOpts(opts);
-    if (opts.discover) {
+    const shouldDiscover = opts.discover || manualIds.length === 0;
+    if (shouldDiscover) {
+        if (!opts.discover) {
+            process.stderr.write(pc.dim(t("add.autoDiscover") + "\n"));
+        }
         process.stderr.write(pc.dim(`${t("add.discovering", { url: baseUrl })}\n`));
         const discovered = await discoverProviderModels({ baseUrl, apiKey: answers.apiKey, protocol });
         console.log(t("add.providerLists", { count: discovered.length }));
@@ -222,8 +234,118 @@ export async function cmdAdd(opts) {
     console.log(pc.green(t("add.saved", { status: savedStatus, id: pc.bold(provider.id), protocol })));
     console.log(t("add.metadata", { matched, total: models.length }) + (hint ? t("add.providerHint", { hint }) : ""));
     console.log(table(modelRows(models), MODEL_HEADER));
+    printUncatalogedHint(models);
     console.log(pc.dim(`\n${t("add.next", { id: provider.id })}`));
 }
+/** Shared logic to create and save a single provider from discovered models. */
+async function createProvider(opts) {
+    const { store, id, name, protocol, openaiApi, baseUrl, apiKey, modelIds, modelFilter } = opts;
+    const catalog = await loadCatalog();
+    const hint = guessProviderHint(catalog, baseUrl);
+    const models = enrichModels(catalog, modelIds, hint);
+    const matched = models.filter((m) => m.contextWindow !== undefined).length;
+    const defaultModel = opts.defaultModel ?? modelIds[0];
+    if (!modelIds.includes(defaultModel))
+        fail(t("add.defaultMissing", { model: defaultModel }));
+    const provider = {
+        id,
+        name,
+        protocol,
+        ...(openaiApi ? { openaiApi } : {}),
+        baseUrl,
+        apiKey,
+        models,
+        defaultModel,
+        smallModel: opts.smallModel,
+        reasoningEffort: opts.reasoningEffort,
+        modelsDevId: hint,
+        modelFilter,
+    };
+    const existed = store.providers[provider.id] !== undefined;
+    store.providers[provider.id] = provider;
+    if (!store.active)
+        store.active = provider.id;
+    const savedStatus = t(existed ? "add.updated" : "add.added");
+    console.log(pc.green(t("add.saved", { status: savedStatus, id: pc.bold(provider.id), protocol })));
+    console.log(t("add.metadata", { matched, total: models.length }) + (hint ? t("add.providerHint", { hint }) : ""));
+    console.log(table(modelRows(models), MODEL_HEADER));
+    printUncatalogedHint(models);
+    return provider;
+}
+/**
+ * Quick add: only base URL + API key needed. Auto-detects protocol(s) by probing
+ * /v1/models with both openai and anthropic auth headers. When both succeed,
+ * creates two providers with -openai / -anthropic suffixes.
+ */
+export async function cmdQuickAdd(opts) {
+    const store = loadStore();
+    const interactive = process.stdin.isTTY && !opts.yes;
+    let baseUrl;
+    let apiKey;
+    let baseId;
+    if (interactive) {
+        const answers = await prompts([
+            { type: "text", name: "baseUrl", message: t("add.baseUrl"), validate: (v) => (/^https?:\/\//.test(v) ? true : t("add.baseUrlInvalid")) },
+            { type: "password", name: "apiKey", message: t("add.apiKey") },
+        ], { onCancel: () => fail(t("add.cancelled")) });
+        baseUrl = answers.baseUrl.replace(/\/+$/, "");
+        apiKey = answers.apiKey;
+        baseId = opts.id ?? slugFromBaseUrl(baseUrl);
+    }
+    else {
+        if (!opts.baseUrl)
+            fail(t("add.fieldRequired", { field: "base-url" }));
+        if (!opts.apiKey)
+            fail(t("add.fieldRequired", { field: "api-key" }));
+        baseUrl = opts.baseUrl.replace(/\/+$/, "");
+        apiKey = opts.apiKey;
+        baseId = opts.id ?? slugFromBaseUrl(baseUrl);
+    }
+    process.stderr.write(pc.dim(t("quick.probing", { url: baseUrl }) + "\n"));
+    const protocols = await probeProtocols({ baseUrl, apiKey });
+    if (protocols.length === 0) {
+        fail(t("quick.noProtocol"));
+    }
+    const modelFilter = parseFilterOpts(opts);
+    const multi = protocols.length > 1;
+    const createdIds = [];
+    for (const protocol of protocols) {
+        const suffix = multi ? `-${protocol}` : "";
+        const id = `${baseId}${suffix}`;
+        const name = multi ? `${baseId} (${protocol})` : baseId;
+        process.stderr.write(pc.dim(`${t("add.discovering", { url: baseUrl })} [${protocol}]\n`));
+        const discovered = await discoverProviderModels({ baseUrl, apiKey, protocol });
+        console.log(t("add.providerLists", { count: discovered.length }));
+        let modelIds = discovered;
+        const pinned = [...(opts.defaultModel ? [opts.defaultModel] : [])];
+        const outcome = applyModelFilter(modelIds, modelFilter, pinned);
+        reportDropped(outcome.dropped);
+        modelIds = outcome.kept;
+        if (modelIds.length === 0) {
+            console.log(pc.yellow(t("quick.noModelsAfterFilter", { id })));
+            continue;
+        }
+        const provider = await createProvider({
+            store,
+            id,
+            name,
+            protocol,
+            baseUrl,
+            apiKey,
+            modelIds,
+            defaultModel: opts.defaultModel,
+            smallModel: opts.smallModel,
+            reasoningEffort: opts.reasoningEffort,
+            modelFilter,
+        });
+        createdIds.push(provider.id);
+        console.log(pc.dim(`\n${t("add.next", { id: provider.id })}`));
+    }
+    saveStore(store);
+    if (createdIds.length > 0) {
+        console.log(pc.green(t("quick.summary", { count: createdIds.length, ids: createdIds.join(", ") })));
+    }
+}
 export function cmdList() {
     const store = loadStore();
     const ids = Object.keys(store.providers);
@@ -399,6 +521,7 @@ export async function cmdModels(query, opts) {
         const provider = getProvider(store, opts.provider);
         console.log(`${pc.bold(provider.id)} (${provider.protocol}) · ${provider.baseUrl}`);
         console.log(table(modelRows(provider.models), MODEL_HEADER));
+        printUncatalogedHint(provider.models);
         return;
     }
     const catalog = await loadCatalog({ refresh: opts.refresh });
@@ -463,6 +586,7 @@ export async function cmdDiscover(id, opts) {
         (added.length ? `\n  new: ${added.join(", ")}` : "") +
         (gone.length ? `\n  removed upstream: ${gone.join(", ")}` : ""));
     console.log(table(modelRows(provider.models), MODEL_HEADER));
+    printUncatalogedHint(provider.models);
     if (opts.sync) {
         console.log("");
         await cmdSync({ provider: id, apps: opts.apps });
@@ -477,13 +601,14 @@ async function collectAppRows() {
             Promise.resolve(installedVersion(app)),
             latestVersion(app),
         ]);
+        const knownInstalled = !!installed && installed !== "?";
         return {
             id: app.id,
             name: app.name,
             installed,
             latest,
-            upgradable: !!installed && installed !== "?" && !!latest && isNewer(installed, latest),
-            installable: !installed && !!app.installCmd,
+            upgradable: knownInstalled && !!latest && isNewer(installed, latest),
+            installable: !installed && !!appCommand(app, "install"),
         };
     }));
 }
@@ -496,11 +621,13 @@ export async function cmdApps() {
         r.latest ?? pc.dim("?"),
         r.upgradable
             ? pc.yellow("upgrade available")
-            : r.installed
-                ? pc.green("up to date")
-                : r.installable
+            : !r.installed
+                ? r.installable
                     ? pc.dim("installable")
-                    : pc.dim("-"),
+                    : pc.dim("-")
+                : r.installed === "?" || !r.latest
+                    ? pc.dim("unknown")
+                    : pc.green("up to date"),
     ]), ["APP", "INSTALLED", "LATEST", "STATUS"]));
     const upgradable = rows.filter((r) => r.upgradable).map((r) => r.id);
     if (upgradable.length)
@@ -510,15 +637,16 @@ export async function cmdInstall(id) {
     const app = appPackages.find((a) => a.id === id);
     if (!app)
         fail(`unknown app "${id}" (supported: ${appPackages.map((a) => a.id).join(", ")})`);
-    if (!app.installCmd)
-        fail(`${app.name} is not CLI-installable (desktop app manages itself)`);
+    const installCmd = appCommand(app, "install");
+    if (!installCmd)
+        fail(`${app.name} is not installable on ${process.platform} (or is managed by its desktop app)`);
     const installed = installedVersion(app);
     if (installed) {
         console.log(`${app.name} already installed (${installed}); use \`agentsw upgrade ${id}\``);
         return;
     }
-    console.log(`installing ${app.name}: ${pc.dim(app.installCmd)}`);
-    runShell(app.installCmd);
+    console.log(`installing ${app.name}: ${pc.dim(installCmd)}`);
+    runShell(installCmd);
     console.log(pc.green(`${app.name} installed: ${installedVersion(app) ?? "version unknown"}`));
 }
 export async function cmdUpgrade(ids) {
@@ -538,7 +666,7 @@ export async function cmdUpgrade(ids) {
         selected = appPackages.filter((a) => upgradable.includes(a.id));
     }
     for (const app of selected) {
-        const cmd = app.upgradeCmd ?? app.installCmd;
+        const cmd = appCommand(app, "upgrade");
         if (!cmd) {
             console.log(`${pc.yellow("skip")} ${app.id}: not CLI-upgradable`);
             continue;

package/dist/discover.js

@@ -19,3 +19,33 @@ export async function discoverProviderModels(opts) {
         throw new Error(`${url} returned no models`);
     return [...new Set(ids)].sort();
 }
+/**
+ * Probe which wire protocols an endpoint supports by hitting /v1/models
+ * with each protocol's auth headers. Returns the protocols that responded
+ * with a valid model list (at least one model id).
+ */
+export async function probeProtocols(opts) {
+    const base = opts.baseUrl.replace(/\/+$/, "");
+    const url = /\/v\d+$/.test(base) ? `${base}/models` : `${base}/v1/models`;
+    const attempts = [
+        { protocol: "openai", headers: { authorization: `Bearer ${opts.apiKey}` } },
+        { protocol: "anthropic", headers: { "x-api-key": opts.apiKey, "anthropic-version": "2023-06-01" } },
+    ];
+    const supported = [];
+    for (const a of attempts) {
+        try {
+            const res = await fetch(url, { headers: a.headers, signal: AbortSignal.timeout(15000) });
+            if (!res.ok)
+                continue;
+            const body = (await res.json());
+            const rows = body.data ?? body.models ?? [];
+            const ids = rows.map((r) => r.id).filter((id) => typeof id === "string" && id.length > 0);
+            if (ids.length > 0)
+                supported.push(a.protocol);
+        }
+        catch {
+            /* network error or timeout — protocol not supported */
+        }
+    }
+    return supported;
+}

package/dist/fsutil.js

@@ -1,7 +1,25 @@
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
-export const home = os.homedir();
+// AGENTSW_HOME is an explicit portable/test override. Native Windows otherwise
+// uses USERPROFILE/os.homedir(), while Unix follows HOME as expected.
+export const home = process.env.AGENTSW_HOME?.trim() ||
+    (process.platform === "win32" ? process.env.USERPROFILE?.trim() || os.homedir() : process.env.HOME?.trim() || os.homedir());
+/** Windows roaming application data; Unix keeps the existing XDG-style layout. */
+export function appDataDir(app) {
+    // AGENTSW_HOME is also a portable-layout override for tests and Git Bash.
+    if (process.platform === "win32" && !process.env.AGENTSW_HOME) {
+        return path.join(process.env.APPDATA?.trim() || path.join(home, "AppData", "Roaming"), app);
+    }
+    return path.join(home, ".config", app);
+}
+/** Windows local application data, used by agents whose native config lives there. */
+export function localAppDataDir(app) {
+    if (process.platform === "win32" && !process.env.AGENTSW_HOME) {
+        return path.join(process.env.LOCALAPPDATA?.trim() || path.join(home, "AppData", "Local"), app);
+    }
+    return path.join(home, `.${app}`);
+}
 export function expandHome(p) {
     return p.startsWith("~") ? path.join(home, p.slice(1)) : p;
 }
@@ -43,7 +61,7 @@ export function writeFileAtomic(file, content, mode) {
     fs.writeFileSync(tmp, content, mode !== undefined ? { mode } : undefined);
     fs.renameSync(tmp, file);
 }
-export const backupsDir = path.join(home, ".config", "agentsw", "backups");
+export const backupsDir = path.join(appDataDir("agentsw"), "backups");
 /** Copy `file` into the backups dir with a timestamp suffix. No-op if file missing. */
 export function backupFile(file) {
     if (!fs.existsSync(file) || dryRun)

package/dist/i18n.js

@@ -7,6 +7,7 @@ const messages = {
     "error.language": { en: "unsupported language \"{value}\"; use en or zh-CN", "zh-CN": "不支持语言 \"{value}\";请使用 en 或 zh-CN" },
     "error.unknownCommand": { en: "unknown command '{value}', see --help", "zh-CN": "未知命令 '{value}',请查看 --help" },
     "cmd.add": { en: "add or update a provider (interactive when flags are omitted)", "zh-CN": "添加或更新供应商(省略参数时进入交互流程)" },
+    "cmd.quick": { en: "quick add — auto-detect protocol(s) and models from just base URL + API key", "zh-CN": "快速添加 — 只需 base URL + API key,自动探测协议和模型" },
     "cmd.list": { en: "list configured providers", "zh-CN": "列出已配置供应商" },
     "cmd.remove": { en: "remove a provider", "zh-CN": "删除供应商" },
     "cmd.prune": { en: "remove a provider's entries from app configs (keeps it in agentsw)", "zh-CN": "从应用配置移除供应商条目(仍保留在 agentsw)" },
@@ -99,7 +100,7 @@ const messages = {
     "add.baseUrl": { en: "base URL", "zh-CN": "base URL" },
     "add.baseUrlInvalid": { en: "must start with http(s)://", "zh-CN": "必须以 http(s):// 开头" },
     "add.apiKey": { en: "API key", "zh-CN": "API key" },
-    "add.models": { en: "model ids (comma separated)", "zh-CN": "模型 id(逗号分隔)" },
+    "add.models": { en: "model ids (comma separated, or leave blank to auto-discover)", "zh-CN": "模型 id(逗号分隔，留空则自动发现)" },
     "add.cancelled": { en: "cancelled", "zh-CN": "已取消" },
     "import.already": { en: "already configured as {id}", "zh-CN": "已配置为 {id}" },
     "import.noneNew": { en: "nothing new to import (every discovered provider is already configured)", "zh-CN": "没有可导入的新供应商(发现项均已配置)" },
@@ -137,6 +138,7 @@ const messages = {
     "add.discovering": { en: "discovering models from {url} ...", "zh-CN": "正在从 {url} 发现模型..." },
     "add.providerLists": { en: "provider lists {count} model(s) via /v1/models", "zh-CN": "供应商通过 /v1/models 返回 {count} 个模型" },
     "add.atLeastOne": { en: "at least one model id is required (or use --discover)", "zh-CN": "至少需要一个模型 id(或使用 --discover)" },
+    "add.autoDiscover": { en: "no models entered — discovering from /v1/models automatically", "zh-CN": "未输入模型 — 自动从 /v1/models 发现" },
     "add.defaultMissing": { en: "default model {model} is not in the model list", "zh-CN": "默认模型 {model} 不在模型列表中" },
     "add.smallMissing": { en: "small model {model} is not in the model list", "zh-CN": "小型模型 {model} 不在模型列表中" },
     "add.added": { en: "added", "zh-CN": "已添加" },
@@ -145,6 +147,11 @@ const messages = {
     "add.metadata": { en: "models.dev metadata: {matched}/{total} models matched", "zh-CN": "models.dev 元数据:匹配 {matched}/{total} 个模型" },
     "add.providerHint": { en: " (provider hint: {hint})", "zh-CN": " (供应商提示:{hint})" },
     "add.next": { en: "next: agentsw use {id}", "zh-CN": "下一步: agentsw use {id}" },
+    "quick.probing": { en: "probing protocols at {url} ...", "zh-CN": "正在探测 {url} 支持的协议..." },
+    "quick.noProtocol": { en: "no supported protocol found at this endpoint (tried openai and anthropic)", "zh-CN": "该端点未检测到支持的协议(已尝试 openai 和 anthropic)" },
+    "quick.noModelsAfterFilter": { en: "{id}: no models left after filtering, skipping", "zh-CN": "{id}: 过滤后无剩余模型,跳过" },
+    "quick.summary": { en: "created {count} provider(s): {ids}", "zh-CN": "创建了 {count} 个供应商: {ids}" },
+    "menu.quickAdd": { en: "quick add (auto-detect protocol + models)", "zh-CN": "快速添加(自动探测协议 + 模型)" },
     "import.skip": { en: "skip", "zh-CN": "跳过" },
     "import.modelsCount": { en: "{count} models", "zh-CN": "{count} 个模型" },
     "table.protocol": { en: "PROTOCOL", "zh-CN": "协议" },

package/dist/import.js

@@ -4,7 +4,16 @@ import { targets } from "./targets/index.js";
 export function normalizeUrl(u) {
     return u.replace(/\/+$/, "");
 }
-const matchKey = (protocol, baseUrl) => `${protocol}|${normalizeUrl(baseUrl)}`;
+/** True when a base URL already names the API version, e.g. `.../v1`. */
+const hasApiVersion = (baseUrl) => /\/v\d+(?:beta\d*)?$/i.test(baseUrl);
+/**
+ * Endpoint identity for dedupe. Apps disagree about who owns the `/v1` segment:
+ * omp/pi/opencode store it in the base URL, while Codex (and cc-switch's Codex
+ * rows) leave it off because the client appends it. `https://host` and
+ * `https://host/v1` on one protocol are the same upstream, so they must merge
+ * into one provider instead of importing twice.
+ */
+const matchKey = (protocol, baseUrl) => `${protocol}|${normalizeUrl(baseUrl).replace(/\/v\d+(?:beta\d*)?$/i, "")}`;
 /** pure merge: dedupe candidates by protocol+baseUrl, union models, keep first resolved key */
 export function mergeCandidates(rows, existing) {
     const merged = new Map();
@@ -29,6 +38,10 @@ export function mergeCandidates(rows, existing) {
                 cur.models.push(m);
         if (!cur.defaultModel && c.defaultModel)
             cur.defaultModel = c.defaultModel;
+        // keep the variant that names the API version: model discovery and most adapters
+        // need the full endpoint, and only Codex fills the segment in itself
+        if (!hasApiVersion(cur.baseUrl) && hasApiVersion(normalizeUrl(c.baseUrl)))
+            cur.baseUrl = normalizeUrl(c.baseUrl);
         // responses wins: an endpoint one app drives over /v1/responses serves it for all of them,
         // and codex speaks nothing else
         if (c.openaiApi === "responses" || !cur.openaiApi)

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { readFileSync } from "node:fs";
 import { Command, InvalidArgumentError } from "commander";
-import { cmdAdd, cmdApps, cmdDiscover, cmdImport, cmdInstall, cmdList, cmdModels, cmdRefreshMeta, cmdPrune, cmdRemove, cmdStatus, cmdSync, cmdUpgrade, cmdUse, } from "./commands.js";
+import { cmdAdd, cmdQuickAdd, cmdApps, cmdDiscover, cmdImport, cmdInstall, cmdList, cmdModels, cmdRefreshMeta, cmdPrune, cmdRemove, cmdStatus, cmdSync, cmdUpgrade, cmdUse, } from "./commands.js";
 import { detectSystemLocale, extractCliLocale, normalizeLocale, setLocale, t } from "./i18n.js";
 import { cmdMenu } from "./menu.js";
 import { loadStore } from "./store.js";
@@ -54,6 +54,20 @@ program
     .option("--models-dev <id>", t("opt.modelsDev"))
     .option("-y, --yes", t("opt.yes"))
     .action(cmdAdd);
+program
+    .command("quick")
+    .description(t("cmd.quick"))
+    .option("--id <slug>", t("opt.id"))
+    .option("--base-url <url>", t("opt.baseUrl"))
+    .option("--api-key <key>", t("opt.apiKey"))
+    .option("--default-model <id>", t("opt.defaultModel"))
+    .option("--small-model <id>", t("opt.smallModel"))
+    .option("--reasoning-effort <level>", t("opt.reasoning"))
+    .option("--include <globs>", t("opt.include"))
+    .option("--exclude <globs>", t("opt.exclude"))
+    .option("--no-dedup", t("opt.noDedup"))
+    .option("-y, --yes", t("opt.yes"))
+    .action(cmdQuickAdd);
 program.command("list").alias("ls").description(t("cmd.list")).action(cmdList);
 program
     .command("remove <id>")

package/dist/menu.js

@@ -1,6 +1,6 @@
 import pc from "picocolors";
 import prompts from "prompts";
-import { cmdAdd, cmdApps, cmdDiscover, cmdImport, cmdList, cmdRemove, cmdStatus, cmdSync, cmdUpgrade, cmdUse, } from "./commands.js";
+import { cmdAdd, cmdQuickAdd, cmdApps, cmdDiscover, cmdImport, cmdList, cmdRemove, cmdStatus, cmdSync, cmdUpgrade, cmdUse, } from "./commands.js";
 import { getLocale, setLocale, t } from "./i18n.js";
 import { loadStore, saveStore } from "./store.js";
 function bye() {
@@ -74,6 +74,7 @@ export async function cmdMenu() {
             hint: t("menu.selectInstructions"),
             choices: [
                 { title: t("menu.add"), value: "add" },
+                { title: t("menu.quickAdd"), value: "quickAdd" },
                 { title: t("menu.import"), value: "import" },
                 { title: t("menu.use"), value: "use" },
                 { title: t("menu.status"), value: "status" },
@@ -88,7 +89,10 @@ export async function cmdMenu() {
         }, cancel);
         if (action === undefined || action === "quit")
             return;
-        if (action === "add") {
+        if (action === "quickAdd") {
+            await cmdQuickAdd({});
+        }
+        else if (action === "add") {
             const { src } = await prompts({
                 type: "select",
                 name: "src",

package/dist/sources/ccswitch.js

@@ -2,11 +2,13 @@ import fs from "node:fs";
 import { createRequire } from "node:module";
 import path from "node:path";
 import { parse as parseToml } from "smol-toml";
-import { home } from "../fsutil.js";
+import { appDataDir, home } from "../fsutil.js";
 import { slugFromBaseUrl } from "../slug.js";
 import { classifyApi } from "../targets/wire.js";
 /** cc-switch (the Tauri desktop switcher) keeps every managed app's providers in one SQLite file. */
-const storeFile = path.join(home, ".cc-switch", "cc-switch.db");
+const storeFile = process.platform === "win32" && !process.env.AGENTSW_HOME
+    ? path.join(appDataDir("cc-switch"), "cc-switch.db")
+    : path.join(home, ".cc-switch", "cc-switch.db");
 /** Source id shown in the `import` preview. */
 export const CC_SWITCH_SOURCE = "cc-switch";
 /** Claude Code / Claude Desktop rows: the env block, same shape agentsw's claude adapter writes. */

package/dist/store.js

@@ -1,6 +1,6 @@
 import path from "node:path";
-import { home, readJsonIfExists, writeFileAtomic } from "./fsutil.js";
-export const configDir = path.join(home, ".config", "agentsw");
+import { appDataDir, readJsonIfExists, writeFileAtomic } from "./fsutil.js";
+export const configDir = appDataDir("agentsw");
 export const configFile = path.join(configDir, "config.json");
 export function loadStore() {
     const store = readJsonIfExists(configFile);

package/dist/targets/dsh.js

@@ -1,12 +1,12 @@
 import fs from "node:fs";
 import path from "node:path";
 import YAML from "yaml";
-import { backupFile, expandHome, home, readTextIfExists, writeFileAtomic } from "../fsutil.js";
+import { backupFile, expandHome, home, localAppDataDir, readTextIfExists, writeFileAtomic } from "../fsutil.js";
 import { apiValue, classifyApi, mergeModels } from "./wire.js";
 /** `$DSH_HOME`, or `~/.dsh` (packages/util/home-paths `resolveDshHome`). */
 function dshHome() {
     const env = process.env.DSH_HOME?.trim();
-    return env ? expandHome(env) : path.join(home, ".dsh");
+    return env ? expandHome(env) : process.platform === "win32" ? localAppDataDir("dsh") : path.join(home, ".dsh");
 }
 /**
  * Settings document: `<harness home>/settings.yaml` by default; the extension

package/dist/targets/hermes.js

@@ -1,15 +1,15 @@
 import fs from "node:fs";
 import path from "node:path";
 import YAML from "yaml";
-import { backupFile, readTextIfExists, writeFileAtomic } from "../fsutil.js";
+import { backupFile, home, localAppDataDir, readTextIfExists, writeFileAtomic } from "../fsutil.js";
 function hermesHome() {
     const env = process.env.HERMES_HOME?.trim();
     if (env)
         return env;
-    if (process.platform === "win32" && process.env.LOCALAPPDATA) {
-        return path.join(process.env.LOCALAPPDATA, "hermes");
+    if (process.platform === "win32") {
+        return localAppDataDir("hermes");
     }
-    return path.join(process.env.HOME ?? "", ".hermes");
+    return path.join(home, ".hermes");
 }
 /**
  * hermes (NousResearch): providers dict + model section in ~/.hermes/config.yaml,

package/dist/targets/opencode.js

@@ -1,7 +1,8 @@
 import fs from "node:fs";
 import path from "node:path";
-import { backupFile, home, readJsonIfExists, writeFileAtomic } from "../fsutil.js";
-const configFile = path.join(home, ".config", "opencode", "opencode.json");
+import { appDataDir, backupFile, readJsonIfExists, writeFileAtomic } from "../fsutil.js";
+const configDir = process.env.OPENCODE_CONFIG_DIR?.trim() || appDataDir("opencode");
+const configFile = path.join(configDir, "opencode.json");
 /**
  * opencode: custom providers in ~/.config/opencode/opencode.json "provider" map,
  * backed by @ai-sdk/openai-compatible or @ai-sdk/anthropic npm loaders.

package/dist/targets/workbuddy.js

@@ -1,9 +1,10 @@
 import fs from "node:fs";
 import path from "node:path";
-import { backupFile, home, readJsonIfExists, writeFileAtomic } from "../fsutil.js";
+import { appDataDir, backupFile, home, readJsonIfExists, writeFileAtomic } from "../fsutil.js";
 import { slugFromBaseUrl } from "../slug.js";
 function configDir() {
-    return process.env.WORKBUDDY_CONFIG_DIR ?? process.env.CODEBUDDY_CONFIG_DIR ?? path.join(home, ".workbuddy");
+    return process.env.WORKBUDDY_CONFIG_DIR?.trim() ?? process.env.CODEBUDDY_CONFIG_DIR?.trim() ??
+        (process.platform === "win32" ? appDataDir("workbuddy") : path.join(home, ".workbuddy"));
 }
 /**
  * models.json accepts a raw array (desktop writes) or {models, availableModels} (CLI writes).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentsw",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "CLI provider switcher for coding agents: manage OpenAI/Anthropic-protocol providers in one place and sync them, with models.dev metadata, into Claude Code, Codex, omp, pi, prime-agent, opencode, Hermes, WorkBuddy and DeepSeek Harness",
   "type": "module",
   "repository": {