ntd4996/agentpet

AgentPet – 监控你的 AI 编码代理的桌面伴侣

是什么 – AgentPet 是一款免费开源的桌面应用程序（macOS、Windows、Linux），它驻留在菜单栏中，显示你运行的 AI 编码代理（Claude Code、Codex、Gemini、Cursor 等）的实时状态。同时，屏幕上会浮现出一个小型动画“宠物”，随着你消耗令牌和完成会话而获得经验值，逐步进化。所有核心功能均可完全离线运行；若你使用 GitHub 登录，可选择启用 Web 同步、公开排行榜和跨设备恢复功能。

主要功能

• 多代理监控 – 菜单栏列表包含彩色状态点、项目名称、代理当前任务和实时计时器。当任意代理需要你输入时，托盘图标会变为橙色并显示计数。
• 桌面宠物（塔玛戈奇风格） – 宠物“吃掉”代理消耗的令牌和完成的会话，获得经验值，通过五个阶段升级，并解锁 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 许可证；宠物资产不在仓库中，仍归其创作者所有。