KJLavender

Acp Pet — Development skill for Claude Code

Development community

A desktop pet that acts out what your ACP coding agent is doing, live.

How to install Acp Pet

This entry records only its repository, not the path inside it, so there is no exact command to give. Open KJLavender/acp-pet and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Acp Pet does

A desktop pet that acts out what your ACP coding agent is doing, live. 會演出 coding agent 在幹嘛的桌寵。

Alternatives in Development

  • Claude View — 10 Claude sessions running 104 ★
  • Notch Pilot — A live companion for Claude Code that lives in your MacBook notch 67 ★
  • Sim Plugin Comsol — Use Codex and Claude Code with COMSOL via sim-cli: .mph inspection, live Desktop sessions, bounded execution 65 ★

README

🐣 acp-pet: a desktop pet that acts out your coding agent

**English** | [繁體中文](README.zh-TW.md)

A pixel pet that lives on your desktop and is secretly a dashboard for an [ACP](https://agentclientprotocol.com) coding agent (Claude Code, Codex, Gemini…). It doesn't chat and it doesn't guess from logs: it consumes the agent's real `session/update` event stream and acts out each event as it happens. Out of the box the pets are Hikari and Nozomi from *Blue Archive* ([below](#meet-hikari--nozomi)); there's also a code-drawn chick, and any Codex pet pack works.

Hikari Nozomi Chick
Hikari Nozomi poses
What the agent is doing What the chick does
Thinking / writing a plan 💡 a light bulb above its head, pacing
tool_call read / search 📖 reading a book
tool_call edit / delete / move ⌨️ typing furiously
tool_call execute 🔨 hammering on an anvil
tool_call fetch 🔭 looking through a telescope
request_permission 🪧 runs over holding a sign: Allow / Deny (auto-denied after 60 s)
Turn succeeded 💛 jumping with hearts (✨ levels up when it has enough XP)
Turn failed 🤒 turns grey under a rain cloud
Permission denied / cancelled 😤 turns its back on you
Idle too long 💤 bored, then falls asleep

On top of that there's a small tamagotchi layer. **Energy** drains with every tool call and refills while it sleeps. **Boredom** rises while it's idle, and once it's high enough the chick comes over to ask for a task. Every finished task earns **XP**, and a **streak** of successes adds a bonus. The built-in chick grows a comb at Lv.3 and a crown at Lv.5. Everything is saved to `~/.acp-pet/`.

![features](docs/features.png)

Meet Hikari & Nozomi

The two default pets are the Tachibana twins from *Blue Archive*: **Hikari** (calm, deadpan, salutes at the cap) and **Nozomi** (side ponytail, fang g