codex-to-im 0.1.7 → 1.0.10

package/README.md

@@ -68,6 +68,12 @@ npm install
 npm run build
 ```
 
+Windows maintenance note:
+
+- The repo includes [patch-codex-sdk-windows-hide.js](D:/codex/Claude-to-IM-skill/scripts/patch-codex-sdk-windows-hide.js), which applies a conservative postinstall patch to `@openai/codex-sdk`.
+- This exists because on Windows the SDK may spawn the bundled Codex CLI without `windowsHide`, causing a black console window to flash for each IM-triggered run.
+- When upgrading `@openai/codex-sdk`, verify that the spawn block still matches; if upstream fixes this natively, remove the patch instead of carrying it forward.
+
 ## Run
 
 Start the local app:
@@ -130,6 +136,7 @@ Useful commands:
 - `/` / `/status` shows the current session
 - `/h` / `/help` shows help
 - `/t` / `/threads` lists recent desktop threads, and `/t 1` / `/thread 1` binds the first one
+- `/n` / `/new` creates a new thread in the current formal session directory; these IM-created threads are only guaranteed to continue inside IM and will not automatically appear in the Codex Desktop thread list
 - `/n proj1` / `/new proj1` creates a new project session under the default workspace root
 - `/m` / `/mode` shows or changes the current mode; options: `code` / `plan` / `ask`
 - `/r` / `/reasoning` shows or changes the current reasoning effort; options: `1|2|3|4|5`
@@ -156,7 +163,7 @@ So character-by-character text streaming is not guaranteed in the current implem
 
 If creating a new session fails with `Not inside a trusted directory`, either:
 
-- change the default working directory to a trusted Git repo, or
+- switch to a trusted project with `/new /absolute/path` or `/new proj1`, or
 - enable `Allow Codex outside trusted Git repos` in the basic settings and restart the bridge
 
 The configuration page also includes Codex runtime controls:
@@ -180,7 +187,7 @@ If you are using `codex-to-im` on your own development machine for real coding w
 
 This is closer to a full-power `code` workflow. It fits a controlled local project, but is not a good default for unknown repositories or higher-risk environments.
 
-The channel pages also expose a “Use Markdown for command feedback” switch:
+The channel pages also expose a “Use Markdown for bridge feedback” switch:
 - enabled by default for Feishu
 - disabled by default for WeChat
 - only affects bridge-generated feedback such as `/h`, `/status`, and `/threads`

package/README_CN.md

@@ -68,6 +68,12 @@ npm install
 npm run build
 ```
 
+Windows 维护说明：
+
+- 仓库包含 [patch-codex-sdk-windows-hide.js](D:/codex/Claude-to-IM-skill/scripts/patch-codex-sdk-windows-hide.js)，会在 `npm install` 后给 `@openai/codex-sdk` 打一个保守补丁。
+- 原因是 Windows 下 SDK 拉起 Codex CLI 时若不带 `windowsHide`，每次 IM 触发运行都可能弹出黑色控制台窗口。
+- 后续升级 `@openai/codex-sdk` 时，要确认这个补丁仍然能匹配；如果上游已经原生修复，应直接删除这层补丁。
+
 ## 启动
 
 启动本地应用：
@@ -130,6 +136,7 @@ codex-to-im stop
 - `/` / `/status` 查看当前会话
 - `/h` / `/help` 查看帮助
 - `/t` / `/threads` 查看最近桌面会话，`/t 1` / `/thread 1` 接管第 1 条
+- `/n` / `/new` 在当前正式会话目录下新建线程；这类线程当前只保证在 IM 中可继续，不会自动出现在 Codex Desktop 会话列表中
 - `/n proj1` / `/new proj1` 在默认工作空间下新建项目会话
 - `/m` / `/mode` 查看或切换模式，可选 `code` / `plan` / `ask`
 - `/r` / `/reasoning` 查看或切换思考级别，可选 `1|2|3|4|5`
@@ -156,7 +163,7 @@ codex-to-im stop
 
 如果新建会话时报 `Not inside a trusted directory`，可以：
 
-- 把默认工作目录改成一个你已经信任的 Git 仓库
+- 用 `/new /绝对路径` 或 `/new proj1` 切到一个你已经信任的项目目录
 - 或在基础配置里打开“允许在未信任 Git 目录运行 Codex”，然后重启 Bridge
 
 当前配置页新增了几项和 Codex 运行行为直接相关的配置：
@@ -179,7 +186,7 @@ codex-to-im stop
 
 这样更接近完整 `code` 模式下的开发体验。它适合你自己的受控项目目录，不适合直接照搬到陌生仓库或高风险环境。
 
-通道页还支持“命令反馈使用 Markdown”开关：
+通道页还支持“反馈使用 Markdown”开关：
 - 飞书默认开启
 - 微信默认关闭
 - 只影响 `/h`、`/status`、`/threads` 这类 bridge 自己生成的反馈

package/config.env.example

@@ -10,9 +10,6 @@ CTI_RUNTIME=codex
 # Enabled channels (comma-separated: telegram,discord,feishu,qq,weixin)
 CTI_ENABLED_CHANNELS=feishu
 
-# Default working directory for Codex / bridge sessions
-CTI_DEFAULT_WORKDIR=/path/to/your/project
-
 # Default workspace root for `/new proj1` style project creation.
 # When unset, codex-to-im falls back to `~/cx2im`
 # and expands it per OS (Windows/macOS/Linux).
@@ -45,7 +42,7 @@ CTI_DEFAULT_MODE=code
 # Priority: CTI_CODEX_API_KEY > CODEX_API_KEY > OPENAI_API_KEY
 # CTI_CODEX_API_KEY=
 # CTI_CODEX_BASE_URL=
-# Allow Codex to run when CTI_DEFAULT_WORKDIR is not inside a trusted Git repo.
+# Allow Codex to run when the selected project directory is not inside a trusted Git repo.
 # This project defaults it to true so first-time setup works more smoothly.
 CTI_CODEX_SKIP_GIT_REPO_CHECK=true
 # Default filesystem permission mode for Codex threads created by codex-to-im.
@@ -88,7 +85,7 @@ CTI_TG_CHAT_ID=your-chat-id
 # Current Codex runtime note: thinking/progress can update live, but
 # assistant body text may still arrive only at completion.
 # CTI_FEISHU_STREAMING_ENABLED=true
-# Use Markdown for bridge-generated command feedback such as /h or /status.
+# Use Markdown for bridge-generated feedback such as replies, /h, or /status.
 # Does not affect raw Codex replies.
 # CTI_FEISHU_COMMAND_MARKDOWN_ENABLED=true
 
@@ -114,7 +111,7 @@ CTI_TG_CHAT_ID=your-chat-id
 # only accepts WeChat-provided speech-to-text text and otherwise returns an error.
 # (default false for safety in CLI setups)
 # CTI_WEIXIN_MEDIA_ENABLED=false
-# Use Markdown for bridge-generated command feedback such as /h or /status.
+# Use Markdown for bridge-generated feedback such as replies, /h, or /status.
 # Does not affect raw Codex replies. Default is false for WeChat.
 # CTI_WEIXIN_COMMAND_MARKDOWN_ENABLED=false