把 MacBook 瀏海變成系統與 AI 用量儀表板：VoidNotch 開源

如果你和我一樣，白天同時開著 Claude、Codex、Copilot 或 Grok，MacBook 上方那條瀏海多半只是一塊黑。因為看著它整天空著實在有點浪費，我寫了一個小工具，把它變成常駐、可展開的儀表板，一邊看機器狀態，一邊看各家 AI 額度還剩多少。

專案已用 MIT 開源，clone 下來自己 build 就能用：
https://github.com/cyhsieh817/VoidNotch

---

它想解決的兩種分心

研究或寫 code 時，我常被兩件事打斷：

1. 機器突然卡住：是 CPU 打滿、磁碟快滿，還是記憶體在換頁？為了搞清楚，還得另開 Activity Monitor。
2. AI 配額摸黑：Claude、Codex、Agy 各自有時間窗口，所以常常用到一半才發現要等 reset。

VoidNotch 把這兩件事塞回瀏海附近：收合時是一排精簡數字，點一下就展開成完整面板。因為靠選單列常駐，所以它不佔 Dock。

---

現在能做什麼

系統監控

• CPU、記憶體、磁碟用量與讀寫、網路上下行
• 電池（筆電）、健康分數、佔用較高的行程
• 溫度／GPU util 採 best-effort（讀不到顯示 -，不會假裝是 0%）
• 設定裡可勾選要顯示哪些指標

AI 用量

• 透過 CodexBarCore 讀本機 CLI／session 資料
• 已接線的包括 Claude、Codex、Copilot、Gemini (Agy)、Grok 等
• 尚不支援的 provider 會標成 unsupported，不會誤顯示成 0%

介面

• Compact：左右側可選放系統或 AI 摘要，寬高可調
• Expanded：分頁看系統／模型配額／Agent 活動
• 語言：繁中與英文
• 左鍵展開、右鍵開設定

因為資料都在本機讀，所以沒有 VoidNotch 帳號，也不會把用量上傳到我們的伺服器。收合時先掃一眼數字，有疑慮再展開分頁細看，就不必為了查額度或 CPU 再跳開編輯器。

---

怎麼安裝

需要 macOS 14+，以及完整 Xcode（不是只裝 Command Line Tools，因為 DynamicNotchKit 用到 SwiftUI 巨集）。clone 後用同一支腳本 build 與掛到「應用程式」即可：

git clone https://github.com/cyhsieh817/VoidNotch.git
cd VoidNotch
./scripts/make_app.sh --run
./scripts/make_app.sh --install

第一次整理 token 顯示時，請先確認各家 CLI 已登入（例如 claude、codex、grok login），再在選單列按重新整理。若要自己改程式，本機驗證大致就這幾條：

swift test
swift run vn-selftest
swift run vn-probe 5

---

和 Lab Grimoire 的關係

Lab Grimoire 站上多是瀏覽器裡就能跑的統計與實驗工具。
VoidNotch 則是另一條線，因為它是給整天開 AI coding agent 的人用的 macOS 本機 HUD。

兩者都走開源、本機優先。所以這次把 VoidNotch 放上 GitHub，是希望需要的人可以直接 clone、改、自己 build。Issue 與 PR 都歡迎。

---

小結

• MIT 開源，自己 build 即可用
• 瀏海／選單列：系統狀態 + AI 配額
• 可調指標、兩側內容與尺寸
• 授權與第三方聲明見 repo 的 LICENSE、THIRD-PARTY-NOTICES.md

若你也在 Mac 上同時趕實驗、論文與 agent，歡迎試試看；因為是開源專案，用得不順就直接開 issue。它不是要取代 Activity Monitor，而是把最常偷看的那幾格數字，放回你本來就會抬頭的那條瀏海。

---

Repo：github.com/cyhsieh817/VoidNotch