mcpField
H
hud

hud

github.com/yeachan-heoAgent 工作流33.7k127 次安装1 天前更新
代码仓库

关于 hud

hud 是用于查看 Codex 状态和 OMX 编排信息的技能，结合内置 statusLine 与 `omx hud` 命令行，并支持预设、实时更新和 JSON 输出。

主要功能

  1. 01显示 Codex 模型、分支和上下文
  2. 02显示 OMX 工作流与活动状态
  3. 03使用 `--watch` 实时更新
  4. 04为脚本输出 JSON
  5. 05提供简洁、聚焦和完整预设

适用场景

  1. 01监控正在运行的 OMX 工作流和轮次
  2. 02查看 Codex 上下文与 Git 分支状态
  3. 03在脚本中读取 HUD 状态
  4. 04调整会话中的显示详细程度

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/yeachan-heo/oh-my-codex --skill hud

安装后在 Claude Code 中输入/hud确认已加载。

详细介绍

HUD 技能

OMX HUD 采用两层架构：

  1. 第 1 层 - Codex 内置 statusLine：实时 TUI 页脚，显示模型、git 分支和上下文用量。通过 ~/.codex/config.toml 中的 [tui] status_line 配置。无需编写任何代码。

  2. 第 2 层 - omx hud 命令行命令：显示 OMX 特有的编排状态（ralph、ultrawork、autopilot、team、pipeline、ecomode、turns）。读取 .omx/state/ 文件。

快速命令

命令描述
omx hud显示当前 HUD（模式、轮次、活动）
omx hud --watch实时更新显示（每 1s 轮询一次）
omx hud --json用于脚本的原始状态输出
omx hud --preset=minimal极简显示
omx hud --preset=focused默认显示
omx hud --preset=full显示所有元素

预设

minimal
[OMX] ralph:3/10 | turns:42
focused（默认）
[OMX] ralph:3/10 | ultrawork | team:3 workers | turns:42 | last:5s ago
full
[OMX] ralph:3/10 | ultrawork | autopilot:execution | team:3 workers | pipeline:exec | turns:42 | last:5s ago | total-turns:156

设置

omx setup 会自动配置这两层：

  • 向 ~/.codex/config.toml 添加 [tui] status_line（第 1 层）
  • 写入带有默认预设的 .omx/hud-config.json（第 2 层）
  • 默认预设为 focused；如果 HUD/statusline 的更改没有显示出来，请重启 Codex CLI 一次。

第 1 层：Codex 内置 StatusLine

在 ~/.codex/config.toml 中配置：

[tui]
status_line = ["model-with-reasoning", "git-branch", "context-remaining"]

可用的内置项（Codex CLI v0.101.0+）： model-name、model-with-reasoning、current-dir、project-root、git-branch、context-remaining、context-used、five-hour-limit、weekly-limit、codex-version、context-window-size、used-tokens、total-input-tokens、total-output-tokens、session-id

第 2 层：OMX 编排 HUD

omx hud 命令读取以下状态文件：

  • .omx/state/ralph-state.json - Ralph 循环迭代
  • .omx/state/ultrawork-state.json - Ultrawork 模式
  • .omx/state/autopilot-state.json - Autopilot 阶段
  • .omx/state/team-state.json - Team 工作进程
  • .omx/state/pipeline-state.json - Pipeline 阶段
  • .omx/state/ecomode-state.json - Ecomode 激活
  • .omx/state/hud-state.json - 上次活动（来自 notify hook）
  • .omx/metrics.json - 轮次计数

配置

HUD 配置存储在 .omx/hud-config.json：

{
  "preset": "focused"
}

颜色编码

  • 绿色：正常/健康
  • 黄色：警告（ralph >70% 上限）
  • 红色：严重（ralph >90% 上限）

故障排查

如果 TUI statusline 没有显示：

  1. 确保已安装 Codex CLI v0.101.0+
  2. 运行 omx setup 配置 [tui] 部分
  3. 重启 Codex CLI

如果 omx hud 显示“No active modes”：

  • 在没有工作流运行时这是预期行为
  • 启动一个显式请求且受支持的工作流（$autopilot 或 $ultragoal）并再次检查

评论

支持 Markdown