hoobnn/hoobnn-agent-mods/tree/main/claude-code/spinner

Give Claude Code a pet that reacts to tools and permission requests, earns levels across sessions, and accompanies 15 animation themes, including a Mac system-audio visualizer.
hoobnn/hoobnn-agent-mods/tree/main/claude-code/spinner

spinner adds a small animated scene above the Claude Code prompt while the model works. Its 15 themes include Clawd, a scrolling shooter, a maze chase, a rainbow cat, character scenes and an audio spectrum. Other mod bands, such as hud, sit below the scene. A completed turn gets a short confetti celebration and an elapsed-time display; interrupted turns and errors have their own reactions.
The companion pet changes pose as Claude thinks, uses tools, writes output or waits. Its speech bubble shows the active tool or a pending permission request. With several subagents it displays their count; with one it shows the task. It also reacts briefly to test results and commits. Completed turns, passing tests and commits earn XP. Click the pet or use /spinner pet to pet it. Levels and affection persist across sessions, and concurrent sessions share the same pet. After five quiet minutes it dozes off. When the pet is disabled, a mascot appears on the existing spinner line without changing its text, elapsed time or token count. reducedMotion uses a still frame that continues to reflect Claude's state.
The audio theme draws the Mac's current system output as frequency bars, with a dancing figure and a headphone-wearing pet. It must be selected by name; random excludes it. It requires macOS 14.2 or later and swiftc, available through xcode-select --install. On first use, the mod compiles a small Core Audio helper and macOS asks for permission to let the terminal record system audio. The helper runs only while this theme is displayed and supplies levels 20 times a second; it does not save, write to disk or transmit the audio. Without permission the bars stay flat. If audio cannot be read, the figure sleeps and /spinner explains why.
Installation commands recorded for this project:
claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install spinner@hoobnn-agent-mods
Source: https://github.com/hoobnn/hoobnn-agent-mods/tree/main/claude-code/spinner
Check the author's README for the marketplace and plugin name first. Commands may change as the repository evolves.
claude plugin marketplace add hoobnn/hoobnn-agent-mods claude plugin install spinner@hoobnn-agent-mods
简体中文 · English
Claude 干活时,输入框上方会演一段小动画:像素风的横版射击、Claude 的吉祥物 Clawd、吃豆人、彩虹猫……还有一只会跟着 Claude 的动作变换姿势的宠物。一轮结束时放一小段彩带,显示这轮用了多久。共 15 套主题,随时切换,其中一套把电脑正在播放的声音画成频谱。

Bash: npm test、Edit: themes.ts),或者有权限请求在等你确认;模型思考时它就埋头忙。多个子代理并行时显示数量(Agent ×3),只有一个时显示它的任务。Claude 跑测试或提交时,它会说几秒钟(测试通过、测试没过、提交好了)。Lv.4);点它或输入 /spinner pet 可以摸摸它(♥12,会冒爱心)。等级和好感度跨会话保存,同时开的几个会话养的是同一只。[◉_◉]⊃━━ ✢ Choreographing… (4s · ↓ 14 tokens)),原来的提示词、用时和 token 数不变。同一时间只显示一个吉祥物。(=^▽^=)ノ 完成 · 12s);被中断是一张难过的脸,出错是一阵故障闪烁。reducedMotion 后,所有动画都只画静止的一帧,但仍会随 Claude 的状态变化。像素风场景,三行半格像素:
clawd:Claude Code 的吉祥物 Clawd 散步路过,停下来干活,身边转着 Claude 的星芒;跑工具时敲笔记本,等你确认时头上冒 ?。thunder:雷霆战机式横版射击,战机自动瞄准一波波敌机,有爆炸和计分;跑工具时敌机来得更快。chomp:吃豆人被四只幽灵追着跑,直到吞下能量豆。sparky:电气鼠一路冲过去,脸颊噼啪放电,跑工具时落下闪电。bluecat:蓝色机器猫戴着竹蜻蜓飞,跑工具时口袋里掉出道具。nyan:彩虹猫拖着彩虹飞过星空。角色场景,两行:cat(猫)、bunny(兔子)、sakura(樱花)、mecha(机甲)、neon(霓虹)、dino(小恐龙)、ocean(小鱼)、matrix(字符雨)。也可以选 random,每个会话随机一套。
声音场景,四行:audio 把 Mac 正在播放的声音(音乐、视频、通话)实时画成频谱,每个频段一根柱子,顶上的峰值慢慢落下;左边的小人踩着节拍跳舞,宠物戴着大耳机。有声音时两轮之间也会显示,声音停几秒后收起。random 不会抽到它,要按名字选。

audio 需要 macOS 14.2 及以上和 swiftc(Xcode 命令行工具:xcode-select --install)。第一次使用时,mod 用 hooks/audio-tap.swift 编译一个小程序(约 2 秒),只在这套主题显示时运行:它通过 Core Audio 读取系统输出,每秒 20 次把各频段的电平交给 mod,不保存、不写盘、不外传声音。macOS 会询问一次是否允许终端录制系统音频,拒绝的话柱子一直是平的。读不到声音时(其他系统、桌面 App、编译失败),场景里的小人睡着,/spinner 会说明原因。预览和下面的动图用的是合成信号。
| | |
| --- | --- |
| clawd<br>
| thunder<br>
|
| chomp<br>
| sparky<br>
|
| bluecat<br>
| nyan<br>
|
| cat<br>
| bunny<br>
|
| sakura<br>
| mecha<br>
|
| neon<br>
| dino<br>
|
| ocean<br>
| matrix<br>
|
| audio<br>
| |
所有主题的吉祥物、场景和宠物合在一张图里:assets/gallery.png;每套主题的静态图在 assets/<主题>.png。
chomp、sparky、bluecat、nyan 是从零绘制、另起名字的同人致敬;clawd 照着 Claude Code 欢迎界面上的样子绘制。
claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install spinner@hoobnn-agent-mods
像素场景需要支持真彩色的终端(Ghostty、iTerm2、WezTerm、kitty 等)。
/spinner:查看当前主题、宠物的等级和好感度,以及主题列表。/spinner <主题>、/spinner random:立即切换主题;/spinner theme 弹窗选择(给出随机和三套主题,其他主题可以在 Other 里输入)。/spinner preview [主题]:在输入框上方试播 8 秒。/spinner pet:摸摸宠物。/spinner off / on:关闭或打开全部动画;/spinner stage off / on 只管动画场景;/spinner companion off / on 只管宠物。这些命令改的设置都会写回 /config,以后的会话也会沿用,并立即生效。选了 random 时,同一个会话里重新加载也不会换主题。
在 /config 里修改,或写在 ~/.claude/settings.json 的 pluginConfigs 里:
| 选项 | 作用 | 默认 |
| --- | --- | --- |
| visible | 全部动画的总开关(/spinner off / on,或输入框底栏的 Spinner 按钮) | 开 |
| footerButton | 在输入框底栏显示 Spinner 开关按钮 | 开 |
| theme | 主题 | random |
| stage | 输入框上方的动画场景 | 开 |
| celebrate | 一轮结束时的庆祝动画 | 开 |
| companion | 宠物伴侣 | 开 |
| reducedMotion | 吉祥物、场景和宠物只画静止画面,仍随状态变化 | 关 |
| language | /spinner 回复、宠物气泡和庆祝文字的语言:auto、en、zh-Hans、zh-Hant、ja、ko、es、fr、de、pt-BR、ru | auto |
language 为 auto 时,依次跟随 Claude Code 的 language 设置和系统语言环境,都没有时用英语。
Claude 工作时,横条占主题的行数再加宠物一行;两轮之间只占一行。空间不够时先收起场景、保留宠物;不足 3 行或 60 列时,宠物缩成一行(吉祥物、气泡和等级)。吉祥物、场景和宠物在终端和桌面 App 里显示;其他界面保持 Claude Code 原本的 Spinner。
hoobnn-agent-mods 里还有状态栏 HUD(hud)、任务进度条(todo-bar)、回合回执(receipt)、Tailscale 节点状态(ts-band)和一言(hitokoto),可以搭配使用。
hooks/register.tsx:钩子(会话开始,回合事件:活动、庆祝、宠物,/spinner,Spinner 行上的吉祥物和横条)。hooks/config.ts:选项,一次性读成类型化的 Config。hooks/command.ts:解析 /spinner 的参数。hooks/pet.ts:宠物的等级和气泡、工具标签、时长。hooks/themes.ts、hooks/cells.ts:主题和它们绘制用的字符网格;hooks/stage.tsx、hooks/sprite.tsx:负责播放动画的 Client 模块。hooks/audio.ts、hooks/audio-tap.swift:audio 主题的电平处理(增益、峰值、节拍)和它读取的系统音频小程序;register.tsx 负责编译、启动和停止它,场景每帧通过 ui.message 取最新电平。hooks/i18n.ts:各语言文案。hooks/kit/:claude-code/kit 的副本;改源文件后运行 scripts/sync-kit.sh。scripts/spinner-shots.ts 从 hooks/themes.ts 重新渲染全部动图和静态图。Is this your project? Add this badge to your README or website. It links back to this page.