Gumarn Pet — Development skill for Claude Code

gumarn-pet

A Ragnarok Online **Deviruchi** that floats over your desktop and shows what your coding agent is doing — built because macOS notifications get swallowed by Do Not Disturb.

One pet aggregates **every** session you have open — **Claude Code and CodeBuddy Code together**, CLI or desktop. If any of them is waiting on you it "opens a chat room" — the RO signboard — shouts `/!` and rings the game's own chat-room ding. Otherwise it paces while working, and curls up to sleep when everything is quiet.

waiting on you	working	asleep
the sign names the session — what you set with /rename, else the directory — and 1/3 is your position in the queue	the bubble says what the agent is doing right now; the label warns that the week is burning fast	nothing has happened in five minutes

Drag it anywhere. Click it to jump to the terminal that needs you — with several waiting, each click walks to the next one and the sign follows.

**macOS only.** No dependencies beyond what a Mac running one of those agents already has: `swiftc` (Xcode command line tools), `python3`, and `jq` for the statusline mirror.

---

Install

git clone https://github.com/thanathe/gumarn-pet.git ~/dev/gumarn-pet
cd ~/dev/gumarn-pet
python3 scripts/install.py

That is the whole install. It writes nine hooks into `~/.claude/settings.json` and nine into `~/.codebuddy/settings.json` — backing each file up first, and never touching hooks that are not its own — then builds the app, starts it, and tells you what you should be seeing. Whichever of the two agents you do not have is skipped; `--only claude` or `--only codebuddy` picks one on purpose. Run it again after moving the checkout and it repairs the paths; `--dry-run` shows what it would do without doing it.

**Hooks only apply t