Agent Monitor · Agent 進度

A floating macOS panel that shows every Claude Code and Codex session at a glance.
一個常駐桌面的 macOS 浮窗，同時盯住所有 Claude Code 和 Codex 的進度。

繁體中文 · English

Screenshots use demo data. 示意圖為示範資料。

---

繁體中文

同時開好幾個 Claude Code 對話串和 Codex 任務時，很難知道誰在跑、誰在等你、誰已經做完。Agent 進度把它們放進同一個浮窗：

• 同一個視窗看全部：Claude Code 和 Codex 的 session 各佔一列，顯示標題、狀態、進度條和經過時間
• 四種狀態：工作中／等你／完成／閒置，「等你」排最前面
• 估算進度：讀 agent 自己列的計畫（Claude Code 的任務清單、Codex 的 update_plan），顯示「步驟 3/5 · 約 50%」；沒列計畫就只顯示轉圈，不亂給百分比；只有收到完成訊號才顯示 100%
• 點一下跳過去：點任一列直接跳到那個 Claude Code 對話串或 Codex 對話
• 完成／等你提示：系統通知加提示音，點通知也會跳轉；Claude Code 完成的聲音可單獨關掉
• 額度追蹤：最下方顯示兩邊 5 小時與每週額度還剩多少、多久後重置（官方只公布百分比）
• Liquid Glass 浮窗：永遠在最上層、可拖曳、可縮成精簡模式；五段透明度，最淡跟 Dock 一樣清透
• 中英雙語，開機自動啟動，全部可在選單列開關

需求

• macOS 14 以上（Liquid Glass 需要 macOS 26 以上，舊版自動改用模糊效果）
• Claude Code 桌面版（點擊跳轉用的是桌面版連結）；Codex 為選用，支援 Codex 桌面版

安裝

**1. 浮窗 app**

從 [Releases](../../releases) 下載 `AgentMonitor.zip`，解壓後把 `AgentMonitor.app` 拖進「應用程式」。 這個 app 沒有經過 Apple 公證，第一次開啟請在 app 上按右鍵 › 打開，或在終端機執行：

xattr -dr com.apple.quarantine /Applications/AgentMonitor.app

也可以自己從原始碼建置（只需要 Xcode Command Line Tools）：

./scripts/install.sh

**2. Claude Code mod（Claude Code 那一側需要）**

Claude Code 的進度由一個 mod 寫出，在 Claude Code 裡執行：

/plugin marketplace add chunweimacwm/agent-progress-monitor
/plugin install agent-progress@agent-progress-monitor

裝好後新開的對話串就會被追蹤，側邊也會出現同樣內容的「Agent 進度」pane（`/progress` 可重開）。pane 語言可在 mod 設定改成 `en`。

**3. 讓 agent 列計畫（建議）**

進度條來自 agent 自己列的計畫。在你的 `CLAUDE.md`／`AGENTS.md