ntd4996/agentpet
ntd4996/agentpet has 405 GitHub stars and 72 forks. GitHot measured +2 stars in 24 hours and +7 in 7 days. Last checked 2026-11-10 02:28 UTC. Last push 2026-11-03.
A desktop pet for macOS & Windows that monitors your AI coding agents (Claude Code, Codex, Cursor, Gemini...) in real time, and grows as you code, feed it tokens, level it up, climb the leaderboard.
可以做什么
- 🐾 Ambient desktop pet that mirrors your agents' state without breaking your focus.
- 📊 Menu-bar monitor with every agent, its project, what it's doing, and a live timer.
- 🎮 Raise your pet: real tokens and finished sessions feed it, level it up, and unlock 14 achievements.
- 🗂️ Per-project pets and a per-project token usage dashboard (daily and monthly).
实测星标增长
- 24小时
- +2
- 7天
- +7
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化，周期相互重叠，并非每日新增。缺失的测量保持空白。星标代表关注度，不代表软件质量。
docs/readme/README.zh-Hans.md
原文
同时运行多个编程智能体（Claude Code、Codex 等），AgentPet 让你一眼看清哪个正在运行、哪个已完成、哪个正在等待你的输入，不必再在多个终端之间来回切换。一只小宠物会漂浮在桌面上，对这一切作出反应。
为什么需要它
并行运行多个智能体意味着要不停切换窗口去看谁需要你。AgentPet 把这些信息呈现在两个地方：
- 菜单栏监视器展示细节：每个运行中的智能体、其状态、正在做什么，以及实时计时。
- 桌面宠物提供一种轻量的提示，让你无需打断工作就能感知。
功能
- 多智能体监视器（菜单栏）：实时列出每个智能体，带状态色点、项目名、正在做什么（运行的工具 / 等待原因），以及按状态实时计时。
- 一眼可读的菜单栏图标：显示运行中的智能体数量，当有智能体需要你输入时变为橙色并带数字。
- 桌面宠物根据聚合状态作出反应（working / waiting / done / celebrate），并可选显示聊天气泡（内置或完全自定义的消息）。
- 当智能体完成或需要输入时发出系统通知。
- 通过 hook 集成 Claude Code、Codex 与 Gemini CLI，可在设置中一键安装（精确识别 working / waiting / done / idle，包括“需要你输入”）。
- 通用包装器
agentpet run -- <命令>，可监视任意 CLI 智能体（working/done），无需逐一配置。 - 宠物系统：浏览在线宠物库并一键下载，为每个状态映射动画，调整大小，并自定义聊天内容。
- 精致的原生设置（分页、深色），且永不抢占焦点。
截图
右键点击宠物查看游戏风格的 HUD , 等级、经验、饥饿度、近 7 天消耗图，以及实时的 Claude/Codex 额度。
 菜单栏监视器 , 一眼看清每个智能体 |
 养成标签页 , 用真实工作养大你的宠物 |
 原生分页式设置 |
 桌面宠物 |
系统要求
- macOS 13 Ventura 或更高版本（推荐 macOS 14 Sonoma 及以上；关闭键盘焦点环使用了 macOS 14+ 的 API）。
- 同时支持 Apple Silicon（M1/M2/M3/M4）与 Intel Mac。
- 支持 macOS 13+（Apple Silicon 和 Intel）以及 Windows 10/11（64 位）。Windows 版本位于
windows/目录（Tauri + Rust）。 - 从源码构建需要：Xcode 16 / Swift 6。
安装
Homebrew
brew install --cask ntd4996/tap/agentpet
直接下载
从 Releases 下载最新的 AgentPet.dmg，打开后将 AgentPet 拖入 Applications。
从源码构建
git clone https://github.com/ntd4996/agentpet.git
cd agentpet
./scripts/build-app.sh release
open build/AgentPet.app
注意： 当前版本已用 Developer ID 签名但尚未公证，因此 macOS 首次启动可能会拦截。执行一次以移除隔离标记：
xattr -dr com.apple.quarantine "/Applications/AgentPet.app"完整公证版（无警告）即将推出。
首次启动后，打开 Settings → General，点击 Claude Code 旁边的 Install，然后 Enable 通知。
使用
Claude Code（推荐）：在设置中安装 hook。AgentPet 会反映每个会话的真实状态（包括“等待输入”）。
其他 CLI 智能体：用包装器运行。
agentpet run -- <你的智能体命令> # 例如：agentpet run -- aider
会话运行时显示 working，退出时显示 done。
宠物
宠物使用开放的 Codex 宠物包格式（pet.json + 8×9 精灵图）。你可以：
- 浏览在线宠物库并一键下载（Settings → Pet → Browse pets）。
- 映射动画：为每个状态选择播放哪段动画。
- 删除不再需要的宠物。
首次启动会自动安装一个初始宠物。AgentPet 不内置任何宠物美术资源；宠物在运行时添加。
路线图
- 公证 DMG + Homebrew cask
- 点击智能体以打开其终端
- 按项目区分宠物
技术
Swift + SwiftUI，一个用于智能体事件的 Unix-socket 守护进程，以及一个小型 CLI helper，全部在一个 SwiftPM 包中。设计见 docs/specs。
支持
如果 AgentPet 帮你少切了几次终端，可以这样支持：
由 Nguyễn Thành Đạt (@ntd4996) 开发。
致谢
Codex 宠物包格式与在线宠物库由 Petdex（MIT）提供。AgentPet 是一个独立的互操作客户端：读取 Petdex 格式的宠物包，并允许从 Petdex 的公开 API 下载。AgentPet 不内置宠物美术资源；每个宠物资源由其提交者按其自有许可拥有。若你拥有某角色的权利，请向 Petdex 提交下架请求。
许可证
MIT，见 LICENSE。仅适用于应用代码；宠物资源不属于本仓库。