hathcox/claudomon/tree/main/plugin
claudomon
一个 Claude Code plugin,会绘制一只从项目 git remote 孵化的终端像素宠物,并对 Claude 的操作和你的输入做出反应。
关于这个 mod
Claudomon 是一个由 TypeScript function hooks 实现的 Claude Code mod,以 plugin 形式提供。每个项目都会孵化自己的像素宠物;它的形状、颜色、耳朵和纹样由项目的 git remote 作为种子生成,因此同一仓库的队友会得到相匹配的宠物。宠物以覆盖层形式出现在对话右上角,可以拖动和停靠。它会为 Claude 的活动制作动画(读取文件时看书,搜索时跑跑步机,删除代码时吃饼干,写代码时拉便便,思考时显示问号),你按键时它会跟着打字并显示 WPM;将鼠标悬停、点击可让它飞过屏幕,右键则打开带有统计数据、XP以及命名、打盹、隐藏按钮的卡片。提示、编辑和按键都会给它增加 XP;一个项目的所有 session 共用一只宠物。通过 /plugin marketplace add hathcox/claudomon 和 /plugin install claudomon@claudomon 安装,再用 /claudomon 命令查看统计、命名和隐藏。它为全屏终端布局构建,可在 Apple Terminal、iTerm2、Ghostty、kitty 和 WezTerm 中运行。采用 MIT License。
安装
请先查看作者 README 确认 marketplace 和插件名称;命令可能随仓库结构改变。
claude plugin marketplace add hathcox/claudomon claude plugin install claudomon
原文 / README
Claudomon
A pixel pet that lives on your Claude Code screen. Every project hatches its own mon: the project's git remote seeds its shape, colours, ears and markings, so your teammates' pets for the same repo match yours, and every other project gets someone new.
It is a Claude Code mod: a plugin of TypeScript function hooks.
What it does
- Lives on top of your conversation. It sits in the top-right corner, where there is the least to read, drawn as a layer over the text without moving it. Drag it anywhere; drop it high to dock at the top, low to dock at the bottom.
- Acts out what Claude is doing. Reading files: it reads a book. Searching: it runs on a treadmill. Deleting code: it munches a cookie. Writing code: it poops. Thinking: a question mark.
- Types along with you. Every key you press in the prompt brings a paw down on a little keyboard, at your own speed, with your words per minute overhead.
- Plays. Hover for its name, click to launch it across the screen, right-click for its card: stats, XP, and buttons to name it, nap or hide.
- Grows. Prompts, edits and keystrokes feed it XP. One pet per project, shared by every Claude Code session you run there.
Install
/plugin marketplace add hathcox/claudomon
/plugin install claudomon@claudomon
Commands: /claudomon for stats, /claudomon name <name>, /claudomon hide.
Built and tuned for the fullscreen terminal layout (Claude Code's default). It works in Apple Terminal, iTerm2, Ghostty, kitty and WezTerm.
Developing
tools/check.sh # type-check, validate, unit tests (seconds)
tools/check.sh --scenarios # plus real Claude Code sessions with on-screen assertions
plugin/is the mod. Pure logic (genome,paint,stroll,footing,menu,activity) is kept apart from the hooks inregister.tsxso it can be unit-tested.tests/unit/arenode:testsuites run withtsx.tests/scenarios/drive a real session at 80×24 throughtools/termcap, a pseudo-terminal recorder that renders the screen to PNG, sends mouse and keys, and asserts what is on screen.tools/render/renders sprites and animations offline;tools/tapp/captures a real Apple Terminal window.
License
MIT


