ClaudeMods
☰
KO
● — 명 접속 중 · 조회 — 회
후원프로젝트 제출
GitHub 저장소 · 작성자 muxia23

ricky-pixel-mod

Claude Code 안에 살면서 세션 전체를 지켜보는 픽셀 고양이 동반자입니다.

번역 완료

이 mod 소개

Ricky는 Claude Code용 픽셀 고양이 동반자 mod입니다. 대화 옆에 반짝이는 별밤 패널을 표시하고 Claude의 상태(생각 중, 도구 호출 중, 완료, 오류)에 따라 표정을 바꿉니다. 보드에는 작업 진행률, 실행 중인 하위 에이전트, 최근 도구 호출과 변경된 파일을 보여 주며 입력창 위에는 자동으로 크기가 조정되는 작은 Ricky 배너가 나타납니다. 보라색과 금색 테마 및 영어/중국어를 지원합니다.

설치

먼저 작성자의 README에서 marketplace와 플러그인 이름을 확인하세요. 저장소 구조에 따라 명령어가 달라질 수 있습니다.

claude plugin marketplace add muxia23/ricky-pixel-mod
claude plugin install ricky-pixel-mod
원문 / README
<div align="center"> <img src="docs/banner.png" alt="Ricky Pixel Mod" width="100%">

一只住在 Claude Code 里的像素猫,顺便帮你盯着整个会话。

<p> <a href="https://code.claude.com/docs/en/plugins/mods/create"><img src="https://img.shields.io/badge/Claude_Code-mod-8a5cf0?style=for-the-badge&logo=anthropic&logoColor=white" alt="Claude Code mod"></a> <a href=".claude-plugin/plugin.json"><img src="https://img.shields.io/badge/version-0.3.0-f5c542?style=for-the-badge" alt="version"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/code-MIT-b79bff?style=for-the-badge" alt="license"></a> <a href="https://github.com/muxia23/ricky-pixel-mod/stargazers"><img src="https://img.shields.io/github/stars/muxia23/ricky-pixel-mod?style=for-the-badge&color=2a1650&logo=github" alt="stars"></a> </p> <p> <a href="#-快速上手"><b>快速上手</b></a> · <a href="#-功能"><b>功能</b></a> · <a href="#-表情"><b>表情</b></a> · <a href="#%EF%B8%8F-选项"><b>选项</b></a> · <a href="#-常见问题"><b>常见问题</b></a> · <a href="README.en.md"><b>English</b></a> </p> <img src="docs/hero-zh.gif" alt="Ricky in Claude Code" width="100%"> </div>

https://github.com/user-attachments/assets/81b3f878-c860-4d3a-ad5b-624ac57eeeb6

<br>

Ricky 在对话旁边闪烁的星空里飞,跟着 Claude 的状态变表情:思考时闭眼、额头星星发光,调用工具时扇翅膀撒星尘,完成时眯眼笑,出错时炸毛。星空下面是一块看板:任务进度、运行中的子 agent、最近的工具调用,以及你改过的文件。

🚀 快速上手

1. 克隆

git clone https://github.com/muxia23/ricky-pixel-mod ~/ricky-pixel-mod

2. 加载:只在本次会话加载:

claude --plugin-dir ~/ricky-pixel-mod

或者每次启动都加载,在 ~/.claude/settings.json 里加:

{ "env": { "CLAUDE_CODE_PLUGIN_DIRS": "~/ricky-pixel-mod" } }

3. 切到全屏渲染:在 Claude Code 里输入:

/tui fullscreen

[!IMPORTANT] 侧边面板只有在全屏渲染下、终端宽度 ≥ 110 列时才会停靠在对话右侧;默认渲染模式下它会显示在输入框上方。这个设置会被记住,只需要切一次;想切回来用 /tui default。

4. 打个招呼:终端够宽时面板会自动打开,也可以随时输入 /ricky。

[!NOTE] 需要 Claude Code 2.1.287+(支持 mods),终端需要支持真彩色(Ghostty、iTerm2、WezTerm、Kitty、VS Code 等)。

✨ 功能

<table> <tr> <td width="50%" valign="top">

🌌 星空面板

横向铺满面板的像素星空,星星闪烁,金色月牙,32×32 的 Ricky 会上下浮动、眨眼、飞行。

</td> <td width="50%" valign="top">

📋 会话看板

任务进度条 · 运行中的子 agent 和它正在做什么 · 最近 6 次工具调用(✓ / ✗)· 改动文件。没有内容的块自动隐藏。

</td> </tr> <tr> <td width="50%" valign="top">

🐾 输入框上方横栏

小号 Ricky,Claude 工作时拖着星尘来回飞。它会根据剩余空间自动选大小:24 像素、16 像素,或者只露一个 8 像素的头,窗口再小也不会被截断。

</td> <td width="50%" valign="top">

💜 紫金主题

加载提示变成「Ricky 摘星中…」,每个回合结束显示「✦ Ricky 陪你施法了 12s」。支持中英文。

</td> </tr> </table>

🐱 表情

<div align="center"> <img src="docs/frames-32.png" alt="Ricky 的表情帧" width="100%"> </div>

| Claude 在… | Ricky… | | --- | --- | | 空闲 | 悬停,慢慢扇翅膀,偶尔眨眼 | | 思考 | 闭眼,额头星星发光 | | 调用工具 | 快速扇翅膀,撒星尘 | | 完成 | 眯眼笑 | | 出错 | 瞪眼炸毛 |

⚙️ 选项

在 /config 里找到 ricky-pixel-mod 下的选项,或者在 ~/.claude/settings.json 里设置:

{ "pluginConfigs": { "ricky-pixel-mod": { "options": { "language": "zh", "bandSize": "small" } } } }

| 选项 | 可选值 | | --- | --- | | language | en(默认)English · zh 简体中文 | | bandSize | auto(默认)自动选能放下的最大尺寸 · large / medium / small 最大 24 / 16 / 8 像素 · off 关闭横栏 |

🎨 打造你自己的 Ricky

Ricky 就是一段纯文本:tools/sprites.py 里每一帧只画左半边,自动镜像,一个字母就是一个像素。改几个字母,然后:

python3 tools/sprites.py   # 需要 Pillow → 生成 hooks/sprites.ts 和 docs/ 预览图
python3 tools/banner.py    # 重画封面

用 --plugin-dir 加载时,保存文件后 Claude Code 会自动热重载。

❓ 常见问题

<details> <summary><b>面板出现在输入框上方,不在侧边。</b></summary> <br> 输入 <code>/tui fullscreen</code>,并把终端拉宽到至少 110 列。宽度不到 144 列时面板不会自动打开,用 <code>/ricky</code> 打开。 </details> <details> <summary><b>颜色不对,或者是一块一块的。</b></summary> <br> 终端需要支持真彩色(24 位色),大多数现代终端都支持。 </details> <details> <summary><b>横栏太占地方。</b></summary> <br> 默认已经会根据空间自动缩小。想一直保持小号,在 <code>/config</code> 里把 <code>bandSize</code> 设成 <code>small</code>(或 <code>off</code> 关闭);只想临时收起,按 <code>ctrl+x ctrl+a</code>。 </details> <details> <summary><b>怎么清空看板?</b></summary> <br> <code>/clear</code> 开启新对话时会一起清空。 </details>

🛠 开发

claude plugin validate .   # 查看引擎看到了什么、会拒绝什么
claude plugin test .       # 运行 hooks/*.test.tsx 里的测试

📜 授权与声明

  • 代码:MIT。
  • Ricky 的形象(tools/sprites.py、hooks/sprites.ts 中的像素数据和 docs/ 中的图片):灵感来自 VALORANT 的一款皮肤角色,属于同人作品,不在 MIT 授权范围内,仅可按 Riot Games 粉丝内容政策非商业使用。详见 LICENSE。

<sub>Ricky Pixel Mod was created under Riot Games' "Legal Jibber Jabber" policy using assets owned by Riot Games. Riot Games does not endorse or sponsor this project.</sub>

<div align="center"> <br>

如果 Ricky 让你的终端变得可爱了一点,点个 ⭐ Ricky 会很开心。

</div>

배지 받기

내 프로젝트인가요? 이 배지를 README나 웹사이트에 넣으면 이 페이지로 연결됩니다.

Featured on ClaudeMods
크기
테마
Markdown
HTML

비슷한 프로젝트