ntd4996/agentpet

AgentPet – 監控你的 AI 編碼代理的桌面夥伴

是什麼 – AgentPet 是一款免費開源的桌面應用程式（macOS、Windows、Linux），它駐留在選單列中，顯示你執行的 AI 編碼代理（Claude Code、Codex、Gemini、Cursor 等）的即時狀態。同時，螢幕上會浮現一個小型動畫「寵物」，隨著你消耗 Token 和完成會話而獲得經驗值，逐步進化。所有核心功能均可完全離線運作；若你使用 GitHub 登入，可選擇啟用 Web 同步、公開排行榜和跨裝置復原功能。

主要功能

• 多代理監控 – 選單列清單包含彩色狀態點、專案名稱、代理目前任務和即時計時器。當任一代理需要你輸入時，系統匣圖示會變為橙色並顯示計數。
• 桌面寵物（塔瑪戈奇風格） – 寵物「吃掉」代理消耗的 Token 和完成的會話，獲得經驗值，透過五個階段升級，並解鎖 14 項成就。右鍵點擊寵物可查看 HUD，顯示等級、飢餓度、7 日消耗圖表以及即時的 Claude/Codex 訂閱限制。
• 專案專屬寵物與使用量儀表板 – 可為某個資料夾指派一個寵物；儀表板按專案和代理分解 Token 使用量（日/月圖表）。最近 90 天的歷史記錄本地儲存。
• 可選線上個人資料 – 使用 GitHub 登入後，可發布你的寵物、出現在社群排行榜上，並在多台裝置間同步進度。除非你主動選擇，否則資料不會離開你的電腦。
• 可擴展的代理支援 – 預設配置了 11 個代理；任何命令列工具均可透過 agentpet run -- <command> 包裝使用。
• 自訂寵物套件 – 寵物遵循開放的 Codex pet-pack 格式（pet.json + 精靈圖）。使用者可透過網頁畫廊瀏覽、領養或提交自己的套件。

支援平台

• macOS 13+ – 原生 Swift/SwiftUI 應用，已簽署，透過 Sparkle 自動更新。
• Windows 10/11（64 位） – Tauri（Rust）建置，支援自動更新，使用者級安裝。
• Linux（64 位） – 使用相同的 Tauri 二進位檔，以 AppImage、.deb、.rpm 格式分發；AppImage 支援應用內自動更新。

安裝方式

• macOS: brew install --cask ntd4996/tap/agentpet 或從 GitHub 發布頁面下載簽署的 .dmg。
• Windows: 從網站或發佈頁面下載安裝程式或便攜式 zip。
• Linux: 下載 AppImage、DEB 或 RPM；或執行 curl … | sh 一行指令取得最新 AppImage。
• 從原始碼建置（macOS）需要 Xcode 16 / Swift 6；Windows 原始碼位於 windows/ 目錄（Tauri + Rust）。

運作原理

1. 在 設定 → 一般 中為每個 AI 編碼代理安裝鈎子。
2. 像平常一樣執行你的代理；AgentPet 透過 Unix 套接字守護程序接收事件。
3. 寵物在螢幕上作出反應，選單列圖示更新，XP/等級本地記錄。
4. （可選）使用 GitHub 登入以同步寵物、查看網頁個人資料，並在排行榜上競爭。

社群 – 支援越南語、簡體中文、繁體中文和日語翻譯；社群維護的移植版本（例如，Rust + GTK4 的 Linux 版本）。寵物由使用者貢獻，各自獨立授權；應用程式本身採用 MIT 許可證。

許可證 – 應用程式程式碼採用 MIT 許可證；寵物資產不在倉儲中，仍歸其創作者所有。