Theme / v0.21.4

Oh My Codex (OMX)

Codex CLI 工作流增強層

基礎觀念

Codex 任務佇列與 $ultragoal

掌握 Oh My Codex (OMX) 的高效任務排程、深度對話模式以及全自動的 Autopilot 任務佇列

什麼是 Oh My Codex (OMX)?

平台警告:OMX 的預設與主要支援平台為 macOS / Linux。Windows 屬於 secondary path,部分功能(例如 tmux 相關的 Team Mode、HUD 渲染)可能需要額外設定(如使用 psmux 作為 tmux 替代)。建議 Windows 使用者在 WSL2 環境中執行以獲得完整體驗。

Oh My Codex (OMX) 是一個專門為 OpenAI Codex CLI 設計的高階工作流增強與自動駕駛(Autopilot)套件

與普通的 AI 編碼助手不同,OMX 的核心思想是聲明式任務驅動:你不需要在終端機裡一步一步命令 AI「去改這個檔案,然後去跑這個測試,如果壞了再去修改」,而是可以直接給予一個高階的 $ultragoal (終極目標),OMX 會自動將其拆解為任務佇列 (Mission Queue),並進入自主駕駛狀態(Autopilot)直到目標達成。


核心機制一:$ultragoal 與任務拆解

v0.21.x 的 canonical planning chain 應理解為 $deep-interview → $ralplan → $ultragoal

  1. 深度訪談 ($deep-interview):先收斂真正需要人決策的技術分歧。
  2. 規劃審查 ($ralplan):Planner → Architect → Critic 交換 evidence,產生可審查計畫;這一步是 advisory,不自動取得 execution authority。
  3. 終極目標 ($ultragoal):把已收斂、已審查的目標轉成持久化完成工作。
  4. Mission / Runtime state:執行狀態保存在 .omx/,後續 Autopilot / Team 依任務需求推進。

核心機制二:Autopilot 自動駕駛與 HUD 監控

一旦任務清單確立,你可以直接執行:

omx --autopilot --madmax

這會使 OMX 進入 Autopilot 模式

 ┌──────────────────────┐
 │   $deep-interview     │
 └──────────┬───────────┘


 ┌──────────────────────┐
 │      $ralplan        │
 └──────────┬───────────┘


 ┌──────────────────────┐
 │      $ultragoal      │
 └──────────┬───────────┘


 ┌──────────────────────┐     編譯/測試      ┌──────────────────┐
 │   Autopilot 執行器   ├──────────────────▶│  Mission Runner  │
 └──────────────────────┘                   └────────┬─────────┘
                                                     │ 失敗 (自動修復)

                                            ┌──────────────────┐
                                            │        $plan      │
                                            └──────────────────┘
  • 自動駕駛 (Autopilot):OMX 會按順序自動取出任務佇列中的第一項,進行程式碼修改,隨後自動執行建置與驗證指令。
  • $plan(規劃與修正):如果某個步驟編譯或測試失敗,OMX 會啟動 $plan,讀取編譯器與測試的錯誤日誌、定位精確錯誤碼,進行最小範圍的自我修正,直到當前任務完全成功,才自動遞進到下一個任務。
  • HUD 儀表板:終端機頂部會渲染出動態 HUD 面板,實時更新當前的任務執行狀態、剩餘任務數、當前執行緒記憶體佔用以及當前會話累積的 token 費用,確保開發過程 100% 透明可控。

在下一章 [OMX Autopilot 自動測試實戰] 中,我們將展示如何下達一個「將覆蓋率提升至 80%」的 $ultragoal,看 OMX 如何全自動地在專案中撰寫單元測試並自我修復。