Theme / v0.21.4

Oh My Codex (OMX)

Codex CLI 工作流增強層

指令詳解

omx hud 指令詳解

如何使用 omx hud 配置與客製化動態儀表板,即時監控任務執行與錯誤自愈狀態

指令用途

在執行自動駕駛(Autopilot)任務時,開發者需要清晰地知道當前正在執行哪一個 Mission,以及 $plan 是否在進行自我修復。

omx hud 是專為 OMX 狀態欄視覺化 設計的配置指令。它會在終端機頂部渲染一個固定的 HUD 控制區,即時反饋:

  • 當前執行的 Mission ID 與描述。
  • 本次任務累計的 Token 與費用開支。
  • 專案的 AST 索引狀態與本地快取健康度。

這讓整個無人值守開發過程 100% 透明可視,開發者可以隨時了解 AI 是否卡在某處。


運作流程

  1. 界面接管:使用 curses 或者是 tmux 的 Pane 配置,在畫面最頂端渲染一個狀態條。
  2. 數據同步:實時訂閱本地 .omx/ 快取中 active mission 的執行日誌與 CPU 佔用。
  3. 動態刷新:每 300 毫秒刷新一次顯示,保持數據的即時性。

實戰對話範例

範例:啟動帶有詳細日誌的 OMX HUD

  • You:
    omx hud --enable --debug-logs
  • AI:

    好的,我已為您開啟 OMX 動態 HUD 面板,並設定在右側 Pane 同步顯示詳細的工具調用 debug 日誌。

    終端機頂部已顯示: [OMX HUD] MISSION: 2/3 (Write Tests) | Spent: $0.85 | Autopilot: ACTIVE

    右側 Log 顯示(實時滾動): [tools] call codebase-memory::search_graph(query: "BillingService") -> Success. [tools] call replace_file_content(TargetFile: "BillingServiceTests.cs") -> Success.

    這能讓您在不影響主終端操作的情況下,清晰掌握我底層的每一個工具調用步驟。您需要我開始執行下一個任務嗎?