cmux-diagnostics

cmux 诊断

使用此技能收集和解释支持安全的 cmux 诊断信息，面向终端用户。默认执行只读检查。不要转储钩子配置文件、会话存储、提示日志、令牌或环境密钥。

快速报告

首先运行捆绑的只读诊断脚本：

# 从 cmux 检出目录
skills/cmux-diagnostics/scripts/cmux-diagnostics

# 从已安装的技能
~/.agents/skills/cmux-diagnostics/scripts/cmux-diagnostics

# 从仅安装 skills.sh 的 Codex
~/.codex/skills/cmux-diagnostics/scripts/cmux-diagnostics

仅当工作区名称、当前工作目录路径和当前 cmux 标识符与用户报告的问题相关时，才使用 --include-context：

skills/cmux-diagnostics/scripts/cmux-diagnostics --include-context

检查内容

1. CLI 和套接字健康：

   command -v cmux
   cmux ping
   cmux capabilities --json
   

   如果套接字命令失败，请检查代理是否在 cmux 终端内运行，以及套接字自动化是否已启用。

2. 设置健康：

   ~/.agents/skills/cmux-settings/scripts/cmux-settings validate
   ~/.agents/skills/cmux-settings/scripts/cmux-settings get terminal.autoResumeAgentSessions
   

   如果用户通过 skills.sh 安装，请改用 ~/.codex/skills/cmux-settings/scripts/cmux-settings。
   如果 terminal.autoResumeAgentSessions 为 false，cmux 会恢复窗格，但不会自动恢复已保存的代理会话。

3. 钩子安装：

   cmux hooks setup --agent codex
   cmux hooks setup --agent opencode
   cmux hooks setup
   

   仅在用户同意后运行安装或卸载命令。cmux hooks setup 会安装 PATH 上找到的受支持代理，并跳过缺失的代理。

4. 会话恢复证据：

   ls -lh ~/.cmuxterm/*-hook-sessions.json 2>/dev/null
   

   缺少会话存储通常意味着自钩子安装以来代理未在 cmux 内运行，钩子被禁用，或者代理集成不支持恢复捕获。

5. 通知路径：

   cmux notify "cmux diagnostic test"
   

   仅当用户准备好接收可见测试通知时使用。

解释

• cmux 未找到：CLI 未安装或不在当前 shell 的 PATH 中。
• cmux ping 失败：应用程序无法通过当前套接字路径访问，应用程序已关闭，或自动化访问被禁用。
• 没有 CMUX_WORKSPACE_ID 或 CMUX_SURFACE_ID：命令可能运行在 cmux 终端之外。某些钩子在 cmux 外会故意无操作。
• 钩子配置存在但无会话存储：在安装钩子后，在 cmux 内运行一个受支持的代理，然后重新检查。
• 会话存储存在但恢复未启动代理：检查 terminal.autoResumeAgentSessions 以及保存的可执行文件是否仍在 PATH 上。
• 设置验证失败：先修复配置。无效的配置可能使后续症状产生误导。

规则

• 在用户要求修复之前，保持只读。
• 绝不打印原始钩子文件、会话 JSON、提示日志、shell 历史、令牌或 API 密钥。
• 总结文件存在性、大小、修改时间和标记存在性，而不是内容。
• 优先使用窄范围修复，例如 cmux hooks setup --agent codex，而不是重新安装所有集成。
• 修复后，重新运行诊断脚本并报告更改的行。