A macOS desktop companion that reacts to your AI coding agents in real time — idle, thinking, coding, testing, even dying when you neglect it. The pet floats on your desktop while you work, with one independent window per active AI platform.
⬇ Download for macOS · Browse pets · codogotchi.app
- Download Codogotchi.dmg, open it, and drag Codogotchi to your Applications folder.
- Clear the macOS quarantine flag (one-time — the build isn't notarized yet):
xattr -cr /Applications/Codogotchi.app
- Launch it. On first run, approve the Welcome to Codogotchi sheet to turn on agent animations.
That's it. No Terminal setup, no global installs — everything Codogotchi needs is inside the app.
Using Cursor, VS Code, or another editor? After enabling hooks, restart your editor once so it picks them up.
Your AI agents fire lifecycle events as they work. Codogotchi listens and animates the matching mood — coding, reading, testing, waiting, erroring, and more. Stay active and your pet thrives; neglect it and its hearts drain. It's a Tamagotchi for your coding sessions.
With v2.0.0, each active AI platform gets its own independent floating pet window. If you have Claude Code and Cursor running simultaneously, you see two separate pets — one reacting to each agent in real time. Open Settings → Customization to collapse platforms into a single combined window, turn a platform off, or adjust how long idle windows linger before auto-dismissing.
Works with: Claude Code · Codex · Cursor · GitHub Copilot (VS Code) · Google Antigravity
Turn hooks on or off for any editor anytime in Settings → General → Install / Update hooks.
Codogotchi ships with Maew, a cute-flirty buddy animated across every agent state. Want something else? Four ways to get one:
| How | |
|---|---|
| 🐾 Meet Maew | The default pet — already in the app. |
| ✨ Hatch your own | Describe a character or drop a seed image and let AI draw a full animated pet. → codogotchi.app/hatch |
| 👥 Adopt a community pet | Browse pets made by other developers and install them in a click. → codogotchi.app/gallery |
| 🎨 Draw your own | Hand-draw a spritesheet using the reference spec. → codogotchi.app/docs/spritesheet |
Switch between installed pets anytime in Settings → Pet. To publish a pet you made for others to adopt, sign in at codogotchi.app/upload.
Codogotchi includes a free, fully local RPG layer — hearts, levels 1–100, and an XP ring that fills as you code. It runs entirely on your machine; nothing is uploaded. Prefer just the animations? Hide the heart HUD in Settings → RPG.
Do I need to install anything besides the app? No. The app is self-contained — drag, drop, approve the welcome sheet.
Where are my pets stored?
In ~/.codogotchi/pets/. Use the menu bar's Reveal pet folder item to open it in Finder.
My pet isn't animating. Make sure hooks are installed (Settings → General) and, if you use Cursor or VS Code, that you restarted the editor afterward.
Is my activity sent anywhere? No. The hearts/levels layer is local-only by default. Cloud sync and leaderboards are opt-in and not required to use Codogotchi.
Why the xattr command?
The app isn't notarized by Apple yet, so macOS quarantines the download. xattr -cr clears that flag — the same as right-click → Open. It'll go away once the app is notarized.
- 🌐 Website — codogotchi.app
- 🖼 Pet gallery — codogotchi.app/gallery
- ✨ Hatch a pet — codogotchi.app/hatch
- 📖 Spritesheet reference — codogotchi.app/docs/spritesheet
- 🔒 Privacy · Terms
- ✉️ Support & takedowns — admin@codogotchi.app
Codogotchi is open source. New to the codebase? START-HERE.md gives you the mental model in five minutes. For a deeper walkthrough — data flow, polling loop, renderers, and Swift/AppKit patterns explained for TS devs — check the Codogotchi for Dummies guide. To build from source or work on the macOS app, see CONTRIBUTING.md. We expect everyone to follow the Code of Conduct.
PolyForm Noncommercial 1.0.0 — free for personal and noncommercial use.