agentsw 0.10.1 → 0.10.2

package/README.md

@@ -17,20 +17,7 @@ without touching the settings you hand-tuned.
 
 </div>
 
-```console
-$ asw use myproxy -m glm-5.3-flash
-switching to myproxy (openai) · default model glm-5.3-flash
-
-skip claude    Claude Code does not support openai-protocol providers
-ok   codex     ~/.codex/config.toml, ~/.codex/auth.json
-               backup: ~/.config/agentsw/backups/transaction-<unique>
-ok   omp       ~/.omp/agent/models.yml
-               select in omp with: omp --model myproxy/glm-5.3-flash
-skip pi        pi not detected (pass --apps pi to force)
-ok   opencode  ~/.config/opencode/opencode.json
-ok   dsh       ~/.dsh/settings.yaml, ~/.dsh/.credentials.yaml
-               select in dsh with the model picker, or run: dsh web
-```
+![asw use myproxy writes one provider into nine coding agents](https://raw.githubusercontent.com/tchivs/agentsw/main/docs/demo.gif)
 
 `agentsw` and the short `asw` are the same binary.
 
@@ -54,9 +41,37 @@ ok   dsh       ~/.dsh/settings.yaml, ~/.dsh/.credentials.yaml
 - **Wire-aware.** `/v1/chat/completions` and `/v1/responses` are different endpoints;
   agentsw tracks which one a provider speaks and never downgrades a working one.
 
-Want a GUI, MCP/Skills sync, a usage dashboard or a local failover proxy? Use
-[cc-switch](https://github.com/farion1231/cc-switch) — it is excellent at that, and agentsw
-imports from it rather than competing with it.
+## How it compares
+
+Two projects do most of this better than agentsw does, and both are worth your time:
+
+- **[cc-switch](https://github.com/farion1231/cc-switch)** — a desktop app (Tauri) for ten tools:
+  one-click switching, 90+ provider presets, MCP/Skills/Prompts management, local routing and
+  failover with API-format conversion, a usage and cost dashboard, a session manager, and
+  WebDAV/S3 sync.
+- **[cc-switch-cli](https://github.com/SaladDay/cc-switch-cli)** — the community CLI fork of the
+  same idea: TUI plus scriptable subcommands, seven tools, MCP and skills, a daemon proxy with
+  token accounting, SQLite-backed state.
+
+Between them they cover Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, Hermes,
+OpenClaw, Pi, Grok Build and MiniMax Code. agentsw covers a different nine — Claude Code, Codex,
+omp, pi, prime-agent, opencode, Hermes, WorkBuddy and DeepSeek Harness — **four of which neither
+other tool writes at all.**
+
+| | agentsw | cc-switch | cc-switch-cli |
+|---|---|---|---|
+| Interface | CLI, `--json` for scripts | desktop GUI | TUI + CLI |
+| Model metadata (models.dev + AI Gateway) written into each app's own fields | **yes** | no | no |
+| MCP / Skills / Prompts management | — | yes | yes |
+| Routing, API-format conversion, failover | — | yes | yes |
+| Usage and cost dashboard | — | yes | yes |
+| Presets, sessions, cloud sync, deep links | — | yes | partial |
+| Reads the other tool's provider store | yes — read-only `import` | — | — |
+
+The honest summary: **if you want a GUI, MCP management, or a failover proxy, use cc-switch.** If
+you use omp, prime-agent, WorkBuddy or DeepSeek Harness, or you want each agent to receive real
+model metadata instead of a bare id, that is what agentsw is for. It reads cc-switch's store
+rather than competing with it.
 
 ## Install
 
@@ -104,6 +119,32 @@ opencode  yes    openai+anthropic  myproxy/glm-5.3-flash                   ~/.co
 dsh       yes    openai+anthropic  myproxy · glm-5.3-flash                 ~/.dsh/settings.yaml
 ```
 
+And the point of the whole thing — one command writes every detected agent (this is the run in
+the animation at the top of this page, as text):
+
+```console
+$ asw use myproxy
+switching to myproxy (openai) · default model glm-5.3-flash
+
+skip claude    Claude Code does not support openai-protocol providers
+ok   codex     ~/.codex/config.toml, ~/.codex/auth.json
+ok   omp       ~/.omp/agent/models.yml
+               select in omp with: omp --model myproxy/glm-5.3-flash
+ok   pi        ~/.pi/agent/models.json, ~/.pi/agent/settings.json
+ok   prime     ~/.prime/agent/models.json, ~/.prime/agent/settings.json
+ok   opencode  ~/.config/opencode/opencode.json
+ok   hermes    ~/.hermes/config.yaml, ~/.hermes/.env
+ok   workbuddy ~/.workbuddy/models.json, ~/.workbuddy/settings.json
+               WorkBuddy watches models.json; models appear in the selector's custom section without restart
+ok   dsh       ~/.dsh/settings.yaml, ~/.dsh/.credentials.yaml
+               select in dsh with the model picker, or run: dsh web
+```
+
+`claude` is the only skip: Claude Code speaks the Anthropic protocol, and `myproxy` is an
+OpenAI-protocol provider. On a machine where an agent's config already exists, committing to it
+also prints a `backup: ~/.config/agentsw/backups/transaction-<unique>` line; this sandbox starts
+with empty configs, so there is nothing to back up and none appear.
+
 ## Supported apps
 
 | App | Config written | Protocols |

package/README.zh-CN.md

@@ -17,20 +17,7 @@
 
 </div>
 
-```console
-$ asw use myproxy -m glm-5.3-flash
-switching to myproxy (openai) · default model glm-5.3-flash
-
-skip claude    Claude Code does not support openai-protocol providers
-ok   codex     ~/.codex/config.toml, ~/.codex/auth.json
-               backup: ~/.config/agentsw/backups/transaction-<unique>
-ok   omp       ~/.omp/agent/models.yml
-               select in omp with: omp --model myproxy/glm-5.3-flash
-skip pi        pi not detected (pass --apps pi to force)
-ok   opencode  ~/.config/opencode/opencode.json
-ok   dsh       ~/.dsh/settings.yaml, ~/.dsh/.credentials.yaml
-               select in dsh with the model picker, or run: dsh web
-```
+![asw use myproxy 把一个供应商写进九个编码智能体](https://raw.githubusercontent.com/tchivs/agentsw/main/docs/demo.gif)
 
 `agentsw` 和短名 `asw` 是同一个可执行文件。
 
@@ -53,9 +40,33 @@ ok   dsh       ~/.dsh/settings.yaml, ~/.dsh/.credentials.yaml
 - **区分接口形态。** `/v1/chat/completions` 与 `/v1/responses` 是两个不同端点；
   agentsw 记录供应商说的是哪一种，并且绝不把可用的 responses 降级。
 
-想要 GUI、MCP/Skills 同步、用量仪表盘或本地故障转移代理？用
-[cc-switch](https://github.com/farion1231/cc-switch)——那些它做得很好；agentsw 从它导入，
-而不是跟它抢。
+## 它和同类工具的关系
+
+有两件事别人做得比 agentsw 好，而且都值得你去看：
+
+- **[cc-switch](https://github.com/farion1231/cc-switch)**——桌面应用（Tauri），支持十个工具：一键切换、
+  90+ 供应商预设、MCP/Skills/Prompts 管理、本地路由与故障转移（含 API 格式转换）、用量与成本仪表盘、
+  会话管理、WebDAV/S3 同步。
+- **[cc-switch-cli](https://github.com/SaladDay/cc-switch-cli)**——同一思路的社区 CLI 分支：TUI + 可脚本化子命令、
+  七个工具、MCP 与 Skills、带 token 统计的守护进程代理、SQLite 存储。
+
+两者合起来覆盖 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、Hermes、OpenClaw、Pi、
+Grok Build、MiniMax Code。agentsw 覆盖的是另外九个——Claude Code、Codex、omp、pi、prime-agent、
+opencode、Hermes、WorkBuddy、DeepSeek Harness——**其中四个另外两个工具根本不写。**
+
+| | agentsw | cc-switch | cc-switch-cli |
+|---|---|---|---|
+| 形态 | CLI，`--json` 可脚本化 | 桌面 GUI | TUI + CLI |
+| 从 models.dev + AI Gateway 取元数据，写入各应用自己的字段 | **是** | 无 | 无 |
+| MCP / Skills / Prompts 管理 | — | 有 | 有 |
+| 路由、API 格式转换、故障转移 | — | 有 | 有 |
+| 用量与成本仪表盘 | — | 有 | 有 |
+| 预设、会话、云同步、deep link | — | 有 | 部分 |
+| 读取对方的供应商库 | 有——只读 `import` | — | — |
+
+说实话的结论：**想要 GUI、MCP 管理或故障转移代理，用 cc-switch。** 如果你在用 omp、prime-agent、
+WorkBuddy 或 DeepSeek Harness，或者你希望每个智能体拿到的是真实模型参数而不是一个裸 id，
+那才是 agentsw 的用处。它读 cc-switch 的库，而不是跟它抢。
 
 ## 安装
 
@@ -99,6 +110,31 @@ opencode  yes    openai+anthropic  myproxy/glm-5.3-flash                   ~/.co
 dsh       yes    openai+anthropic  myproxy · glm-5.3-flash                 ~/.dsh/settings.yaml
 ```
 
+而这个工具真正的用处是另一条——一条命令写进所有检测到的智能体
+（也就是本页顶部那段动画里跑的东西，文字版）：
+
+```console
+$ asw use myproxy
+switching to myproxy (openai) · default model glm-5.3-flash
+
+skip claude    Claude Code does not support openai-protocol providers
+ok   codex     ~/.codex/config.toml, ~/.codex/auth.json
+ok   omp       ~/.omp/agent/models.yml
+               select in omp with: omp --model myproxy/glm-5.3-flash
+ok   pi        ~/.pi/agent/models.json, ~/.pi/agent/settings.json
+ok   prime     ~/.prime/agent/models.json, ~/.prime/agent/settings.json
+ok   opencode  ~/.config/opencode/opencode.json
+ok   hermes    ~/.hermes/config.yaml, ~/.hermes/.env
+ok   workbuddy ~/.workbuddy/models.json, ~/.workbuddy/settings.json
+               WorkBuddy watches models.json; models appear in the selector's custom section without restart
+ok   dsh       ~/.dsh/settings.yaml, ~/.dsh/.credentials.yaml
+               select in dsh with the model picker, or run: dsh web
+```
+
+唯一被跳过的是 `claude`：Claude Code 说的是 Anthropic 协议，而 `myproxy` 是 OpenAI 协议的供应商。
+在智能体的配置已经存在的机器上，提交它时还会打印一行 `backup: ~/.config/agentsw/backups/transaction-<unique>`；
+本沙箱从空配置开始，无物可备，因此没有这行。
+
 ## 支持的应用
 
 | 应用 | 写入的配置 | 协议 |

package/dist/commands.js

@@ -483,7 +483,10 @@ function reportResults(results) {
             out(`${pc.yellow(t("common.skip"))} ${r.app.padEnd(9)} ${pc.dim(r.skipped)}`);
             continue;
         }
-        out(`${pc.green("ok  ")} ${r.app.padEnd(9)} ${r.changed.join(", ")}`);
+        // An empty change list means the app was already in sync: say so rather than
+        // printing a bare "ok" with nothing after it.
+        const detail = r.changed.length ? r.changed.join(", ") : pc.dim(t("preview.unchanged"));
+        out(`${pc.green("ok  ")} ${r.app.padEnd(9)} ${detail}`);
         for (const note of r.notes)
             out(`     ${" ".repeat(9)} ${pc.dim(note)}`);
     }

package/dist/config-transaction.js

@@ -144,26 +144,31 @@ export function commitFileChanges(changes, opts = {}) {
     return withWriteLock(() => {
         // Another writer may have committed between planning and acquiring the lock.
         validateReads();
+        // Only a file that already existed has anything to save. When every planned
+        // file is new, no transaction directory is created: an empty one (nothing but
+        // its manifest) would read as a backup that does not exist.
         let backupDir;
         let currentFile = backupsDir;
         try {
-            fs.mkdirSync(backupsDir, { recursive: true, mode: 0o700 });
-            backupDir = fs.mkdtempSync(path.join(backupsDir, "transaction-"));
-            fs.chmodSync(backupDir, 0o700);
-            for (const [index, change] of plan.entries()) {
-                currentFile = change.file;
-                if (change.before === undefined)
-                    continue;
-                const backup = path.join(backupDir, `${index}-${path.basename(change.file)}`);
-                fs.writeFileSync(backup, change.before, { flag: "wx", mode: 0o600 });
-                fs.chmodSync(backup, 0o600);
+            if (plan.some((change) => change.before !== undefined)) {
+                fs.mkdirSync(backupsDir, { recursive: true, mode: 0o700 });
+                backupDir = fs.mkdtempSync(path.join(backupsDir, "transaction-"));
+                fs.chmodSync(backupDir, 0o700);
+                for (const [index, change] of plan.entries()) {
+                    currentFile = change.file;
+                    if (change.before === undefined)
+                        continue;
+                    const backup = path.join(backupDir, `${index}-${path.basename(change.file)}`);
+                    fs.writeFileSync(backup, change.before, { flag: "wx", mode: 0o600 });
+                    fs.chmodSync(backup, 0o600);
+                }
+                fs.writeFileSync(path.join(backupDir, "manifest.json"), JSON.stringify(plan.map((change, index) => ({
+                    file: change.file,
+                    backup: change.before === undefined ? null : `${index}-${path.basename(change.file)}`,
+                    mode: change.original.mode,
+                })), null, 2) + "\n", { flag: "wx", mode: 0o600 });
+                fs.chmodSync(path.join(backupDir, "manifest.json"), 0o600);
             }
-            fs.writeFileSync(path.join(backupDir, "manifest.json"), JSON.stringify(plan.map((change, index) => ({
-                file: change.file,
-                backup: change.before === undefined ? null : `${index}-${path.basename(change.file)}`,
-                mode: change.original.mode,
-            })), null, 2) + "\n", { flag: "wx", mode: 0o600 });
-            fs.chmodSync(path.join(backupDir, "manifest.json"), 0o600);
             validateReads();
         }
         catch {
@@ -216,7 +221,7 @@ export function commitFileChanges(changes, opts = {}) {
                 }
                 catch { /* Only remove empty directories created by this transaction. */ }
             }
-            throw new Error(`${currentFile}: configuration transaction failed; ${failed.length ? `rollback incomplete for ${failed.join(", ")}` : "previous writes rolled back"}; backups: ${backupDir}`);
+            throw new Error(`${currentFile}: configuration transaction failed; ${failed.length ? `rollback incomplete for ${failed.join(", ")}` : "previous writes rolled back"}${backupDir ? `; backups: ${backupDir}` : "; no files needed backing up"}`);
         }
         return { files, backupDir };
     });

package/dist/targets/codex.js

@@ -82,7 +82,11 @@ export const codex = transactionalTarget({
             wire_api: "responses",
             requires_openai_auth: true,
         };
-        notes.push("codex requires an OpenAI Responses-compatible endpoint (/v1/responses); chat-completions-only endpoints will not work");
+        // Only worth saying when the endpoint has not declared itself Responses-compatible:
+        // a provider the user already marked `responses` needs no caveat.
+        if (provider.openaiApi !== "responses") {
+            notes.push("codex requires an OpenAI Responses-compatible endpoint (/v1/responses); chat-completions-only endpoints will not work");
+        }
         config.model_providers = providers;
         const configBackup = backupFile(configFile);
         if (configBackup)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentsw",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "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": {