cli-wechat-bridge 1.1.8 → 1.2.1

package/README.md

@@ -53,10 +53,11 @@
 
 - [Node.js](https://nodejs.org/en/download) `>= 22.13.0`（建议直接安装官网 LTS 版本）
 - 已安装以下任意一种本地 CLI，并尽量保持最新版本：
-  - [Codex](https://github.com/openai/codex)
+  - [Codex](https://github.com/openai/codex)（已验证 `0.149.x`–`0.157.x`）
   - [Claude Code](https://code.claude.com/docs/en/overview)
-  - [OpenCode](https://github.com/anomalyco/opencode) `>= 1.18.0 < 2.0.0`
-  - [Pi](https://github.com/earendil-works/pi)（已验证 `0.84.2`；需要本机可执行 `pi` 命令）
+  - [OpenCode](https://github.com/anomalyco/opencode)（同时支持 `1.18.x` 与 `2.0.x`）
+  - [Pi](https://github.com/earendil-works/pi)（已验证 `0.85.1`；需要本机可执行 `pi` 命令）
+- Bridge 仅调用安装在 `PATH` 中、可直接执行的独立 CLI；不会发现或调用 ChatGPT.app 等桌面应用内部捆绑的私有可执行文件。
 - 已准备一个远程通道：个人微信使用 `wechat-setup`，企业微信使用 `wecom-setup`
 
 ### 2. 安装与更新
@@ -344,6 +345,7 @@ OpenCode 模式下，微信和企业微信侧都支持 `/new` 或 `/new-session`
 | `/claude [prompt]` | daemon | 切换到 Claude Code；可选 prompt 在切换成功后转发 |
 | `/opencode [prompt]` | daemon | 切换到 OpenCode；可选 prompt 在切换成功后转发 |
 | `/pi [prompt]` | daemon | 切换到 Pi；可选 prompt 在切换成功后转发 |
+| `/all <prompt>` | daemon | 将同一段提示词同时下发给全部已启动的 CLI；未启动的列为跳过，任一 CLI 忙碌时整条取消 |
 | `/status` | 直接启动、daemon | 查看 bridge、daemon、适配器和工作区状态 |
 | `/model`、`/model <编号>` | Codex、Claude Code、OpenCode、Pi | 列出模型并切换当前会话的模型；编号列表 5 分钟内有效 |
 | `/plan`、`/plan on`、`/plan off` | Codex、Claude Code、OpenCode | 开启计划模式，或恢复进入前的模式 / primary agent |
@@ -365,7 +367,17 @@ OpenCode 的控制不依赖可见 TUI 的输入框、菜单或当前面板。桥
 
 Pi 的 `/model` 通过已连接原生 TUI extension 读取当前 scoped model 列表；没有 scoped models 时使用 model registry 中可用的模型，并通过 `pi.setModel()` 切换。Pi 的 `/plan` 仍由可选扩展定义，不作为 bridge 的通用控制命令。
 
-模型列表绑定当前会话、CLI 进程和操作者；切换会话或 daemon 活动 CLI 后请重新发送 `/model`。Claude 原生菜单名称被终端宽度截断或无法唯一识别时，桥接会提示刷新或扩大终端；OpenCode 只有在 server 回读确认后才报告切换成功。
+模型列表绑定当前会话、CLI 进程和操作者；切换会话或 daemon 活动 CLI 后请重新发送 `/model`。
+
+### 「正在输入」状态与回复投递
+
+从微信派发任务后，聊天窗口会显示原生的「对方正在输入…」状态，并以 5 秒心跳保持，直到回复送达、任务失败或 daemon 关闭。typing 凭证按联系人从微信官方配置端点获取并自动刷新，获取失败时整体静默降级，不影响消息收发。
+
+较长的回复现在作为一条完整消息发出，不再按固定长度拆分，与微信官方机器人客户端的行为一致。若服务器拒收超长消息，既有的重试与待发队列机制仍会记录失败，回复不会无声丢失。
+
+### daemon IPC（外部程序接入）
+
+`wechat-daemon` 与 `wecom-daemon` 在本地开放带 token 认证的 IPC 接口，外部程序（网页面板、脚本、自建机器人前端等）可以将文本按与聊天消息完全一致的处理规则下发给任意 CLI，或借用通道发送消息：忙碌时拒绝、有待审批或结构化输入时等待、Codex 本地任务期间自动排队，回复始终发回所属会话，输入被拒绝或失败时自动回滚状态。接口语义见 [docs/development.md](docs/development.md)。Claude 原生菜单名称被终端宽度截断或无法唯一识别时，桥接会提示刷新或扩大终端；OpenCode 只有在 server 回读确认后才报告切换成功。
 
 ### 5.2 会话恢复与本地同步
 
@@ -438,11 +450,13 @@ Daemon 模式支持将消息开头的表情映射为命令。表情绑定对微
 
 本项目采用**双协议**授权：
 
-**开源协议：[AGPL-3.0](LICENSE.txt)**
+**开源协议：[AGPL-3.0-or-later](LICENSE.txt)**
 
 - 个人使用、学习、研究：完全免费
-- 修改和衍生作品必须以相同协议（AGPL-3.0）开源
-- 通过网络提供基于本项目的服务，也必须公开完整源代码
+- 修改和衍生作品必须以相同协议（AGPL-3.0-or-later）开源，并保留版权声明
+- 通过网络提供基于本项目的服务（包括仅供内部或私有部署使用的服务），也必须向服务使用者提供完整对应源代码（AGPL 第 13 条网络条款）
+- **无论修改由人类还是 AI 工具完成**，只要修改后的版本被发布或对外提供服务，发布方都有义务以 AGPL-3.0-or-later 公开完整源码；仅自用不分发则无此义务
+- 每个源文件头部的 SPDX 声明构成协议通知的一部分，不得删除或篡改
 
 **商业授权**
 

package/bin/_run-entry.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { spawn } from "node:child_process";
 import path from "node:path";
 import { fileURLToPath } from "node:url";

package/bin/wechat-check-update.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/commands/check-update.js", []);

package/bin/wechat-claude.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/companion/local-companion-start.js", ["--adapter", "claude"]);

package/bin/wechat-codex.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/companion/local-companion-start.js", ["--adapter", "codex"]);

package/bin/wechat-daemon.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/daemon/wechat-daemon.js");

package/bin/wechat-opencode.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/companion/local-companion-start.js", ["--adapter", "opencode"]);

package/bin/wechat-pi.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/companion/local-companion-start.js", ["--adapter", "pi"]);

package/bin/wechat-setup.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/wechat/setup.js");

package/bin/wecom-check-update.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/commands/check-update.js");

package/bin/wecom-claude.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/companion/local-companion-start.js", ["--adapter", "claude", "--channel", "wecom"]);

package/bin/wecom-codex.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/companion/local-companion-start.js", ["--adapter", "codex", "--channel", "wecom"]);

package/bin/wecom-daemon.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/daemon/wechat-daemon.js", ["--channel", "wecom"]);

package/bin/wecom-opencode.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/companion/local-companion-start.js", ["--adapter", "opencode", "--channel", "wecom"]);

package/bin/wecom-pi.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/companion/local-companion-start.js", ["--adapter", "pi", "--channel", "wecom"]);

package/bin/wecom-setup.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/channels/wecom/setup-cli.js");

package/dist/bridge/bridge-adapters.claude.js

@@ -1,3 +1,9 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { NativeTerminalControl, readClaudePermissionMode } from "./native-terminal-control.js";
 import { ClaudeNativeControls } from "./claude-native-controls.js";
 import fs from "node:fs";

package/dist/bridge/bridge-adapters.codex.js

@@ -1,3 +1,9 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import fs from "node:fs";
 import path from "node:path";
 import crypto from "node:crypto";
@@ -6,10 +12,11 @@ import { detectCliApproval, } from "./bridge-utils.js";
 import { normalizeOutput, nowIso, summarizeOutput, truncatePreview, } from "../core/text-utils.js";
 import { AbstractPtyAdapter } from "./bridge-adapters.core.js";
 import { killProcessTreeSync } from "./bridge-process-reaper.js";
+import { CodexVisibleThreadProxy } from "./codex-visible-thread-proxy.js";
 import * as shared from "./bridge-adapters.shared.js";
 import { requestCodexVisibleClientShutdown, requestCodexVisibleThreadSwitch, } from "../companion/codex-visible-client-link.js";
 import { readLocalCompanionEndpoint } from "../companion/local-companion-link.js";
-import { ensureWorkspaceChannelDir } from "../wechat/channel-config.js";
+import { appendBoundedLog as appendBridgeLog, BRIDGE_LOG_FILE, ensureWorkspaceChannelDir } from "../wechat/channel-config.js";
 import { CODEX_REMOTE_AUTH_TOKEN_ENV, LOCAL_CLIENT_PROTOCOL_VERSION, } from "../runtime/runtime-types.js";
 export function parseCodexCliVersion(output) {
     const match = output.match(/\b(\d+\.\d+\.\d+)\b/);
@@ -22,7 +29,7 @@ export function isCodexVersionInCompatibilityRange(version) {
     }
     const major = parts[0] ?? -1;
     const minor = parts[1] ?? -1;
-    return major === 0 && minor >= 149 && minor <= 155;
+    return major === 0 && minor >= 149 && minor <= 157;
 }
 const { CODEX_APP_SERVER_HOST, CODEX_APP_SERVER_READY_TIMEOUT_MS, CODEX_FINAL_REPLY_SETTLE_DELAY_MS, CODEX_RECENT_SESSION_KEY_LIMIT, CODEX_RPC_CONNECT_RETRY_MS, CODEX_RPC_RECONNECT_TIMEOUT_MS, CODEX_SESSION_FALLBACK_SCAN_INTERVAL_MS, CODEX_SESSION_LOCAL_MIRROR_FALLBACK_WINDOW_MS, CODEX_SESSION_POLL_INTERVAL_MS, CODEX_STARTUP_WARMUP_MS, CODEX_THREAD_SIGNAL_TTL_MS, INTERRUPT_SETTLE_DELAY_MS, appendBoundedLog, buildCodexApprovalRequest, buildCodexCliArgs, buildCodexDynamicToolCallFailureResponse, buildCodexMcpServerElicitationDeclineResponse, buildCodexPermissionsRequestApprovalResponse, buildCodexUserInputRequest, coerceWebSocketMessageData, delay, describeUnknownError, extractCodexFinalTextFromItem, extractCodexThreadFollowIdFromStatusChanged, extractCodexThreadStartedThreadId, extractCodexUserMessageText, findCodexSessionFile, findRecentCodexSessionFileForCwd, getCodexRpcRequestId, getCodexApprovalAutoResponse, getCodexWechatOutboundAttachmentDenyMessage, getNotificationThreadId, getNotificationTurnId, isRecord, isRecentIsoTimestamp, listCodexResumeSessions, normalizeComparablePath, normalizeCodexRpcError, reserveLocalPort, resolveSpawnTarget, shouldAutoCompleteCodexWechatTurnAfterFinalReply, shouldIgnoreCodexSessionReplayEntry, shouldRecoverCodexStaleBusyState, waitForTcpPort, } = shared;
 const CODEX_LOCAL_THREAD_ANNOUNCE_SETTLE_MS = 150;
@@ -74,6 +81,8 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
     appServer = null;
     nativeProcess = null;
     appServerPort = null;
+    visibleThreadProxy = null;
+    visibleOutOfWorkspaceThreadId = null;
     appServerShuttingDown = false;
     appServerLog = "";
     appServerAuthToken = null;
@@ -160,8 +169,18 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         this.setStatus("starting", `Codex protocol compatibility: ${compatibility}.`);
         await this.startAppServer();
         await this.connectRpcClient();
-        await this.restoreInitialSharedThreadIfNeeded();
         try {
+            if (this.isHeadlessRuntimeMode() && this.appServerPort && this.appServerAuthToken) {
+                const trace = (message) => appendBridgeLog(BRIDGE_LOG_FILE, `[${nowIso()}] codex_visible_proxy: ${message}\n`);
+                this.visibleThreadProxy = await CodexVisibleThreadProxy.start({
+                    upstreamUrl: `ws://${CODEX_APP_SERVER_HOST}:${this.appServerPort}`,
+                    token: this.appServerAuthToken,
+                    onTrace: trace,
+                    onThreadOpened: (threadId, cwd) => this.handleVisibleCodexThreadOpened(threadId, cwd, trace),
+                    onVisibleTurn: (threadId) => this.handleVisibleCodexTurn(threadId, trace),
+                });
+            }
+            await this.restoreInitialSharedThreadIfNeeded();
             if (this.isNativePanelMode()) {
                 await this.startNativeClient();
             }
@@ -280,6 +299,7 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         return models;
     }
     async selectModel(modelId) {
+        this.assertVisibleCodexWorkspace();
         const models = await this.listModels();
         const selected = models.find((model) => model.id === modelId);
         if (!selected)
@@ -288,6 +308,7 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         return selected;
     }
     async setPlanMode(enabled) {
+        this.assertVisibleCodexWorkspace();
         if (!this.usesRpcTurnTransport() || !this.sharedThreadId) {
             throw new Error("Codex plan mode requires an active app-server thread.");
         }
@@ -458,7 +479,7 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
             renderMode: "headless",
             bridgeOwnerPid: process.pid,
             serverPort: this.appServerPort,
-            serverUrl: `ws://${CODEX_APP_SERVER_HOST}:${this.appServerPort}`,
+            serverUrl: this.visibleThreadProxy?.url ?? `ws://${CODEX_APP_SERVER_HOST}:${this.appServerPort}`,
             remoteAuthTokenEnv: CODEX_REMOTE_AUTH_TOKEN_ENV,
             cwd: this.options.cwd,
             command: this.options.command,
@@ -1014,6 +1035,7 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         }
     }
     async sendPanelTurn(text) {
+        this.assertVisibleCodexWorkspace();
         if (this.isNativePanelMode() && !this.nativeProcess) {
             throw new Error("codex panel is not running.");
         }
@@ -1162,6 +1184,8 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
             });
             this.appServer = null;
             this.appServerPort = null;
+            void this.visibleThreadProxy?.close();
+            this.visibleThreadProxy = null;
             this.appServerShuttingDown = false;
             this.deleteAppServerAuthTokenFile();
             this.appServerAuthToken = null;
@@ -1184,6 +1208,8 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
             });
             this.appServer = null;
             this.appServerPort = null;
+            void this.visibleThreadProxy?.close();
+            this.visibleThreadProxy = null;
             this.appServerShuttingDown = false;
             this.deleteAppServerAuthTokenFile();
             this.appServerAuthToken = null;
@@ -1654,6 +1680,7 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
                 reason: "wechat_resume",
                 notify: true,
             });
+            this.clearVisibleCodexWorkspaceBlock();
             this.bridgeResumeReplayThreadId = targetThreadId;
             this.bridgeResumeReplayUntilMs = Date.now() + CODEX_RESUME_REPLAY_SETTLE_MS;
             this.setStatus("starting", `Codex resume committed thread ${targetThreadId.slice(0, 12)}.`);
@@ -1875,6 +1902,7 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         if (!options.preserveThread) {
             this.clearPendingThreadAnnouncement();
             this.announcedThreadId = null;
+            this.visibleOutOfWorkspaceThreadId = null;
         }
         if (!options.preserveThread) {
             this.updateSharedThread(null);
@@ -1994,6 +2022,62 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         }, CODEX_LOCAL_THREAD_ANNOUNCE_SETTLE_MS);
         pending.timer.unref?.();
     }
+    handleVisibleCodexThreadOpened(threadId, cwd, trace) {
+        if (this.pendingVisibleResume || this.shuttingDown) {
+            trace?.(`ignored thread=${threadId.slice(0, 12)} reason=bridge_switch`);
+            return;
+        }
+        if (cwd && normalizeComparablePath(cwd) !== normalizeComparablePath(this.options.cwd)) {
+            trace?.(`paused thread=${threadId.slice(0, 12)} reason=workspace`);
+            this.interruptWechatTurnForLocalThreadSwitch(threadId);
+            this.clearPendingThreadAnnouncement();
+            this.pendingThreadFollowId = null;
+            if (this.visibleOutOfWorkspaceThreadId !== threadId) {
+                this.visibleOutOfWorkspaceThreadId = threadId;
+                this.emit({
+                    type: "notice",
+                    level: "warning",
+                    text: `The visible Codex terminal switched to ${cwd}, outside the bridge workspace ${this.options.cwd}. WeChat input is paused instead of being sent to the previous session. Resume a session from the bridge workspace, or restart the bridge in ${cwd}.`,
+                    timestamp: nowIso(),
+                });
+            }
+            return;
+        }
+        this.clearVisibleCodexWorkspaceBlock();
+        trace?.(`follow thread=${threadId.slice(0, 12)} source=visible_open`);
+        this.trackLocalSharedThread(threadId, { reason: "local_follow", signal: "visible_request" });
+    }
+    handleVisibleCodexTurn(threadId, trace) {
+        if (this.pendingVisibleResume || this.shuttingDown)
+            return;
+        if (threadId === this.sharedThreadId) {
+            this.clearVisibleCodexWorkspaceBlock();
+            return;
+        }
+        if (!findCodexSessionFile(this.options.cwd, Date.now(), { threadId })) {
+            trace?.(`ignored thread=${threadId.slice(0, 12)} reason=workspace_or_unpersisted`);
+            return;
+        }
+        this.clearVisibleCodexWorkspaceBlock();
+        trace?.(`follow thread=${threadId.slice(0, 12)} source=visible_turn`);
+        this.trackLocalSharedThread(threadId, { reason: "local_follow", signal: "visible_request" });
+    }
+    clearVisibleCodexWorkspaceBlock() {
+        if (!this.visibleOutOfWorkspaceThreadId)
+            return;
+        this.visibleOutOfWorkspaceThreadId = null;
+        this.emit({
+            type: "notice",
+            level: "info",
+            text: `The visible Codex terminal is back in the bridge workspace ${this.options.cwd}. WeChat input has resumed.`,
+            timestamp: nowIso(),
+        });
+    }
+    assertVisibleCodexWorkspace() {
+        if (this.visibleOutOfWorkspaceThreadId) {
+            throw new Error(`The visible Codex terminal is outside the bridge workspace ${this.options.cwd}. WeChat input is paused; resume a session from this workspace or restart the bridge in the terminal's workspace.`);
+        }
+    }
     trackLocalSharedThread(threadId, options) {
         const weakSignal = options.signal === "status_changed" ||
             options.signal === "thread_started" ||
@@ -2001,7 +2085,7 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         if (weakSignal && Date.now() < this.localThreadFollowBlockedUntilMs) {
             return;
         }
-        if (options.signal === "user_message" || options.signal === "turn_started") {
+        if (options.signal === "user_message" || options.signal === "turn_started" || options.signal === "visible_request") {
             this.localThreadFollowBlockedUntilMs = 0;
         }
         if (this.pendingVisibleResume) {
@@ -2337,7 +2421,7 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
                 origin: "local",
             };
         }
-        if (method === "turn/started" && !this.activeTurn) {
+        if (method === "turn/started" && !this.activeTurn && !this.visibleThreadProxy) {
             return {
                 threadId,
                 turnId,
@@ -2611,7 +2695,7 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         if (!threadId) {
             return;
         }
-        if (this.pendingVisibleResume) {
+        if (this.pendingVisibleResume || this.visibleThreadProxy) {
             return;
         }
         if (this.isBridgeResumeReplay(threadId)) {
@@ -2690,7 +2774,7 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         if (!threadId) {
             return;
         }
-        if (this.isBridgeResumeReplay(threadId)) {
+        if (this.visibleThreadProxy || this.isBridgeResumeReplay(threadId)) {
             return;
         }
         if (this.isRecentlyBridgeOwnedThread(threadId)) {
@@ -2968,6 +3052,9 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         this.rememberCompletedTurn(turnId);
     }
     async stopAppServer() {
+        const visibleThreadProxy = this.visibleThreadProxy;
+        this.visibleThreadProxy = null;
+        await visibleThreadProxy?.close();
         if (!this.appServer) {
             this.appServerPort = null;
             this.appServerShuttingDown = false;

package/dist/bridge/bridge-adapters.core.js

@@ -1,3 +1,9 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import net from "node:net";
 import path from "node:path";
 import { spawn as spawnPty } from "node-pty";