@co0ontty/wand 2.12.0 → 2.13.0

package/README.md

@@ -11,7 +11,7 @@
 
 ### Overview
 
-Wand is a web console for remotely accessing and managing local CLI tools from a browser. It is designed for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and [Codex](https://github.com/openai/codex), with terminal and structured conversation views, persistent resumable sessions, permission controls, file browsing, and native clients for multiple platforms.
+Wand is a web console for remotely accessing and managing local CLI tools from a browser. It supports [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), and [OpenCode](https://opencode.ai/), with terminal and structured conversation views, persistent resumable sessions, permission controls, file browsing, and native clients for multiple platforms.
 
 The browser password manager extension source lives in `browser-extension/`; setup and supported baseline features are documented in [docs/browser-extension.md](docs/browser-extension.md).
 
@@ -56,7 +56,7 @@ wand config:password
 #### Core
 
 - **Dual view modes** — switch between raw terminal output and a structured conversation view for the same session
-- **Multiple providers** — create sessions for Claude Code, Codex, or other configured local CLI tools
+- **Multiple providers** — create PTY or structured sessions for Claude Code, Codex, and OpenCode
 - **Session management** — create, archive, and resume sessions; restore Claude native history; show summaries in the session list
 - **Permission control** — visual permission prompts with one-time approval, per-turn memory, and related policies
 
@@ -73,6 +73,7 @@ wand config:password
 - **Native clients** — Android, iOS, and macOS clients with encrypted connection codes and update checks
 - **HTTPS** — optional self-signed certificates for remote or mobile access
 - **Update channels** — built-in stable/beta update checks and upgrade prompts
+- **CLI updates** — check and quickly update Claude Code, Codex, and OpenCode from server settings, with optional automatic updates
 
 ### Configuration
 
@@ -143,11 +144,18 @@ git submodule update --init
 
 Runtime data is stored under `~/.wand/`: `config.json`, `wand.db`, and `sessions/`.
 
+OpenCode structured sessions require the current `opencode-ai` CLI (0.1 or newer). Remove the unrelated legacy `opencode` 0.0.x package before installing it:
+
+```bash
+npm uninstall -g opencode
+npm install -g opencode-ai@latest
+```
+
 ## 中文
 
 ### 概览
 
-通过浏览器远程访问和管理本地 CLI 工具的 Web 控制台。专为 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 和 [Codex](https://github.com/openai/codex) 设计，支持终端和结构化对话双视图、会话持久化与恢复、权限管控、文件浏览、多平台客户端。
+通过浏览器远程访问和管理本地 CLI 工具的 Web 控制台。支持 [Claude Code](https://docs.anthropic.com/en/docs/claude-code)、[Codex](https://github.com/openai/codex) 和 [OpenCode](https://opencode.ai/)，提供终端和结构化对话双视图、会话持久化与恢复、权限管控、文件浏览和多平台客户端。
 
 <p align="center">
   <img src="docs/screenshots/clients-overview.png" width="100%" alt="Web 居中，iOS 和 Android 客户端在两侧的多端详情总览" />
@@ -185,12 +193,19 @@ wand web
 wand config:password
 ```
 
+OpenCode 结构化会话需要当前的 `opencode-ai` CLI（0.1 或更高版本）。如果装过无关的旧版 `opencode` 0.0.x 包，请先替换：
+
+```bash
+npm uninstall -g opencode
+npm install -g opencode-ai@latest
+```
+
 ### 功能
 
 #### 核心
 
 - **双视图模式** — 终端原始输出和结构化对话视图可随时切换，同一会话两种呈现
-- **多 Provider 支持** — 同时支持 Claude Code 和 Codex，可按需创建不同类型的会话
+- **多 Provider 支持** — Claude Code、Codex 和 OpenCode 均可创建 PTY 或结构化会话
 - **会话管理** — 创建、归档、恢复会话；支持从 Claude 原生历史记录恢复；会话列表显示摘要
 - **权限控制** — 可视化权限提示，支持逐次确认、单次批准、本轮记忆等策略
 
@@ -207,6 +222,7 @@ wand config:password
 - **多平台客户端** — Android / iOS / macOS 原生客户端，支持加密连接码分发、自动更新检查
 - **HTTPS** — 可选自签证书，适合远程或移动端访问
 - **版本管理** — 内置更新检查与升级提示，支持 stable/beta 双通道
+- **CLI 更新** — 在服务端设置中检查并快速更新 Claude Code、Codex、OpenCode，也可开启自动更新
 
 ### 截图
 

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "2ffe360ae10acb539bd5e5fe785073348e2b0482",
-  "builtAt": "2026-07-12T04:24:13.405Z",
-  "version": "2.12.0",
+  "commit": "f1b77e3be3f2f0b4a1a158e3fc2020ccbc590c68",
+  "builtAt": "2026-07-12T10:02:57.593Z",
+  "version": "2.13.0",
   "channel": "stable"
 }

package/dist/config.d.ts

@@ -7,7 +7,7 @@ import type { WandStorage } from "./storage.js";
  * 升级路径：老 JSON 里仍存有这些字段时，首次启动会被搬到 DB（见 migrateLegacyPreferencesToDb），
  * 然后下一次 saveConfig 写回 JSON 时它们会被剥离（见 stripPreferenceFields）。
  */
-export declare const PREFERENCE_KEYS: readonly ["defaultProvider", "defaultSessionKind", "defaultMode", "defaultCwd", "defaultModel", "defaultCodexModel", "commitCli", "commitModel", "defaultThinkingEffort", "structuredRunner", "language", "cardDefaults", "inheritEnv"];
+export declare const PREFERENCE_KEYS: readonly ["defaultProvider", "defaultSessionKind", "defaultMode", "defaultCwd", "defaultModel", "defaultCodexModel", "defaultOpenCodeModel", "commitCli", "commitModel", "defaultThinkingEffort", "structuredRunner", "language", "cardDefaults", "inheritEnv"];
 export type PreferenceKey = (typeof PREFERENCE_KEYS)[number];
 export declare function isPreferenceKey(key: string): key is PreferenceKey;
 export declare const defaultConfig: () => WandConfig;
@@ -40,9 +40,10 @@ export declare function applyStoragePreferences(config: WandConfig, storage: Wan
 export declare function writePreferenceToStorage(config: WandConfig, storage: WandStorage, key: PreferenceKey, value: unknown): void;
 export declare function normalizeCardDefaults(input: unknown): CardExpandDefaults;
 export declare function isExecutionMode(value: unknown): value is ExecutionMode;
-export declare function getProviderDefaultModels(config: Pick<WandConfig, "defaultModel" | "defaultCodexModel">): {
+export declare function getProviderDefaultModels(config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel">): {
     claude: string;
     codex: string;
+    opencode: string;
 };
-export declare function getDefaultModelForProvider(config: Pick<WandConfig, "defaultModel" | "defaultCodexModel">, provider: "claude" | "codex" | undefined): string;
+export declare function getDefaultModelForProvider(config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel">, provider: "claude" | "codex" | "opencode" | undefined): string;
 export declare function normalizeMode(input: string | undefined, fallback: ExecutionMode): ExecutionMode;

package/dist/config.js

@@ -27,6 +27,7 @@ export const PREFERENCE_KEYS = [
     "defaultCwd",
     "defaultModel",
     "defaultCodexModel",
+    "defaultOpenCodeModel",
     "commitCli",
     "commitModel",
     "defaultThinkingEffort",
@@ -66,6 +67,7 @@ export const defaultConfig = () => ({
     cardDefaults: defaultCardExpandDefaults(),
     defaultModel: "",
     defaultCodexModel: "",
+    defaultOpenCodeModel: "",
     commitCli: "claude",
     commitModel: "",
     defaultThinkingEffort: "off",
@@ -254,7 +256,7 @@ export function applyStoragePreferences(config, storage) {
     const defaults = defaultConfig();
     if (storage.hasPreference(preferenceStorageKey("defaultProvider"))) {
         const v = storage.getPreference(preferenceStorageKey("defaultProvider"), defaults.defaultProvider ?? "claude");
-        if (v === "claude" || v === "codex")
+        if (v === "claude" || v === "codex" || v === "opencode")
             config.defaultProvider = v;
     }
     if (storage.hasPreference(preferenceStorageKey("defaultSessionKind"))) {
@@ -282,9 +284,14 @@ export function applyStoragePreferences(config, storage) {
         if (typeof v === "string")
             config.defaultCodexModel = v.trim();
     }
+    if (storage.hasPreference(preferenceStorageKey("defaultOpenCodeModel"))) {
+        const v = storage.getPreference(preferenceStorageKey("defaultOpenCodeModel"), defaults.defaultOpenCodeModel ?? "");
+        if (typeof v === "string")
+            config.defaultOpenCodeModel = v.trim();
+    }
     if (storage.hasPreference(preferenceStorageKey("commitCli"))) {
         const v = storage.getPreference(preferenceStorageKey("commitCli"), defaults.commitCli ?? "claude");
-        if (v === "claude" || v === "codex")
+        if (v === "claude" || v === "codex" || v === "opencode")
             config.commitCli = v;
     }
     if (storage.hasPreference(preferenceStorageKey("commitModel"))) {
@@ -322,7 +329,7 @@ export function writePreferenceToStorage(config, storage, key, value) {
     const dbKey = preferenceStorageKey(key);
     switch (key) {
         case "defaultProvider": {
-            if (value !== "claude" && value !== "codex")
+            if (value !== "claude" && value !== "codex" && value !== "opencode")
                 throw new Error(`无效 Provider: ${value}`);
             storage.setPreference(dbKey, value);
             config.defaultProvider = value;
@@ -360,8 +367,14 @@ export function writePreferenceToStorage(config, storage, key, value) {
             config.defaultCodexModel = v;
             break;
         }
+        case "defaultOpenCodeModel": {
+            const v = typeof value === "string" ? value.trim() : "";
+            storage.setPreference(dbKey, v);
+            config.defaultOpenCodeModel = v;
+            break;
+        }
         case "commitCli": {
-            if (value !== "claude" && value !== "codex")
+            if (value !== "claude" && value !== "codex" && value !== "opencode")
                 throw new Error(`无效 commit CLI: ${value}`);
             storage.setPreference(dbKey, value);
             config.commitCli = value;
@@ -541,11 +554,12 @@ function mergeWithDefaults(input) {
         android: normalizeAndroidApkConfig(input.android) ?? defaults.android,
         macos: normalizeMacosDmgConfig(input.macos) ?? defaults.macos,
         cardDefaults: normalizeCardDefaults(input.cardDefaults),
-        defaultProvider: input.defaultProvider === "codex" ? "codex" : "claude",
+        defaultProvider: input.defaultProvider === "codex" || input.defaultProvider === "opencode" ? input.defaultProvider : "claude",
         defaultSessionKind: input.defaultSessionKind === "pty" ? "pty" : "structured",
         defaultModel: typeof input.defaultModel === "string" ? input.defaultModel.trim() : defaults.defaultModel,
         defaultCodexModel: typeof input.defaultCodexModel === "string" ? input.defaultCodexModel.trim() : defaults.defaultCodexModel,
-        commitCli: input.commitCli === "codex" ? "codex" : "claude",
+        defaultOpenCodeModel: typeof input.defaultOpenCodeModel === "string" ? input.defaultOpenCodeModel.trim() : defaults.defaultOpenCodeModel,
+        commitCli: input.commitCli === "codex" || input.commitCli === "opencode" ? input.commitCli : "claude",
         commitModel: typeof input.commitModel === "string" ? input.commitModel.trim() : defaults.commitModel,
         defaultThinkingEffort: isThinkingEffort(input.defaultThinkingEffort) ? input.defaultThinkingEffort : "off",
         structuredRunner: (input.structuredRunner === "sdk" || input.structuredRunner === "cli") ? input.structuredRunner : defaults.structuredRunner,
@@ -559,11 +573,12 @@ export function getProviderDefaultModels(config) {
     return {
         claude: (config.defaultModel ?? "").trim(),
         codex: (config.defaultCodexModel ?? "").trim(),
+        opencode: (config.defaultOpenCodeModel ?? "").trim(),
     };
 }
 export function getDefaultModelForProvider(config, provider) {
     const defaults = getProviderDefaultModels(config);
-    return provider === "codex" ? defaults.codex : defaults.claude;
+    return provider === "codex" ? defaults.codex : provider === "opencode" ? defaults.opencode : defaults.claude;
 }
 export function normalizeMode(input, fallback) {
     return isExecutionMode(input) ? input : fallback;

package/dist/git-quick-commit.js

@@ -3,7 +3,7 @@ import { spawn } from "node:child_process";
 import { ClaudeRunError, runClaudePrint } from "./claude-sdk-runner.js";
 import { buildChildEnv } from "./env-utils.js";
 import { runGit as runGitBase, runGitRaw as runGitRawBase, getGitErrorMessage } from "./git-utils.js";
-import { thinkingEffortToClaudeCliEffort, thinkingEffortToCodexReasoningEffort } from "./structured-session-manager.js";
+import { thinkingEffortToClaudeCliEffort, thinkingEffortToCodexReasoningEffort, thinkingEffortToOpenCodeVariant } from "./structured-session-manager.js";
 const GIT_TIMEOUT_MS = 1500;
 const GIT_PUSH_TIMEOUT_MS = 30_000;
 const MAX_FILE_ENTRIES = 200;
@@ -281,7 +281,7 @@ async function callClaudeText(prompt, cwd, language, model) {
     }
 }
 function normalizeProvider(provider) {
-    return provider === "codex" ? "codex" : "claude";
+    return provider === "codex" || provider === "opencode" ? provider : "claude";
 }
 function stripFences(raw) {
     return raw.trim().replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/i, "").trim();
@@ -315,6 +315,24 @@ function extractCodexText(stdout) {
     }
     return "";
 }
+function extractOpenCodeText(stdout) {
+    const texts = [];
+    for (const line of stdout.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("{"))
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (parsed.type === "text" && typeof parsed.part?.text === "string" && parsed.part.text.trim()) {
+                texts.push(parsed.part.text.trim());
+            }
+        }
+        catch {
+            // ignore diagnostics mixed into stdout
+        }
+    }
+    return texts.join("\n").trim();
+}
 function runCliText(command, args, prompt, opts) {
     return new Promise((resolve, reject) => {
         const child = spawn(command, args, {
@@ -374,10 +392,31 @@ async function callCodexText(prompt, cwd, opts) {
     }
     return text;
 }
+async function callOpenCodeText(prompt, cwd, opts) {
+    const args = ["run", "--format", "json"];
+    const model = opts.model?.trim();
+    if (model && model !== "default")
+        args.push("--model", model);
+    const variant = thinkingEffortToOpenCodeVariant(opts.thinkingEffort ?? "off");
+    if (variant)
+        args.push("--variant", variant);
+    const stdout = await runCliText("opencode", args, prompt, {
+        cwd,
+        timeoutMs: CODEX_MESSAGE_TIMEOUT_MS,
+        inheritEnv: opts.inheritEnv,
+    });
+    const text = extractOpenCodeText(stdout);
+    if (!text)
+        throw new QuickCommitError("OpenCode 返回了空的 commit message。", "EMPTY_AI_MESSAGE");
+    return text;
+}
 async function callAiText(prompt, cwd, language, opts) {
-    if (normalizeProvider(opts.provider) === "codex") {
+    const provider = normalizeProvider(opts.provider);
+    if (provider === "codex") {
         return callCodexText(prompt, cwd, opts);
     }
+    if (provider === "opencode")
+        return callOpenCodeText(prompt, cwd, opts);
     return callClaudeText(prompt, cwd, language, opts.model);
 }
 function collectStagedDiff(cwd) {
@@ -957,6 +996,20 @@ async function runQuickCommitFallbackCli(opts, priorError) {
             inheritEnv: opts.inheritEnv,
         });
     }
+    else if (provider === "opencode") {
+        const args = ["run", "--format", "json", "--dangerously-skip-permissions"];
+        const model = opts.model?.trim();
+        if (model && model !== "default")
+            args.push("--model", model);
+        const variant = thinkingEffortToOpenCodeVariant(opts.thinkingEffort ?? "off");
+        if (variant)
+            args.push("--variant", variant);
+        await runCliText("opencode", args, prompt, {
+            cwd: opts.cwd,
+            timeoutMs: QUICK_COMMIT_CLI_TIMEOUT_MS,
+            inheritEnv: opts.inheritEnv,
+        });
+    }
     else {
         const args = ["-p", "--verbose", "--output-format", "stream-json"];
         const model = opts.model?.trim();

package/dist/models.d.ts

@@ -2,9 +2,13 @@ import { ClaudeModelInfo } from "./types.js";
 interface ModelCache {
     models: ClaudeModelInfo[];
     codexModels: ClaudeModelInfo[];
+    opencodeModels: ClaudeModelInfo[];
     claudeVersion: string | null;
+    opencodeVersion: string | null;
     refreshedAt: string;
 }
+/** Parse `opencode models`, whose stable machine-friendly output is one provider/model id per line. */
+export declare function parseOpenCodeModels(stdout: string): ClaudeModelInfo[];
 /** Parse the machine-readable model registry emitted by the installed Codex CLI. */
 export declare function parseCodexModels(stdout: string): ClaudeModelInfo[];
 export declare function getCachedModels(): ModelCache;

package/dist/models.js

@@ -15,6 +15,9 @@ const CLAUDE_MODELS = [
 const CODEX_FALLBACK_MODELS = [
     { id: "default", label: "GPT-5.5 · gpt-5.5（Codex 默认）", alias: true },
 ];
+const OPENCODE_FALLBACK_MODELS = [
+    { id: "default", label: "跟随 OpenCode 默认", alias: true },
+];
 let cache = null;
 function cloneClaudeModels() {
     return CLAUDE_MODELS.map((m) => ({ ...m }));
@@ -37,6 +40,32 @@ async function probeCodexModels() {
         return CODEX_FALLBACK_MODELS.map((m) => ({ ...m }));
     }
 }
+async function probeOpenCode() {
+    const [modelsResult, versionResult] = await Promise.allSettled([
+        execAsync("opencode models", { timeout: 8000 }),
+        execAsync("opencode --version", { timeout: 5000 }),
+    ]);
+    const models = modelsResult.status === "fulfilled"
+        ? parseOpenCodeModels(modelsResult.value.stdout)
+        : OPENCODE_FALLBACK_MODELS.map((m) => ({ ...m }));
+    const version = versionResult.status === "fulfilled"
+        ? extractSemver(versionResult.value.stdout) ?? (versionResult.value.stdout.trim().slice(0, 64) || null)
+        : null;
+    return { models, version };
+}
+/** Parse `opencode models`, whose stable machine-friendly output is one provider/model id per line. */
+export function parseOpenCodeModels(stdout) {
+    const ids = Array.from(new Set(stdout
+        .split(/\r?\n/)
+        .map((line) => line.replace(/\x1b\[[0-?]*[ -\/]*[@-~]/g, "").trim())
+        .filter((line) => /^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._:/-]*$/i.test(line))));
+    if (!ids.length)
+        return OPENCODE_FALLBACK_MODELS.map((m) => ({ ...m }));
+    return [
+        { id: "default", label: "跟随 OpenCode 默认", alias: true },
+        ...ids.map((id) => ({ id, label: id })),
+    ];
+}
 /** Parse the machine-readable model registry emitted by the installed Codex CLI. */
 export function parseCodexModels(stdout) {
     try {
@@ -94,21 +123,26 @@ export function getCachedModels() {
         cache = {
             models: cloneClaudeModels(),
             codexModels: CODEX_FALLBACK_MODELS.map((m) => ({ ...m })),
+            opencodeModels: OPENCODE_FALLBACK_MODELS.map((m) => ({ ...m })),
             claudeVersion: null,
+            opencodeVersion: null,
             refreshedAt: new Date().toISOString(),
         };
     }
     return cache;
 }
 export async function refreshModels() {
-    const [version, codexModels] = await Promise.all([
+    const [version, codexModels, opencode] = await Promise.all([
         probeClaudeVersion(),
         probeCodexModels(),
+        probeOpenCode(),
     ]);
     cache = {
         models: cloneClaudeModels(),
         codexModels,
+        opencodeModels: opencode.models,
         claudeVersion: version,
+        opencodeVersion: opencode.version,
         refreshedAt: new Date().toISOString(),
     };
     return cache;

package/dist/path-repair.d.ts

@@ -57,7 +57,7 @@ export declare function repairRuntimePath(): PathRepairResult;
  * 这种动态注入的 PATH。
  *
  * 行为：
- *   - 跑 `${shell} -l -c '...'` 拉 $PATH 和 command -v claude/codex（4s 超时）
+ *   - 跑 `${shell} -l -c '...'` 拉 $PATH 和 command -v claude/codex/opencode（4s 超时）
  *   - 按 login shell 的 PATH 顺序重排 process.env.PATH，再把仅存在于 service 的
  *     目录追加回去。不能只前插新增目录：同一个 CLI 同时装在 nvm 和 Homebrew 时，
  *     两个目录本来都存在，旧实现不会重排，structured 与 PTY 会命中不同版本。

package/dist/path-repair.js

@@ -6,7 +6,7 @@ import path from "node:path";
 import process from "node:process";
 import { spawn, spawnSync } from "node:child_process";
 /** 关键的 CLI 工具，会被诊断输出。 */
-const PROBE_COMMANDS = ["claude", "codex"];
+const PROBE_COMMANDS = ["claude", "codex", "opencode"];
 const DEEP_PROBE_TIMEOUT_MS = 4000;
 /**
  * 构造候选 bin 目录列表（按优先级，前面的更可信）。
@@ -152,7 +152,7 @@ export function repairRuntimePath() {
  * 这种动态注入的 PATH。
  *
  * 行为：
- *   - 跑 `${shell} -l -c '...'` 拉 $PATH 和 command -v claude/codex（4s 超时）
+ *   - 跑 `${shell} -l -c '...'` 拉 $PATH 和 command -v claude/codex/opencode（4s 超时）
  *   - 按 login shell 的 PATH 顺序重排 process.env.PATH，再把仅存在于 service 的
  *     目录追加回去。不能只前插新增目录：同一个 CLI 同时装在 nvm 和 Homebrew 时，
  *     两个目录本来都存在，旧实现不会重排，structured 与 PTY 会命中不同版本。
@@ -190,7 +190,7 @@ export async function deepRepairRuntimePath(result, opts = {}) {
         .map((seg) => seg.trim())
         .filter((seg) => seg.length > 0);
     const existing = new Set(currentSegments);
-    // login shell 报告的所有 PATH 段 + claude/codex 解析出的目录都纳入候选。
+    // login shell 报告的所有 PATH 段 + provider CLI 解析出的目录都纳入候选。
     const fromShell = [];
     for (const seg of probe.path.split(delim).map((s) => s.trim()).filter(Boolean)) {
         fromShell.push(seg);
@@ -199,6 +199,8 @@ export async function deepRepairRuntimePath(result, opts = {}) {
         fromShell.push(path.dirname(probe.claude));
     if (probe.codex)
         fromShell.push(path.dirname(probe.codex));
+    if (probe.opencode)
+        fromShell.push(path.dirname(probe.opencode));
     const preferred = [];
     const preferredSet = new Set();
     for (const dir of fromShell) {
@@ -250,13 +252,14 @@ function pickProbeShell(configured) {
     return null;
 }
 /**
- * 用 login shell 跑一段最小脚本，拿到用户实际的 PATH 和 claude/codex 解析路径。
+ * 用 login shell 跑一段最小脚本，拿到用户实际的 PATH 和 provider CLI 解析路径。
  * 用 \x1f（ASCII Unit Separator）作字段分隔符避免和路径里的字符冲突。
  */
 function probeLoginShell(shell, timeoutMs) {
     const script = `printf 'PATH\\x1f%s\\n' "$PATH"; ` +
         `printf 'CLAUDE\\x1f%s\\n' "$(command -v claude 2>/dev/null)"; ` +
-        `printf 'CODEX\\x1f%s\\n' "$(command -v codex 2>/dev/null)"`;
+        `printf 'CODEX\\x1f%s\\n' "$(command -v codex 2>/dev/null)"; ` +
+        `printf 'OPENCODE\\x1f%s\\n' "$(command -v opencode 2>/dev/null)"`;
     return new Promise((resolve, reject) => {
         const child = spawn(shell, ["-l", "-c", script], {
             env: {
@@ -296,7 +299,7 @@ function probeLoginShell(shell, timeoutMs) {
                     reject(new Error(`login shell exited ${code}: ${stderr.trim().slice(0, 200)}`));
                     return;
                 }
-                const out = { path: "", claude: null, codex: null };
+                const out = { path: "", claude: null, codex: null, opencode: null };
                 for (const line of stdout.split("\n")) {
                     const idx = line.indexOf("\x1f");
                     if (idx < 0)
@@ -311,6 +314,8 @@ function probeLoginShell(shell, timeoutMs) {
                         out.claude = val;
                     else if (key === "CODEX")
                         out.codex = val;
+                    else if (key === "OPENCODE")
+                        out.opencode = val;
                 }
                 resolve(out);
             });

package/dist/process-manager.d.ts

@@ -103,7 +103,7 @@ export declare class ProcessManager extends EventEmitter {
     setSessionThinkingEffort(id: string, effort: SessionSnapshot["thinkingEffort"]): SessionSnapshot;
     /**
      * Switch the execution mode of a PTY session mid-flight. The already-launched
-     * claude/codex process keeps its original CLI flags, but wand's own permission
+     * provider process keeps its original CLI flags, but wand's own permission
      * auto-approval (shouldAutoApprovePermissions / escalation handling) reads
      * record.mode, so this changes the permission posture for subsequent prompts.
      * Mirrors setSessionModel/setSessionThinkingEffort.

package/dist/process-manager.js

@@ -14,12 +14,14 @@ import { ensureNodePtyHelperExecutable } from "./ensure-node-pty-helper.js";
 import { buildLanguageDirective, buildManagedAutonomyDirective } from "./language-prompt.js";
 import { prepareSessionWorktree } from "./git-worktree.js";
 import { getCodexResumeCommandSessionId, getResumeCommandSessionId } from "./resume-policy.js";
-import { normalizeThinkingEffort, thinkingEffortToClaudeCliEffort, thinkingEffortToClaudeSlashEffort, thinkingEffortToCodexReasoningEffort } from "./structured-session-manager.js";
+import { normalizeThinkingEffort, thinkingEffortToClaudeCliEffort, thinkingEffortToClaudeSlashEffort, thinkingEffortToCodexReasoningEffort, thinkingEffortToOpenCodeVariant } from "./structured-session-manager.js";
 import { generateSessionTopic } from "./session-topic.js";
 import { getErrorMessage } from "./error-utils.js";
 import { resolveSessionCwd } from "./session-cwd.js";
 function resolveProviderFromCommand(command) {
-    return /^codex\b/.test(command.trim()) ? "codex" : "claude";
+    if (/^codex\b/.test(command.trim()))
+        return "codex";
+    return /^opencode\b/.test(command.trim()) ? "opencode" : "claude";
 }
 export class SessionInputError extends Error {
     code;
@@ -1010,7 +1012,7 @@ export class ProcessManager extends EventEmitter {
                 }),
                 name: "xterm-color",
                 // 使用 record 上由前端协商好的真实尺寸，避免"先 120 列、几百毫秒后再 resize"
-                // 期间 Claude/Codex 用错列宽渲染出 \x1b[120G 这类绝对列定位序列。
+                // 期间 provider TUI 用错列宽渲染出 \x1b[120G 这类绝对列定位序列。
                 cols: record.ptyCols,
                 rows: record.ptyRows
             });
@@ -1399,7 +1401,7 @@ export class ProcessManager extends EventEmitter {
     }
     /**
      * Switch the execution mode of a PTY session mid-flight. The already-launched
-     * claude/codex process keeps its original CLI flags, but wand's own permission
+     * provider process keeps its original CLI flags, but wand's own permission
      * auto-approval (shouldAutoApprovePermissions / escalation handling) reads
      * record.mode, so this changes the permission posture for subsequent prompts.
      * Mirrors setSessionModel/setSessionThinkingEffort.
@@ -1974,7 +1976,7 @@ export class ProcessManager extends EventEmitter {
                     permissionBlocked: this.isPermissionBlocked(record),
                 };
                 // 透传 bridge 给出的 isResponding（true=流式中, false=本轮已完成）。
-                // 前端用它检测 thinking→idle 边界并主动做一次终端 resync，把 Claude/Codex
+                // 前端用它检测 thinking→idle 边界并主动做一次终端 resync，把 provider TUI
                 // 在流式渲染过程中残留的错位光标定位序列洗掉（等价于按一次右上角缩放）。
                 if (bridgeData && typeof bridgeData.isResponding === "boolean") {
                     data.isResponding = bridgeData.isResponding;
@@ -2142,6 +2144,22 @@ export class ProcessManager extends EventEmitter {
             }
             return result;
         }
+        if (provider === "opencode") {
+            let result = command;
+            const trimmedModel = model?.trim();
+            if (trimmedModel && trimmedModel !== "default" && !/--model(?:\s|=)/.test(result) && !/(?:^|\s)-m(?:\s|$)/.test(result)) {
+                const escapedModel = trimmedModel.replace(/'/g, "'\\''");
+                result += ` --model '${escapedModel}'`;
+            }
+            const variant = thinkingEffortToOpenCodeVariant(thinkingEffort ?? null);
+            if (variant && !/--variant(?:\s|=)/.test(result)) {
+                result += ` --variant '${variant.replace(/'/g, "'\\''")}'`;
+            }
+            if ((mode === "managed" || mode === "full-access" || mode === "auto-edit") && !/--auto(?:\s|$)/.test(result)) {
+                result += " --auto";
+            }
+            return result;
+        }
         const isClaudeCmd = /^(?:claude|npx\s+claude|[^\s]+\/claude)(?:\s|$)/.test(command);
         if (!isClaudeCmd)
             return command;

package/dist/provider-cli-updater.d.ts

@@ -0,0 +1,38 @@
+export type ProviderCliId = "claude" | "codex" | "opencode";
+export interface ProviderCliUpdateStatus {
+    id: ProviderCliId;
+    label: string;
+    command: string;
+    executable: string | null;
+    installed: boolean;
+    currentVersion: string | null;
+    latestVersion: string | null;
+    updateAvailable: boolean;
+    updateSupported: boolean;
+    installKind: "native" | "npm" | "brew" | "legacy" | "unknown";
+    error?: string;
+}
+export interface ProviderCliUpdateResult {
+    id: ProviderCliId;
+    label: string;
+    ok: boolean;
+    skipped: boolean;
+    fromVersion: string | null;
+    toVersion: string | null;
+    message: string;
+    output?: string;
+}
+export interface ProviderCliUpdaterOptions {
+    inheritEnv?: boolean;
+    versionTimeoutMs?: number;
+    registryTimeoutMs?: number;
+    updateTimeoutMs?: number;
+    env?: NodeJS.ProcessEnv;
+    onLog?: (line: string) => void;
+}
+export declare function parseProviderCliVersion(output: string): string | null;
+export declare function providerCliUpdateAvailable(currentVersion: string | null, latestVersion: string | null): boolean;
+export declare function checkProviderCliUpdates(options?: ProviderCliUpdaterOptions): Promise<ProviderCliUpdateStatus[]>;
+export declare function updateProviderClis(statuses: ProviderCliUpdateStatus[], ids?: ProviderCliId[], options?: ProviderCliUpdaterOptions): Promise<ProviderCliUpdateResult[]>;
+/** Re-check the active PATH after updating so duplicate installs cannot masquerade as success. */
+export declare function verifyProviderCliUpdateResults(results: ProviderCliUpdateResult[], statuses: ProviderCliUpdateStatus[]): ProviderCliUpdateResult[];