ClaudeMods
☰
ZH-CN
● 0 人在线 · 浏览 0 次
赞助提交作品
GitHub 仓库 · 发布者 hathcox

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 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.

License

MIT

更多类似作品