hathcox/claudomon/tree/main/plugin
claudomon
一個 Claude Code 外掛,會從專案的 git remote 孵化終端像素寵物,並對 Claude 的操作和你的打字做出反應。
關於這個 mod
Claudomon 是以 TypeScript function hooks 實作的 Claude Code Mod,並以 plugin 形式提供。每個專案都會孵化自己的像素寵物;牠的外形、顏色、耳朵與花紋以專案的 git remote 作為種子,所以同一個儲存庫的隊友會得到相同的寵物。寵物以覆蓋層顯示在對話右上角,可以拖曳並停駐。讀檔時牠會看書、搜尋時會跑跑步機、刪除程式碼時會吃餅乾、寫程式碼時會大便、思考時會顯示問號,藉此替 Claude 的活動做動畫;你按鍵時牠會跟著打字並顯示 WPM。滑鼠移上去可查看,點擊會讓牠飛過畫面,按右鍵則開啟顯示統計、XP,以及命名、打瞌睡、隱藏按鈕的卡片。提示、編輯和按鍵都會讓牠獲得 XP;每個專案的所有工作階段共用一隻寵物。使用 /plugin marketplace add hathcox/claudomon 與 /plugin install claudomon@claudomon 安裝,再用 /claudomon 指令查看統計、命名或隱藏。這個 Mod 是為全螢幕終端配置打造,可在 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


