GitHub リポジトリ · 投稿者 hathcox

claudomon

Name: claudomon
Author: hathcox

プロジェクトの git remote から孵化し、Claude の操作や入力に反応するターミナル用ドット絵ペットを描画する Claude Code plugin です。

hathcox@hathcox

hathcox/claudomon/tree/main/plugin

翻訳済み

この mod について

Claudomon は TypeScript の function hooks で実装された Claude Code mod で、plugin として動きます。各プロジェクトは独自のドット絵ペットを孵化させます。形、色、耳、模様はプロジェクトの git remote を seed に決めるため、同じ repo のチームメンバーには同じペットが表示されます。ペットは会話の右上に overlay として現れ、ドラッグして dock できます。ファイルを読むと本を読み、検索中はトレッドミルを走り、コードを削除するとクッキーを食べ、コードを書いていると排便し、考え中は疑問符を出すなど、Claude の活動をアニメーションで表します。キー入力には WPM 表示付きで追従してタイプします。hover で確認でき、クリックすると画面を横切って飛び、右クリックすると統計、XP、名前、昼寝、非表示のボタンがあるカードを開きます。prompt、edit、keystroke で XP が増え、1 つのプロジェクトでは全 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 in register.tsx so it can be unit-tested.
tests/unit/ are node:test suites run with tsx.
tests/scenarios/ drive a real session at 80×24 through tools/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.