@unlinearity/cli-wechat-bridge 1.2.2 → 1.2.3

package/package.json

@@ -1,18 +1,21 @@
 {
   "name": "@unlinearity/cli-wechat-bridge",
-  "version": "1.2.2",
-  "description": "CLI bridge for Codex, Claude Code, OpenCode, and Pi over WeChat and WeCom",
+  "version": "1.2.3",
+  "description": "CLI bridge for Codex, Claude Code, OpenCode, and Pi over WeChat, WeCom, and Telegram",
   "type": "module",
   "files": [
     "bin/",
     "dist/",
     "scripts/ensure-node-pty-permissions.mjs",
     "README.md",
-    "LICENSE.txt"
+    "README_EN.md",
+    "LICENSE.txt",
+    "skills/codex-bridge/"
   ],
   "keywords": [
     "wechat",
     "wecom",
+    "telegram",
     "cli",
     "bridge",
     "codex",
@@ -48,7 +51,14 @@
     "wecom-pi": "bin/wecom-pi.mjs",
     "wecom-daemon": "bin/wecom-daemon.mjs",
     "wecom-setup": "bin/wecom-setup.mjs",
-    "wecom-check-update": "bin/wecom-check-update.mjs"
+    "wecom-check-update": "bin/wecom-check-update.mjs",
+    "telegram-codex": "bin/telegram-codex.mjs",
+    "telegram-claude": "bin/telegram-claude.mjs",
+    "telegram-opencode": "bin/telegram-opencode.mjs",
+    "telegram-pi": "bin/telegram-pi.mjs",
+    "telegram-daemon": "bin/telegram-daemon.mjs",
+    "telegram-setup": "bin/telegram-setup.mjs",
+    "telegram-check-update": "bin/telegram-check-update.mjs"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",

package/skills/codex-bridge/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: codex-bridge
+description: Attach a messaging channel (WeChat, WeCom, or Telegram) to the current Codex conversation through the shared Codex app-server daemon, or manage the attached bridge. Use for $codex-bridge requests from Codex TUI sessions; this skill does not apply to Claude Code, OpenCode, Pi, or embedded (desktop app) Codex sessions.
+---
+
+# Codex Bridge
+
+Attach the CLI WeChat Bridge to the **current** Codex conversation. The bridge joins the shared Codex app-server daemon (`~/.codex/app-server-control/app-server-control.sock`, codex >= 0.162 default mode) as a second client and rejoins this session's live thread: channel messages become turns in this same thread, replies and approvals flow back to the channel, and the local Codex session keeps working unchanged.
+
+Keep the invoking Codex conversation and its context. The launcher prefix selects the channel — `wechat-codex`, `wecom-codex`, or `telegram-codex`; default to WeChat unless the user names another channel.
+
+## Attach the current conversation
+
+1. Resolve the launcher: the installed package's `wechat-codex` / `wecom-codex` / `telegram-codex` (find it with `npm root -g`; primary package `cli-wechat-bridge`, mirror `@unlinearity/cli-wechat-bridge`), or the source-checkout equivalents.
+2. Run the attach command from the project directory (or pass `--cwd`):
+   ```bash
+   <channel>-codex --cwd <project> --attach-current-session   # prefix: wechat | wecom | telegram
+   ```
+   It starts a background bridge that discovers the newest **live** daemon session in `<project>` and binds to it. Success prints `Attached Codex daemon thread <id>`. Attach with an explicit thread via `--codex-thread-id <id>` when several live sessions share the directory.
+3. Verify before claiming success: the launcher printed `Attached Codex daemon thread`, or `~/.cli-bridge/workspaces/<workspace-key>/bridge-state.json` has a `sharedThreadId`. A message that reaches this conversation and whose reply returns to the channel is the full proof.
+4. Do not run plain `wechat-codex` as a substitute: that opens a new bridge-managed visible client and does NOT attach this conversation. Never report "connected" based on a login, a status read, or a new session.
+
+## Boundaries — report these honestly
+
+- `No shared Codex app-server daemon socket at ...`: codex < 0.162 or no shared background server. Upgrade codex and retry.
+- `No live Codex daemon session found for <project>`: no daemon-attached session in this directory. Open codex normally (>= 0.162) in the project and retry.
+- `thread ... already has an active writer`: the target session is **embedded** (desktop app, `--no-daemon`, `--oss`, `--profile`). Embedded sessions cannot be attached; say so instead of falling back to opening another session.
+- A daemon (`wechat-daemon`/`wecom-daemon`/`telegram-daemon`) owning the workspace blocks attach (it holds the bridge lock); stop it first or use its slots.
+
+## Status, switching, and shutdown
+
+- Status: `~/.cli-bridge/workspaces/<workspace-key>/bridge-state.json` (`sharedThreadId`, status) and `~/.cli-bridge/bridge.log`.
+- Switch to another conversation: run the attach command again from that session's project directory; it replaces the previous attach bridge for the workspace.
+- Shutdown: send `/shutdown` from the channel, or stop the bridge process holding `~/.cli-bridge/bridge.lock.json`.
+- Attach does not kill or restart anything: the shared daemon, the owning TUI, and all turns stay intact; the bridge is a guest client and turns it injects appear live in the local session.

package/skills/codex-bridge/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Codex Bridge"
+  short_description: "把当前 Codex 会话接入消息通道（微信 / 企业微信 / Telegram）：加入共享 app-server daemon，rejoin 活线程，消息与回复双向流转"
+  default_prompt: "使用 $codex-bridge 把当前 Codex 会话接入消息通道。"

package/skills/codex-bridge/scripts/install.mjs

@@ -0,0 +1,28 @@
+// 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 os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+export function installCodexBridgeSkill({
+  sourceDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), ".."),
+  codexHome = process.env.CODEX_HOME || path.join(os.homedir(), ".codex"),
+} = {}) {
+  const targetDir = path.join(codexHome, "skills", "codex-bridge");
+  for (const relative of ["SKILL.md", "agents/openai.yaml", "scripts/install.mjs"]) {
+    const source = path.join(sourceDir, relative);
+    const target = path.join(targetDir, relative);
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    if (path.resolve(source) !== path.resolve(target)) fs.copyFileSync(source, target);
+  }
+  return targetDir;
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  console.log(JSON.stringify({ installed: installCodexBridgeSkill() }));
+}