helloagents 3.0.23 → 3.0.26

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.23",
+  "version": "3.0.26",
   "description": "HelloAGENTS — The orchestration kernel that makes any AI CLI smarter. Adds intelligent routing, quality verification (Ralph Loop), safety guards, and notifications.",
   "author": {
     "name": "HelloWind",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.23",
+  "version": "3.0.26",
   "description": "HelloAGENTS — Quality-driven orchestration kernel for AI CLIs with intelligent routing, quality verification (Ralph Loop), safety guards, and notifications.",
   "author": {
     "name": "HelloWind",

package/README.md

@@ -8,7 +8,7 @@
 
 **A workflow layer for AI coding CLIs: skills, project knowledge, delivery checks, safer config writes, and resumable execution.**
 
-[![Version](https://img.shields.io/badge/version-3.0.23-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.0.26-orange.svg)](./package.json)
 [![npm](https://img.shields.io/npm/v/helloagents.svg)](https://www.npmjs.com/package/helloagents)
 [![Node](https://img.shields.io/badge/node-%3E%3D18-339933.svg)](./package.json)
 [![Skills](https://img.shields.io/badge/skills-14-6366f1.svg)](./skills)
@@ -233,7 +233,7 @@ npm install -g helloagents
 If another executable named `helloagents` already exists in your `PATH`, use the stable managed-entry alias:
 
 ```bash
-helloagents-js.cmd
+helloagents-js
 ```
 
 By default, `postinstall` installs the package command, initializes `~/.helloagents/helloagents.json`, and syncs runtime files to `~/.helloagents/helloagents`. No host CLI is deployed unless you set `HELLOAGENTS=target[:mode]`, such as `HELLOAGENTS=codex:global`.
@@ -311,9 +311,9 @@ If you omit `--standby` or `--global`, HelloAGENTS first reuses the tracked/dete
 
 ### npm and one-shot script entries
 
-Use these when you do not want to depend on the `helloagents` binary being available during package updates. In `HELLOAGENTS=target[:mode]`, target can be `all`, `claude`, `gemini`, or `codex`; mode can be `standby` or `global`, and defaults to `standby`.
+Use these when you do not want to depend on the `helloagents` binary being available during package updates. In `HELLOAGENTS=target[:mode]`, target can be `all`, `claude`, `gemini`, or `codex`; mode can be `standby` or `global`. For install, an omitted mode is treated as `standby`. For update, cleanup, uninstall, and branch switching, an omitted mode is forwarded unchanged so HelloAGENTS can reuse the tracked or detected mode for that CLI first.
 
-Host configs use the stable `helloagents-js.cmd` entrypoint and runtime root `~/.helloagents/helloagents`, so Node global package paths can change without breaking managed hooks or Codex `notify`. Codex hooks use standalone `~/.codex/hooks.json` instead of adding large hook blocks to `config.toml`.
+Host configs use the stable `helloagents-js` entrypoint and runtime root `~/.helloagents/helloagents`, so Node global package paths can change without breaking managed hooks or Codex `notify`. Codex hooks use standalone `~/.codex/hooks.json` instead of adding large hook blocks to `config.toml`, and Codex global plugin roots plus plugin cache now link back to that same stable runtime root.
 
 #### npm commands
 
@@ -406,6 +406,8 @@ $env:HELLOAGENTS="codex:standby"; $env:HELLOAGENTS_ACTION="cleanup"; irm https:/
 $env:HELLOAGENTS="gemini"; $env:HELLOAGENTS_ACTION="uninstall"; irm https://raw.githubusercontent.com/hellowind777/helloagents/main/install.ps1 | iex
 ```
 
+The PowerShell wrapper now forwards the same npm arguments as `install.sh`, so install, update, cleanup, uninstall, and `switch-branch` stay on the same lifecycle path.
+
 ### Branch switching
 
 `switch-branch` installs the requested npm/GitHub ref first, then syncs host CLIs through npm scripts so it does not depend on the `helloagents` executable during updates:
@@ -439,7 +441,7 @@ npm uninstall -g helloagents
 |-----|----------------|----------------|
 | Claude Code | native plugin install | managed by Claude Code plugin system |
 | Gemini CLI | native extension install | managed by Gemini extension system |
-| Codex CLI | native local-plugin chain | `~/.agents/plugins/marketplace.json`, `~/plugins/helloagents/`, `~/.codex/plugins/cache/local-plugins/helloagents/local/`, `~/.codex/config.toml`, `~/.codex/hooks.json`, `~/.codex/helloagents -> ~/plugins/helloagents` |
+| Codex CLI | native local-plugin chain | `~/.agents/plugins/marketplace.json`, `~/plugins/helloagents/ -> ~/.helloagents/helloagents`, `~/.codex/plugins/cache/local-plugins/helloagents/local/ -> ~/.helloagents/helloagents`, `~/.codex/config.toml`, `~/.codex/hooks.json`, `~/.codex/helloagents -> ~/.helloagents/helloagents` |
 
 In global mode, HelloAGENTS now attempts the host-native install commands automatically. If a host command is unavailable, run the same commands manually:
 
@@ -640,11 +642,15 @@ Default shape:
 Codex is rules-file driven by default.
 
 - standby writes `~/.codex/AGENTS.md`
-- standby writes a managed `model_instructions_file = "~/.codex/AGENTS.md"`
-- standby writes a managed `notify = ["helloagents-js.cmd", "codex-notify"]` command for closeout notification
+- standby writes a portable managed `model_instructions_file = "~/.codex/AGENTS.md"`
+- standby writes a managed `notify = ["helloagents-js", "codex-notify"]` command for closeout notification
 - standby writes silent Codex hooks to `~/.codex/hooks.json`
+- Codex `SessionStart` stays silent and reads the current `~/.helloagents/helloagents.json` at runtime instead of baking a config snapshot into `config.toml`, so first-turn and post-compaction settings stay current
+- install and update also sync HelloAGENTS-managed Codex hook trust state in `~/.codex/config.toml`, so Codex 0.129.0+ does not re-prompt for the managed hooks
+- that hook trust state is machine-local generated metadata derived from the current absolute `~/.codex/hooks.json` path; unlike `model_instructions_file = "~/.codex/AGENTS.md"`, it is not portable config and should be regenerated on each machine
 - standby creates `~/.codex/helloagents -> ~/.helloagents/helloagents`
-- global mode installs the native local-plugin chain and also loads silent hooks from `~/.codex/hooks.json`
+- global mode installs the native local-plugin chain, but keeps `~/.helloagents/helloagents` as the single managed runtime source by linking plugin roots, plugin cache, and `~/.codex/helloagents` back to it
+- cleanup removes only the HelloAGENTS-managed hook trust entries and legacy managed notify residues, while keeping user-owned hook state untouched
 - Codex hooks only synchronize runtime state and enforce Stop gates; they do not inject HelloAGENTS rules or route text through hook output
 - Codex closeout de-duplicates Stop hooks and native `codex-notify`, so one turn does not notify twice
 - `/goal` remains Codex-native. Enable it explicitly with `helloagents codex goals enable` when long-running plan execution is needed
@@ -658,11 +664,13 @@ Run all tests:
 npm test
 ```
 
-The current suite includes 107 tests and covers:
+The current suite includes 118 tests and covers:
 
 - install, update, uninstall, cleanup, and mode switching
+- one-shot PowerShell lifecycle dispatch plus shell-wrapper mode-routing rules for install, update, cleanup, uninstall, and branch switching
 - Claude, Gemini, and Codex config merge and restore behavior
-- Codex managed `model_instructions_file`, `notify`, `hooks.json`, local plugin, marketplace, and cache behavior
+- Codex managed `model_instructions_file`, `notify`, `hooks.json`, hook trust state, local plugin, marketplace, and cache behavior
+- Codex cleanup of legacy managed notify variants on Windows and canonical managed notify restoration rules
 - Codex `/goal` feature toggles, long-running route context, and goal-aware command contracts
 - `helloagents doctor`
 - project storage and `repo-shared` behavior

package/README_CN.md

@@ -8,7 +8,7 @@
 
 **面向 AI 编码 CLI 的工作流层：技能、知识库、交付检查、更安全的配置写入，以及可恢复的执行流程。**
 
-[![Version](https://img.shields.io/badge/version-3.0.23-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.0.26-orange.svg)](./package.json)
 [![npm](https://img.shields.io/npm/v/helloagents.svg)](https://www.npmjs.com/package/helloagents)
 [![Node](https://img.shields.io/badge/node-%3E%3D18-339933.svg)](./package.json)
 [![Skills](https://img.shields.io/badge/skills-14-6366f1.svg)](./skills)
@@ -233,7 +233,7 @@ npm install -g helloagents
 如果系统里已经有别的 `helloagents` 可执行文件，可以使用稳定的受管入口别名：
 
 ```bash
-helloagents-js.cmd
+helloagents-js
 ```
 
 默认情况下，`postinstall` 会安装包命令、初始化 `~/.helloagents/helloagents.json`，并把运行时文件同步到 `~/.helloagents/helloagents`。如果希望 npm 在安装或更新后直接部署，设置 `HELLOAGENTS=目标[:模式]`，例如 `HELLOAGENTS=codex:global`。
@@ -311,9 +311,9 @@ helloagents codex goals enable
 
 ### npm 和一键脚本入口
 
-当你不想依赖更新过程中的 `helloagents` 可执行文件时，用 npm 或一键脚本。`HELLOAGENTS=目标[:模式]` 中，目标支持 `all`、`claude`、`gemini`、`codex`；模式支持 `standby`、`global`，省略时默认 `standby`。
+当你不想依赖更新过程中的 `helloagents` 可执行文件时，用 npm 或一键脚本。`HELLOAGENTS=目标[:模式]` 中，目标支持 `all`、`claude`、`gemini`、`codex`；模式支持 `standby`、`global`。用于安装时，省略模式按 `standby` 处理；用于更新、清理、卸载和切换分支时，省略模式会原样下传，让 HelloAGENTS 先复用该 CLI 已记录或检测到的模式。
 
-宿主配置使用稳定的 `helloagents-js.cmd` 入口和运行根目录 `~/.helloagents/helloagents`，Node 全局包路径变化不会破坏受管 hooks 或 Codex `notify`。Codex hooks 使用独立 `~/.codex/hooks.json`，不把大段配置写入 `config.toml`。
+宿主配置使用稳定的 `helloagents-js` 入口和运行根目录 `~/.helloagents/helloagents`，Node 全局包路径变化不会破坏受管 hooks 或 Codex `notify`。Codex hooks 使用独立 `~/.codex/hooks.json`，不把大段配置写入 `config.toml`；Codex 全局插件根目录和插件缓存也会回链到这个稳定运行根目录。
 
 #### npm 命令
 
@@ -406,6 +406,8 @@ $env:HELLOAGENTS="codex:standby"; $env:HELLOAGENTS_ACTION="cleanup"; irm https:/
 $env:HELLOAGENTS="gemini"; $env:HELLOAGENTS_ACTION="uninstall"; irm https://raw.githubusercontent.com/hellowind777/helloagents/main/install.ps1 | iex
 ```
 
+PowerShell 包装脚本现在会传递与 `install.sh` 相同的 npm 参数，因此安装、更新、清理、卸载和 `switch-branch` 走的是同一条生命周期链路。
+
 ### 分支切换
 
 `switch-branch` 会先安装指定 npm/GitHub ref，再通过 npm 脚本同步宿主 CLI，避免依赖更新过程中的 `helloagents` 可执行文件：
@@ -439,7 +441,7 @@ npm uninstall -g helloagents
 |-----|----------|----------|
 | Claude Code | 原生插件安装 | 由 Claude Code 插件系统管理 |
 | Gemini CLI | 原生扩展安装 | 由 Gemini 扩展系统管理 |
-| Codex CLI | 原生本地插件流程 | `~/.agents/plugins/marketplace.json`、`~/plugins/helloagents/`、`~/.codex/plugins/cache/local-plugins/helloagents/local/`、`~/.codex/config.toml`、`~/.codex/hooks.json`、`~/.codex/helloagents -> ~/plugins/helloagents` |
+| Codex CLI | 原生本地插件流程 | `~/.agents/plugins/marketplace.json`、`~/plugins/helloagents/ -> ~/.helloagents/helloagents`、`~/.codex/plugins/cache/local-plugins/helloagents/local/ -> ~/.helloagents/helloagents`、`~/.codex/config.toml`、`~/.codex/hooks.json`、`~/.codex/helloagents -> ~/.helloagents/helloagents` |
 
 全局模式下，HelloAGENTS 会自动尝试宿主原生命令。若宿主命令不可用，再手动执行：
 
@@ -642,11 +644,15 @@ UI 任务遵循以下优先级：
 Codex 默认走规则文件驱动。
 
 - 标准模式写入 `~/.codex/AGENTS.md`
-- 标准模式写入受管 `model_instructions_file = "~/.codex/AGENTS.md"`
-- 标准模式写入受管 `notify = ["helloagents-js.cmd", "codex-notify"]` 命令用于收尾通知
+- 标准模式写入可移植的受管 `model_instructions_file = "~/.codex/AGENTS.md"`
+- 标准模式写入受管 `notify = ["helloagents-js", "codex-notify"]` 命令用于收尾通知
 - 标准模式把静默 Codex hooks 写入 `~/.codex/hooks.json`
+- Codex 的 `SessionStart` 保持静默，并在运行时读取当前 `~/.helloagents/helloagents.json`，不会把配置快照固化进 `config.toml`，因此首次对话和上下文压缩后的设置都能保持最新
+- 安装和更新还会把 HelloAGENTS 受管的 Codex hook trust 状态同步到 `~/.codex/config.toml`，因此 Codex 0.129.0+ 不会再对这些受管 hooks 反复提示确认
+- 这些 hook trust 状态是基于当前机器 `~/.codex/hooks.json` 真实绝对路径生成的本机状态；它不同于 `model_instructions_file = "~/.codex/AGENTS.md"` 这类可移植配置，应在每台机器上重新生成
 - 标准模式创建 `~/.codex/helloagents -> ~/.helloagents/helloagents`
-- 全局模式安装原生本地插件流程，并同样用 `~/.codex/hooks.json` 加载静默 hooks
+- 全局模式安装原生本地插件流程，但仍把 `~/.helloagents/helloagents` 作为唯一受管运行时源；插件根目录、插件缓存和 `~/.codex/helloagents` 都会回链到它
+- 清理时只删除 HelloAGENTS 自己写入的 hook trust 条目和旧式受管 notify 残留，不影响用户已有的 hook 状态
 - Codex hooks 只做静默运行态同步和 Stop 门禁，不通过 hook 注入 HelloAGENTS 规则或路由说明
 - Codex 收尾会对 Stop hook 和原生 `codex-notify` 去重，避免同一轮重复通知
 - `/goal` 保持 Codex 原生能力；需要长程执行时，用 `helloagents codex goals enable` 显式启用
@@ -660,11 +666,13 @@ Codex 默认走规则文件驱动。
 npm test
 ```
 
-当前测试共 107 项，覆盖：
+当前测试共 118 项，覆盖：
 
 - 安装、更新、卸载、清理和模式切换
+- PowerShell 一键脚本分发链路，以及 shell 包装脚本在安装、更新、清理、卸载和分支切换中的模式传递规则
 - Claude、Gemini、Codex 的配置合并与恢复
-- Codex 受管 `model_instructions_file`、`notify`、`hooks.json`、本地插件、marketplace 和缓存行为
+- Codex 受管 `model_instructions_file`、`notify`、`hooks.json`、hook trust 状态、本地插件、marketplace 和缓存行为
+- Windows 下 Codex 旧式受管 notify 变体的清理，以及受管 notify 恢复规则
 - Codex `/goal` 功能开关、长程路由上下文和 goal 感知命令契约
 - `helloagents doctor`
 - 项目存储和 `repo-shared`

package/bootstrap-lite.md

@@ -6,7 +6,7 @@
 配置文件: ~/.helloagents/helloagents.json
 `output_language` 非空时，所有用户可见文本使用该语言；为空则跟随用户当前语言。
 会话级缓存优先：当前上下文已有"当前用户设置"、原始 JSON 或读取摘要，且覆盖所需配置项时，直接复用。
-仅在缺少所需项、用户要求刷新，或本轮修改后需要核验时读取；输出格式只在缺少 `output_format` 已知值时触发读取。
+仅在缺少所需项、用户要求刷新，或本轮修改后需要核验时读取；对 Codex 来说，首次对话前若当前上下文仍缺少所需配置项，必须先读取一次 `~/.helloagents/helloagents.json`，压缩/恢复后的首次对话同样先重读一次；输出格式只在缺少 `output_format` 已知值时触发读取。
 同一会话内，同一路径的配置文件、模块、SKILL、模板只读一次并跨轮复用；读取失败必须明示，并按默认值或已知设置执行。
 
 ## 编码原则
@@ -30,8 +30,8 @@
 ### 语言与表述（强制）
 - 所有用户可见文本，包括回复、生成文件、CLI 输出、运行时提示、模板内容、文档与说明，都必须遵守：简洁、自然、准确、合理、不赘述、不冗余、不过度精简
 - 准确优先于压缩：不得为了更短而省略必要的条件、边界、风险、状态、路径、验证结论或下一步动作
-- 不写黑话、营销话、内部化表述或空泛形容；源码字段名、协议名、命令、路径、配置键等必须保留原名时除外
-- 不写无执行价值的客套、邀约、重复确认、能力陈述或空泛建议
+- 不输出黑话、营销话、内部化表述或空泛形容；源码字段名、协议名、命令、路径、配置键等必须保留原名时除外
+- 不输出客套内容、邀约式表述、重复确认、能力陈述或空泛建议
 - 同一概念前后用语保持一致；先给结论再给细节，避免同义反复、重复解释和堆砌近义句
 - 优化既有约束或文案时，优先在原条目内收敛表达；只有边界独立且原条目无法承载时才新增条目，并同步删除重复表述
 

package/bootstrap.md

@@ -6,7 +6,7 @@
 配置文件: ~/.helloagents/helloagents.json
 `output_language` 非空时，所有用户可见文本使用该语言；为空则跟随用户当前语言。
 会话级缓存优先：当前上下文已有"当前用户设置"、原始 JSON 或读取摘要，且覆盖所需配置项时，直接复用。
-仅在缺少所需项、用户要求刷新，或本轮修改后需要核验时读取；输出格式只在缺少 `output_format` 已知值时触发读取。
+仅在缺少所需项、用户要求刷新，或本轮修改后需要核验时读取；对 Codex 来说，首次对话前若当前上下文仍缺少所需配置项，必须先读取一次 `~/.helloagents/helloagents.json`，压缩/恢复后的首次对话同样先重读一次；输出格式只在缺少 `output_format` 已知值时触发读取。
 同一会话内，同一路径的配置文件、模块、SKILL、模板只读一次并跨轮复用；读取失败必须明示，并按默认值或已知设置执行。
 
 ## 编码原则
@@ -30,8 +30,8 @@
 ### 语言与表述（强制）
 - 所有用户可见文本，包括回复、生成文件、CLI 输出、运行时提示、模板内容、文档与说明，都必须遵守：简洁、自然、准确、合理、不赘述、不冗余、不过度精简
 - 准确优先于压缩：不得为了更短而省略必要的条件、边界、风险、状态、路径、验证结论或下一步动作
-- 不写黑话、营销话、内部化表述或空泛形容；源码字段名、协议名、命令、路径、配置键等必须保留原名时除外
-- 不写无执行价值的客套、邀约、重复确认、能力陈述或空泛建议
+- 不输出黑话、营销话、内部化表述或空泛形容；源码字段名、协议名、命令、路径、配置键等必须保留原名时除外
+- 不输出客套内容、邀约式表述、重复确认、能力陈述或空泛建议
 - 同一概念前后用语保持一致；先给结论再给细节，避免同义反复、重复解释和堆砌近义句
 - 优化既有约束或文案时，优先在原条目内收敛表达；只有边界独立且原条目无法承载时才新增条目，并同步删除重复表述
 

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.23",
+  "version": "3.0.26",
   "description": "Quality-driven orchestration kernel for AI CLIs",
   "contextFileName": "bootstrap.md",
   "author": "HelloWind",

package/install.ps1

@@ -26,15 +26,14 @@ if ($env:HELLOAGENTS) {
 }
 
 if (-not $Target) { $Target = "all" }
-if (-not $Mode) { $Mode = "standby" }
 $Target = $Target.ToLowerInvariant()
-$Mode = $Mode.ToLowerInvariant()
+if ($Mode) { $Mode = $Mode.ToLowerInvariant() }
 
 if (@("all", "claude", "gemini", "codex") -notcontains $Target) {
     throw "Unsupported HELLOAGENTS target: $Target"
 }
 
-if (@("standby", "global") -notcontains $Mode) {
+if ($Mode -and @("standby", "global") -notcontains $Mode) {
     throw "Unsupported HELLOAGENTS mode: $Mode"
 }
 
@@ -47,26 +46,33 @@ if (-not $Package) {
 }
 
 function Invoke-Npm {
-    param([string[]]$Args)
-    & npm @Args
+    param([string[]]$NpmArgs)
+    & npm @NpmArgs
     if ($LASTEXITCODE -ne 0) {
-        throw "npm $($Args -join ' ') failed with exit code $LASTEXITCODE"
+        throw "npm $($NpmArgs -join ' ') failed with exit code $LASTEXITCODE"
     }
 }
 
 function Enable-PostinstallDeploy {
     $env:HELLOAGENTS_DEPLOY = "1"
     $env:HELLOAGENTS_TARGET = $Target
-    $env:HELLOAGENTS_MODE = $Mode
+    if ($Mode) {
+        $env:HELLOAGENTS_MODE = $Mode
+    } else {
+        $env:HELLOAGENTS_MODE = "standby"
+    }
 }
 
 function Invoke-HostScript {
     param([string]$ScriptName)
+    $scriptArgs = @("explore", "-g", "helloagents", "--", "npm", "run", $ScriptName, "--")
     if ($Target -eq "all") {
-        Invoke-Npm @("explore", "-g", "helloagents", "--", "npm", "run", $ScriptName, "--", "--all", "--$Mode")
+        $scriptArgs += "--all"
     } else {
-        Invoke-Npm @("explore", "-g", "helloagents", "--", "npm", "run", $ScriptName, "--", $Target, "--$Mode")
+        $scriptArgs += $Target
     }
+    if ($Mode) { $scriptArgs += "--$Mode" }
+    Invoke-Npm -NpmArgs $scriptArgs
 }
 
 function Sync-Hosts {
@@ -84,15 +90,15 @@ function Uninstall-Hosts {
 switch ($Action) {
     "install" {
         Enable-PostinstallDeploy
-        Invoke-Npm @("install", "-g", $Package)
+        Invoke-Npm -NpmArgs @("install", "-g", $Package)
     }
     "update" {
         if ($Branch -or $env:HELLOAGENTS_PACKAGE) {
-            Invoke-Npm @("install", "-g", $Package)
+            Invoke-Npm -NpmArgs @("install", "-g", $Package)
         } else {
             & npm update -g helloagents
             if ($LASTEXITCODE -ne 0) {
-                Invoke-Npm @("install", "-g", "helloagents")
+                Invoke-Npm -NpmArgs @("install", "-g", "helloagents")
             }
         }
         Sync-Hosts
@@ -104,14 +110,14 @@ switch ($Action) {
         if (-not $Branch -and -not $env:HELLOAGENTS_PACKAGE) {
             throw "HELLOAGENTS_BRANCH or HELLOAGENTS_PACKAGE is required for switch-branch"
         }
-        Invoke-Npm @("install", "-g", $Package)
+        Invoke-Npm -NpmArgs @("install", "-g", $Package)
         Sync-Hosts
     }
     "branch" {
         if (-not $Branch -and -not $env:HELLOAGENTS_PACKAGE) {
             throw "HELLOAGENTS_BRANCH or HELLOAGENTS_PACKAGE is required for branch"
         }
-        Invoke-Npm @("install", "-g", $Package)
+        Invoke-Npm -NpmArgs @("install", "-g", $Package)
         Sync-Hosts
     }
     "uninstall" {
@@ -120,7 +126,7 @@ switch ($Action) {
         } catch {
             Write-Warning "Failed to cleanup HelloAGENTS host integrations before uninstall: $_"
         }
-        Invoke-Npm @("uninstall", "-g", "helloagents")
+        Invoke-Npm -NpmArgs @("uninstall", "-g", "helloagents")
     }
     default {
         throw "Unsupported HELLOAGENTS_ACTION: $Action"

package/install.sh

@@ -32,7 +32,6 @@ if [ -n "${HELLOAGENTS:-}" ]; then
 fi
 
 TARGET="${TARGET:-all}"
-MODE="${MODE:-standby}"
 TARGET="$(printf '%s' "$TARGET" | tr '[:upper:]' '[:lower:]')"
 MODE="$(printf '%s' "$MODE" | tr '[:upper:]' '[:lower:]')"
 
@@ -41,10 +40,12 @@ case "$TARGET" in
   *) echo "Unsupported HELLOAGENTS target: $TARGET" >&2; exit 1 ;;
 esac
 
-case "$MODE" in
-  standby|global) ;;
-  *) echo "Unsupported HELLOAGENTS mode: $MODE" >&2; exit 1 ;;
-esac
+if [ -n "$MODE" ]; then
+  case "$MODE" in
+    standby|global) ;;
+    *) echo "Unsupported HELLOAGENTS mode: $MODE" >&2; exit 1 ;;
+  esac
+fi
 
 if [ -z "$PACKAGE" ]; then
   if [ -n "$BRANCH" ]; then
@@ -56,32 +57,56 @@ fi
 
 sync_hosts() {
   if [ "$TARGET" = "all" ]; then
-    npm explore -g helloagents -- npm run sync-hosts -- --all "--$MODE"
+    if [ -n "$MODE" ]; then
+      npm explore -g helloagents -- npm run sync-hosts -- --all "--$MODE"
+    else
+      npm explore -g helloagents -- npm run sync-hosts -- --all
+    fi
   else
-    npm explore -g helloagents -- npm run sync-hosts -- "$TARGET" "--$MODE"
+    if [ -n "$MODE" ]; then
+      npm explore -g helloagents -- npm run sync-hosts -- "$TARGET" "--$MODE"
+    else
+      npm explore -g helloagents -- npm run sync-hosts -- "$TARGET"
+    fi
   fi
 }
 
 cleanup_hosts() {
   if [ "$TARGET" = "all" ]; then
-    npm explore -g helloagents -- npm run cleanup-hosts -- --all "--$MODE"
+    if [ -n "$MODE" ]; then
+      npm explore -g helloagents -- npm run cleanup-hosts -- --all "--$MODE"
+    else
+      npm explore -g helloagents -- npm run cleanup-hosts -- --all
+    fi
   else
-    npm explore -g helloagents -- npm run cleanup-hosts -- "$TARGET" "--$MODE"
+    if [ -n "$MODE" ]; then
+      npm explore -g helloagents -- npm run cleanup-hosts -- "$TARGET" "--$MODE"
+    else
+      npm explore -g helloagents -- npm run cleanup-hosts -- "$TARGET"
+    fi
   fi
 }
 
 uninstall_hosts() {
   if [ "$TARGET" = "all" ]; then
-    npm explore -g helloagents -- npm run uninstall -- --all "--$MODE"
+    if [ -n "$MODE" ]; then
+      npm explore -g helloagents -- npm run uninstall -- --all "--$MODE"
+    else
+      npm explore -g helloagents -- npm run uninstall -- --all
+    fi
   else
-    npm explore -g helloagents -- npm run uninstall -- "$TARGET" "--$MODE"
+    if [ -n "$MODE" ]; then
+      npm explore -g helloagents -- npm run uninstall -- "$TARGET" "--$MODE"
+    else
+      npm explore -g helloagents -- npm run uninstall -- "$TARGET"
+    fi
   fi
 }
 
 enable_postinstall_deploy() {
   export HELLOAGENTS_DEPLOY=1
   export HELLOAGENTS_TARGET="$TARGET"
-  export HELLOAGENTS_MODE="$MODE"
+  export HELLOAGENTS_MODE="${MODE:-standby}"
 }
 
 case "$ACTION" in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.23",
+  "version": "3.0.26",
   "type": "module",
   "description": "HelloAGENTS — The orchestration kernel that makes any AI CLI smarter. Adds intelligent routing, quality verification (Ralph Loop), safety guards, and notifications.",
   "author": "HelloWind",

package/scripts/cli-codex-config.mjs

@@ -8,15 +8,22 @@ import {
 
 export const CODEX_PLUGIN_CONFIG_HEADER = '[plugins."helloagents@local-plugins"]'
 export const CODEX_FEATURES_HEADER = '[features]'
+export const CODEX_TUI_HEADER = '[tui]'
 export const CODEX_MANAGED_TOML_COMMENT = '# helloagents-managed'
 export const CODEX_MANAGED_MODEL_INSTRUCTIONS_PATH = '~/.codex/AGENTS.md'
-export const CODEX_MANAGED_NOTIFY_COMMAND = 'helloagents-js.cmd'
+export const CODEX_MANAGED_NOTIFY_COMMAND = 'helloagents-js'
 export const CODEX_MANAGED_NOTIFY_VALUE = `["${CODEX_MANAGED_NOTIFY_COMMAND}", "codex-notify"]`
+const CODEX_MANAGED_NOTIFY_LEGACY_VALUES = [
+  `["${CODEX_MANAGED_NOTIFY_COMMAND}.cmd", "codex-notify"]`,
+  `["${CODEX_MANAGED_NOTIFY_COMMAND}.exe", "codex-notify"]`,
+]
+export const CODEX_MANAGED_TUI_NOTIFICATIONS_VALUE = '["plan-mode-prompt"]'
 export const CODEX_HOOKS_FEATURE_KEY = 'hooks'
 export const CODEX_LEGACY_HOOKS_FEATURE_KEY = 'codex_hooks'
 export const CODEX_GOALS_FEATURE_KEY = 'goals'
 export const CODEX_MANAGED_GOALS_FEATURE_LINE = `${CODEX_GOALS_FEATURE_KEY} = true ${CODEX_MANAGED_TOML_COMMENT}`
 export const CODEX_MANAGED_GOALS_DISABLED_LINE = `${CODEX_GOALS_FEATURE_KEY} = false ${CODEX_MANAGED_TOML_COMMENT}`
+export const CODEX_MANAGED_TUI_NOTIFICATIONS_LINE = `notifications = ${CODEX_MANAGED_TUI_NOTIFICATIONS_VALUE} ${CODEX_MANAGED_TOML_COMMENT}`
 
 function normalizePath(value = '') {
   return String(value || '').replace(/\\/g, '/')
@@ -106,9 +113,17 @@ export function readCodexGoalsFeatureLine(text) {
   return readCodexFeatureLine(text, CODEX_GOALS_FEATURE_KEY)
 }
 
+export function readCodexTuiNotificationsLine(text) {
+  return readCodexSectionLine(text, CODEX_TUI_HEADER, 'notifications')
+}
+
 export function readCodexFeatureLine(text, key) {
+  return readCodexSectionLine(text, CODEX_FEATURES_HEADER, key)
+}
+
+export function readCodexSectionLine(text, headerLine, key) {
   const lines = splitTomlLines(text)
-  const bounds = findSectionBounds(lines, CODEX_FEATURES_HEADER)
+  const bounds = findSectionBounds(lines, headerLine)
   const keyIndex = findSectionKeyIndex(lines, bounds, key)
   return keyIndex >= 0 ? lines[keyIndex].trim() : ''
 }
@@ -157,7 +172,16 @@ export function isManagedCodexModelInstruction(line = '') {
 
 export function isManagedCodexNotify(line = '') {
   const value = String(line || '').replace(/\\/g, '/')
-  return value.includes(CODEX_MANAGED_NOTIFY_VALUE)
+  return value.includes(CODEX_MANAGED_TOML_COMMENT)
+    && (
+      value.includes(CODEX_MANAGED_NOTIFY_VALUE)
+      || CODEX_MANAGED_NOTIFY_LEGACY_VALUES.some((entry) => value.includes(entry))
+    )
+}
+
+export function isManagedCodexTuiNotifications(line = '') {
+  return String(line || '').includes(CODEX_MANAGED_TUI_NOTIFICATIONS_VALUE)
+    && String(line || '').includes(CODEX_MANAGED_TOML_COMMENT)
 }
 
 function isManagedFeatureLine(line = '', key = '') {
@@ -223,6 +247,29 @@ export function installCodexManagedTopLevelConfig(toml, { modelInstructionsPath
   ])
 }
 
+export function installCodexManagedTuiConfig(text) {
+  const currentLine = readCodexTuiNotificationsLine(text)
+  if (currentLine && !isManagedCodexTuiNotifications(currentLine)) {
+    return normalizeToml(text)
+  }
+
+  return upsertTomlSectionLine(
+    text,
+    CODEX_TUI_HEADER,
+    'notifications',
+    CODEX_MANAGED_TUI_NOTIFICATIONS_LINE,
+  )
+}
+
+export function removeCodexManagedTuiConfig(text) {
+  return removeTomlSectionLine(
+    text,
+    CODEX_TUI_HEADER,
+    'notifications',
+    isManagedCodexTuiNotifications,
+  )
+}
+
 export function restoreCodexTopLevelConfig(toml, { modelInstructionsLine = '', notifyLine = '' }) {
   return upsertOrderedCodexTopLevelLines(toml, [
     modelInstructionsLine,