mcpField
H
hud

hud

github.com/yeachan-heoエージェントワークフロー33.7k127 回インストール1 日前に更新
リポジトリ

hud について

hud は、Codex の状態と OMX のオーケストレーション情報を表示するスキルです。組み込み statusLine と `omx hud` コマンドを組み合わせ、プリセット、ライブ更新、JSON 出力に対応します。

主な機能

  1. 01Codex のモデル、ブランチ、コンテキスト表示
  2. 02OMX のワークフローと活動状況の表示
  3. 03`--watch` によるライブ更新
  4. 04スクリプト向け JSON 出力
  5. 05簡易、標準、詳細プリセット

活用シーン

  1. 01実行中の OMX ワークフローとターンの監視
  2. 02Codex のコンテキストと 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 は 2 層のアーキテクチャを採用しています。

  1. レイヤー 1 - Codex 組み込みの statusLine: モデル、Git ブランチ、コンテキスト使用量をリアルタイムに表示する TUI のフッターです。~/.codex/config.toml の [tui] status_line で設定します。コードは不要です。

  2. レイヤー 2 - omx hud CLI コマンド: OMX 固有のオーケストレーション状態（ralph、ultrawork、autopilot、team、pipeline、ecomode、turns）を表示します。.omx/state/ 内のファイルを読み取ります。

クイックコマンド

コマンド説明
omx hud現在の HUD（モード、ターン、アクティビティ）を表示
omx hud --watchリアルタイムに更新される表示（1 秒ごとにポーリング）
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 フックから）
  • .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 対応