什麼是 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:
- 深度訪談 ($deep-interview):先收斂真正需要人決策的技術分歧。
- 規劃審查 ($ralplan):Planner → Architect → Critic 交換 evidence,產生可審查計畫;這一步是 advisory,不自動取得 execution authority。
- 終極目標 ($ultragoal):把已收斂、已審查的目標轉成持久化完成工作。
- 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 如何全自動地在專案中撰寫單元測試並自我修復。