Ricky 在对话旁边闪烁的星空里飞,跟着 Claude 的状态变表情:思考时闭眼、额头星星发光,调用工具时扇翅膀撒星尘,完成时眯眼笑,出错时炸毛。星空下面是一块看板:任务进度、运行中的子 agent、最近的工具调用,以及你改过的文件。
1. 克隆
git clone https://github.com/muxia23/ricky-pixel-mod ~/ricky-pixel-mod2. 加载:只在本次会话加载:
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 等)。
|
横向铺满面板的像素星空,星星闪烁,金色月牙,32×32 的 Ricky 会上下浮动、眨眼、飞行。 |
任务进度条 · 运行中的子 agent 和它正在做什么 · 最近 6 次工具调用(✓ / ✗)· 改动文件。没有内容的块自动隐藏。 |
|
24×24 的小 Ricky,Claude 工作时拖着星尘来回飞,空闲时停下休息。 |
加载提示变成「Ricky 摘星中…」,每个回合结束显示「✦ Ricky 陪你施法了 12s」。支持中英文。 |
| Claude 在… | Ricky… |
|---|---|
| 空闲 | 悬停,慢慢扇翅膀,偶尔眨眼 |
| 思考 | 闭眼,额头星星发光 |
| 调用工具 | 快速扇翅膀,撒星尘 |
| 完成 | 眯眼笑 |
| 出错 | 瞪眼炸毛 |
默认是英文。在 /config 里找到 ricky-pixel-mod 的 Language,或者在 ~/.claude/settings.json 里设置:
{ "pluginConfigs": { "ricky-pixel-mod": { "options": { "language": "zh" } } } }language |
语言 |
|---|---|
en(默认) |
English |
zh |
简体中文 |
Ricky 就是一段纯文本:tools/sprites.py 里每一帧只画左半边,自动镜像,一个字母就是一个像素。改几个字母,然后:
python3 tools/sprites.py # 需要 Pillow → 生成 hooks/sprites.ts 和 docs/ 预览图
python3 tools/banner.py # 重画封面用 --plugin-dir 加载时,保存文件后 Claude Code 会自动热重载。
面板出现在输入框上方,不在侧边。
输入
/tui fullscreen,并把终端拉宽到至少 110 列。宽度不到 144 列时面板不会自动打开,用 /ricky 打开。
颜色不对,或者是一块一块的。
终端需要支持真彩色(24 位色),大多数现代终端都支持。
横栏太占地方。
按
ctrl+x ctrl+a 折叠,再按一次 Ricky 就回来了。
怎么清空看板?
/clear 开启新对话时会一起清空。
claude plugin validate . # 查看引擎看到了什么、会拒绝什么
claude plugin test . # 运行 hooks/*.test.tsx 里的测试- 代码:MIT。
- Ricky 的形象(
tools/sprites.py、hooks/sprites.ts中的像素数据和docs/中的图片):灵感来自 VALORANT 的一款皮肤角色,属于同人作品,不在 MIT 授权范围内,仅可按 Riot Games 粉丝内容政策非商业使用。详见 LICENSE。
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.
如果 Ricky 让你的终端变得可爱了一点,点个 ⭐ Ricky 会很开心。


