Install commands (click to expand)
# 🍎 macOS — drag .dmg to /Applications, then clear quarantine on first launch:
xattr -cr /Applications/petpet.app
# 🪟 Windows — double-click the .msi (or _x64-setup.exe for the NSIS variant)
# 🐧 Debian / Ubuntu
sudo dpkg -i petpet_*_amd64.deb
# 🐧 Fedora / RHEL
sudo rpm -i petpet-*-1.x86_64.rpm
# 🐧 Portable (any distro, no install)
chmod +x petpet_*_amd64.AppImage && ./petpet_*_amd64.AppImagepetpet is a desktop companion that quietly listens to Claude Code / Codex / OpenCode / Aider — and more providers landing soon — then turns your real AI usage into the pet's growth. Code seriously, your pet thrives. Idle, it sleeps.
Hover the pet to peek at name · level · XP bar · upcoming stage
- 🔒 Zero-risk, fully local. No cloud, no telemetry, no account, no data ever leaves your machine. Open source, MIT-licensed, fully auditable.
- 🪶 Zero-setup. No hook configuration. petpet auto-discovers existing session logs on launch.
- 🤖 Multi-agent. One pet eats events from every supported AI coding tool; XP accumulates in a single pool.
- 🗂️ Multi-pet. Raise a fleet — switch the active companion any time; the rest hold their state.
| Template | Difficulty | Default name | Hatch (Opus 4.7) | L99 (heavy use) | |
|---|---|---|---|---|---|
 |
Unicorn | 🟢 Easy | Sparkle | ~5–10 conv | ~30 days |
 |
Sun (Wukong) | 🟡 Medium | Wukong | ~15–20 conv | ~60 days |
 |
KingKong | 🔴 Hard | KingKong | ~30+ conv | ~150 days |
Hard mode philosophy — KingKong won't budge for idle chat. Only deliberate work counts: AI token usage, completed tasks, dispatched subagents. Want a titan? Earn it.
Every pet has 10 evolution stages — egg → newborn → six juvenile / adult forms → final apex form. XP accrues from real-world events; level thresholds gate visual transformations.
The XP pipeline
Token usage ┐
Activity ─┼──→ Algorithm ──→ Rule multiplier ──→ XP
Manual grants┘ (invariant) (per-template)
Algorithm core (src/xp/algorithm.rs, version-pinned, cross-install identical):
weighted = input·1 + output·5 + reasoning·5 + cache_create·1.25 + cache_read·0.1
raw = weighted / 60,000 × tier_mult × confidence × growth_curve(level)
xp = round(raw).clamp(0, tier_cap)
Tier multipliers — capability bands stay stable across vendor price changes:
| Tier | Examples | Mult | Per-event cap |
|---|---|---|---|
| 🌌 Frontier | Opus 4.7, GPT-5, o1+ | 1.5× | 10 XP |
| 🌙 Mid | Sonnet, GPT-4o, Gemini 2.5 | 1.0× | 6 XP |
| 🐰 Mini | Haiku, GPT-4o-mini, nano | 0.7× | 3 XP |
Growth curve — 1 / (1 + 0.02 · level). High levels naturally diminish: at L25 you earn 67% per event, at L50 only 50%. No way to whale-rush to L99 in a weekend.
Per-template personality — rule multipliers [0.5, 2.0] let each template flavor its preferences. Unicorn rewards every chat (chat-friendly), Sun halves it (medium pacing), KingKong zeros it out (token-only diet).
Switch any time. The active pet absorbs live events; the rest preserve their state forever. Run a parallel breeding program if you like.
Roll your own pet. The built-in Template Creator gets you from blank to playable in under 3 minutes:
- Pick a levels preset —
short/medium/longXP curve - Pick a stages preset —
simple(5 stages) /balanced(7) /extended(10) - Fill in:
- Name, description, flavor text
- 10 sprite PNGs (drag-and-drop)
- Per-rule XP weights and per-model boosts
- Theme color + label chips
Templates live at ~/.petpet/templates/<id>/ — pure JSON + PNGs. Hand-edit, git-version, share with friends. No proprietary format anywhere.
Click your pet → opens the Trainer Card: a per-pet (or "All") usage dashboard tracking your spend, XP gains, model breakdown, and every recent move.
- 💰 Feeding Bill — today / this week / this month / lifetime USD + token totals
- 📈 Per-provider breakdown — Claude vs Codex vs OpenCode vs Aider, tokens + XP earned each
- 📜 Recent moves — every XP gain logged with timestamp, pet, amount, and source (
usage/activity/manual) - 🏆 All vs single-pet toggle —
Allaggregates every pet you've ever raised (including pre-install historical sessions, display-only)
On launch, petpet performs async historical import of past session logs — your dashboard isn't empty on Day 1.
Pack any pet (snapshot + XP history + custom name) or any template into a .petpet archive. Toss it on USB / Discord / GitHub releases. The recipient imports, schema is validated end-to-end:
✓ Manifest schema version ✓ Sprite completeness (10 × PNG)
✓ XP curve monotonicity ✓ Rule shape (no unknown source_type)
✓ SHA-256 checksums ✓ No path traversal in archive
Invalid archives are rejected, never silently importing broken state.
# Prerequisites: Rust toolchain, Node 22+, pnpm
git clone https://github.com/ppXD/petpet.git
cd petpet/desktop
pnpm install
pnpm tauri dev # hot-reload dev build
# Release bundles → desktop/src-tauri/target/release/bundle/
pnpm tauri buildMIT — see LICENSE. Fork it, modify it, ship it commercially. Pet sprites and engine code all under the same hat.
Made with 🍓 by humans who use AI too much.