[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-83440":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":14,"compositeScore":18,"rankGlobal":10,"rankLanguage":10,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":22,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":34,"readmeContent":35,"aiSummary":10,"trendingCount":15,"starSnapshotCount":15,"syncStatus":36,"lastSyncTime":37,"discoverSource":38},83440,"agentpet","ntd4996\u002Fagentpet","ntd4996","A native macOS menu bar app with a desktop pet that monitors your AI coding agents (Claude Code, Codex, Gemini CLI) in real time.","https:\u002F\u002Fntd4996.github.io\u002Fagentpet\u002F",null,"Swift",193,35,100,0,9,94,92.1,"MIT License",false,"main",true,[24,25,26,27,28,29,30,31,32,33],"ai-agents","claude-code","codex","desktop-pet","developer-tools","macos","menubar","productivity","swift","swiftui","2026-06-12 04:01:41","\u003Cdiv align=\"center\">\n  \u003Cimg src=\"assets\u002Fbanner.png\" alt=\"AgentPet\" width=\"100%\" \u002F>\n  \u003Cp>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-macOS%2013%2B-black\" alt=\"macOS 13+\" \u002F>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-blue\" alt=\"MIT\" \u002F>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSwift-SwiftUI-orange\" alt=\"Swift\" \u002F>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fntd4996\u002Fagentpet\u002Factions\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fntd4996\u002Fagentpet\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg\" alt=\"CI\" \u002F>\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fntd4996\u002Fagentpet\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fntd4996\u002Fagentpet?style=social\" alt=\"GitHub stars\" \u002F>\u003C\u002Fa>\n  \u003C\u002Fp>\n  \u003Cp>\u003Cb>If AgentPet helps your workflow, please \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fntd4996\u002Fagentpet\">give it a star\u003C\u002Fa> — it really helps!\u003C\u002Fb>\u003C\u002Fp>\n  \u003Cp>\n    \u003Cb>English\u003C\u002Fb> ·\n    \u003Ca href=\"docs\u002Freadme\u002FREADME.vi.md\">Tiếng Việt\u003C\u002Fa> ·\n    \u003Ca href=\"docs\u002Freadme\u002FREADME.zh-Hans.md\">简体中文\u003C\u002Fa> ·\n    \u003Ca href=\"docs\u002Freadme\u002FREADME.ja.md\">日本語\u003C\u002Fa>\n  \u003C\u002Fp>\n\u003C\u002Fdiv>\n\nRun several coding agents at once (Claude Code, Codex, ...) and AgentPet tells you, at a glance, which one is **working**, which one is **done**, and which one is **waiting for your input**, so you stop tab-hunting across terminals. A little pet floats on your desktop and reacts to it all.\n\n## Why\n\nRunning multiple agents in parallel means constantly switching windows to check who needs you. AgentPet surfaces that in two places:\n\n- **Menu bar monitor** for the details: every running agent, its state, what it's doing, and a live timer.\n- **Desktop pet** for an ambient signal you can read without breaking focus.\n\n## Features\n\n- **Multi-agent monitor** in the menu bar: live list of every agent with a colored status dot, the project, what it's doing (running tool \u002F waiting reason), and a per-state timer that counts in real time.\n- **At-a-glance menu bar icon**: shows the number of running agents, and turns **orange with a count** when one needs your input.\n- **Desktop pet** that reacts to the aggregate state (working \u002F waiting \u002F done \u002F celebrate), with an optional **chat bubble** (built-in or fully custom messages).\n- **Native notifications** when an agent finishes or needs input.\n- **Claude Code, Codex, Gemini CLI, Cursor, opencode, Windsurf & Antigravity** integration via hooks, with one-tap install from Settings (precise working \u002F waiting \u002F done \u002F idle, including \"needs your input\"). GLM (Z.AI) works through Claude Code automatically. Cursor, Windsurf and Antigravity report working\u002Fdone (they have no \"needs input\" hook).\n- **Universal wrapper** `agentpet run -- \u003Ccommand>` to monitor *any* CLI agent (working\u002Fdone), no per-agent setup.\n- **Pet system**: browse an online pet library and download with one click, map each animation to a state, resize, and customise chat lines.\n- **Polished, native Settings** (tabbed, dark) that never steals focus.\n\n## Screenshots\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\"assets\u002Fscreenshot-menubar.png\" width=\"360\" alt=\"Menu bar monitor\" \u002F>\n  \u003Cimg src=\"assets\u002Fscreenshot-settings.png\" width=\"360\" alt=\"Settings\" \u002F>\n  \u003Cimg src=\"assets\u002Fscreenshot-pet.png\" width=\"360\" alt=\"Pet\" \u002F>\n  \u003Cimg src=\"assets\u002Fscreenshot-notification.png\" width=\"360\" alt=\"Notification\" \u002F>\n  \u003Cbr\u002F>\n  \u003Cimg src=\"assets\u002Fdemo.gif\" width=\"600\" alt=\"Pet reacting to agent activity\" \u002F>\n\u003C\u002Fdiv>\n\n## Requirements\n\n- **macOS 13 Ventura or later** (macOS 14 Sonoma+ recommended; the keyboard-focus-ring cleanup uses APIs available on macOS 14+).\n- **Apple Silicon (M1\u002FM2\u002FM3\u002FM4) and Intel Macs** are both supported.\n- macOS only, by design. There is no Windows or Linux version.\n- To build from source: Xcode 16 \u002F Swift 6.\n\n## Install\n\n### Homebrew\n\n```bash\nbrew install --cask ntd4996\u002Ftap\u002Fagentpet\n```\n\n### Direct download\n\nGrab the latest `AgentPet.dmg` from [Releases](https:\u002F\u002Fgithub.com\u002Fntd4996\u002Fagentpet\u002Freleases), open it, and drag AgentPet to Applications.\n\n### Build from source\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fntd4996\u002Fagentpet.git\ncd agentpet\n.\u002Fscripts\u002Fbuild-app.sh release\nopen build\u002FAgentPet.app\n```\n\nBuilds are Developer ID-signed and notarized by Apple, so they open without a Gatekeeper warning. AgentPet also updates itself: it checks for new versions automatically, and you can update in-app from the menu bar **Updates** button.\n\nOn first launch, open **Settings → General** and click **Install** next to Claude Code, then **Enable** notifications.\n\n### Uninstall\n\n1. In **Settings → General**, click **Remove** next to each agent you connected (this strips AgentPet's hooks from the agents' config so they don't error after the app is gone).\n2. Remove the app and its data:\n\n```bash\nbrew uninstall --cask agentpet          # or drag \u002FApplications\u002FAgentPet.app to Trash\nrm -rf ~\u002F.agentpet                       # downloaded pets + state\nrm -f  ~\u002FLibrary\u002FPreferences\u002Fcom.agentpet.app.plist\n```\n\n## Usage\n\n**Claude Code** (recommended): install the hook from Settings. AgentPet then reflects each session's real state (including \"waiting for input\").\n\n**Any other CLI agent**: wrap it.\n\n```bash\nagentpet run -- \u003Cyour-agent-command>     # e.g. agentpet run -- aider\n```\n\nThe session shows as *working* while it runs and *done* when it exits.\n\n## Pets\n\nPets use the open Codex pet-pack format (`pet.json` + an 8×9 spritesheet). You can:\n\n- **Browse** the online library and download a pet with one click (Settings → Pet → Browse pets).\n- **Map animations**: pick which sheet animation plays for each state.\n- **Delete** pets you no longer want.\n\nA starter pet is installed automatically on first launch. AgentPet bundles no pet art; packs are added at runtime.\n\n## Roadmap\n\n- Notarized DMG + Homebrew cask\n- Click an agent to reveal its terminal\n- Per-project pets\n\n## Tech\n\nSwift + SwiftUI, a Unix-socket daemon for agent events, and a tiny CLI helper, all in one SwiftPM package. See [`docs\u002Fspecs`](docs\u002Fspecs) for the design.\n\n## Support\n\nIf AgentPet saves you some tab-hunting, here's how to help:\n\n- ⭐ **[Star the repo](https:\u002F\u002Fgithub.com\u002Fntd4996\u002Fagentpet)** so more people find it.\n- ☕ **[Buy me a coffee](https:\u002F\u002Fbuymeacoffee.com\u002Fntd4996)** if you'd like to fuel more features.\n\nBuilt by **[Nguyễn Thành Đạt (@ntd4996)](https:\u002F\u002Fgithub.com\u002Fntd4996)**.\n\n## Acknowledgements\n\nThe Codex pet-pack format and the online pet library are provided by\n**[Petdex](https:\u002F\u002Fgithub.com\u002Fcrafter-station\u002Fpetdex)** (MIT). AgentPet is an\nindependent, interop client: it reads packs in Petdex's format and lets you\ndownload them from Petdex's public API. AgentPet bundles no pet art; every pet\nasset is owned by its respective submitter under their own license. If you hold\nrights to a character, please direct takedowns to Petdex.\n\n## License\n\nMIT, see [LICENSE](LICENSE). Application code only; pet assets are not part of this repository.\n",2,"2026-06-11 04:11:09","CREATED_QUERY"]