Theme / v5.3.0

Oh My ClaudeCode

Claude Code 多代理編排系統

基礎觀念

客製化終端快速鍵與 HUD 狀態列配置

介紹 Oh My Claude Code (OMC) 的終端機 UX 優化技術,包含快速鍵綁定、動態狀態列配置與 tmux 分割視窗管理

為什麼需要終端機 UX 優化?

在與 CLI 原生 AI 助手協作時,開發者的大部分時間都是在終端機中度過。頻繁地手動輸入重複指令(如 /opsx:apply/opsx:verify)會帶來不必要的打字負擔。此外,如果背景代理在跑長任務,開發者需要一個「不刷屏」的固定 HUD 面板來監控進度。

Oh My Claude Code (OMC) 針對終端機體驗進行了深度的 UX (User Experience) 增強,引進了 Keybindings 快速鍵與動態狀態列。


核心機制一:Keybindings 快速鍵綁定

OMC 允許開發者在 .omcconfig.json 中配置自訂的快速鍵,將複雜的指令綁定到鍵盤組合上:

{
  "keybindings": [
    { "key": "ctrl+a", "command": "/opsx:apply", "desc": "實作下一個任務" },
    { "key": "ctrl+v", "command": "/opsx:verify", "desc": "執行驗證測試" },
    { "key": "ctrl+z", "command": "omc hud --enable", "desc": "檢視背景 Worker 狀態" }
  ]
}

快速鍵的工作原理:

OMC 在背景啟動了一個極輕量的鍵盤監聽器(Keypress Listener)。當你在終端機中按下 Ctrl + A 時,它會直接截獲該事件,並將對應的 /opsx:apply 模擬為標準輸入傳送給 Claude Code 進程,省去了手動打字的繁瑣,實現一鍵操作。


核心機制二:動態 HUD 與 tmux 狀態欄

當你在 tmux 模式下執行 omc team 時,OMC 會自動重置並管理你的 tmux status-line (狀態列)

 ┌────────────────────────────────────────────────────────┐
 │                                                        │
 │                                                        │
 │                 tmux 主代碼開發工作區                  │
 │                                                        │
 │                                                        │
 ├────────────────────────────────────────────────────────┤
 │ [Worker: billing] Loop 3/5 | [Spent: $1.45] | [CPU: 4%]│ ← HUD Status Line
 └────────────────────────────────────────────────────────┘
  • HUD 狀態列渲染:tmux 底部原本顯示時間和視窗號碼的狀態列,會被 OMC 動態接管。它會以綠、黃、紅三色展示當前正在跑自動化修復的 Sisyphus 代理進度與當前 Session 累計的 API 美元費用。
  • 不干擾工作區:狀態列的更新完全發生在終端機底部,絕不會往上刷屏,保持你的主開發視窗(Pane)100% 乾淨,讓你能在編寫代碼時毫無干擾地監看 AI 背景進度。