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

도구와 권한 요청에 반응하고 세션마다 레벨이 오르는 펫을 Claude Code에 추가하며, Mac 시스템 오디오 시각화 테마를 포함한 15가지 애니메이션 테마를 제공합니다.
hoobnn/hoobnn-agent-mods/tree/main/claude-code/spinner

spinner는 모델이 작업하는 동안 Claude Code 프롬프트 위에 작은 애니메이션 장면을 표시합니다. 15가지 테마에는 Clawd, 스크롤 슈팅 게임, 미로 추적, 무지개 고양이, 캐릭터 장면, 오디오 스펙트럼이 포함됩니다. hud 같은 다른 모드 밴드는 장면 아래에 표시됩니다. 턴이 끝나면 짧은 색종이 축하 효과와 경과 시간이 나타나며, 중단된 턴과 오류에도 각각의 반응이 있습니다.
동반 펫은 Claude가 생각하거나 도구를 사용하거나 출력을 작성하거나 기다릴 때 자세를 바꿉니다. 말풍선에는 활성 도구 또는 대기 중인 권한 요청이 표시됩니다. 서브에이전트가 여러 개면 개수를 표시하고, 하나면 작업을 표시합니다. 테스트 결과와 커밋에도 잠시 반응합니다. 완료된 턴, 통과한 테스트, 커밋으로 XP를 얻습니다. 펫을 클릭하거나 /spinner pet을 사용해 쓰다듬을 수 있습니다. 레벨과 친밀도는 세션 간에 유지되고 동시 세션은 같은 펫을 공유합니다. 5분 동안 조용하면 잠듭니다. 펫을 끄면 기존 spinner 줄에 마스코트가 나타나지만 텍스트, 경과 시간, 토큰 수는 바뀌지 않습니다. reducedMotion은 정지 화면을 사용하면서도 Claude의 상태를 계속 반영합니다.
audio 테마는 Mac의 현재 시스템 출력을 주파수 막대로 그리고, 춤추는 인물과 헤드폰을 쓴 펫을 보여 줍니다. 이름으로 선택해야 하며 random에서는 제외됩니다. macOS 14.2 이상과 xcode-select --install로 사용할 수 있는 swiftc가 필요합니다. 처음 사용하면 모드가 작은 Core Audio 헬퍼를 컴파일하고, macOS는 터미널이 시스템 오디오를 녹음하도록 허용할지 묻습니다. 헬퍼는 이 테마가 표시될 때만 실행되고 초당 20회의 레벨을 제공하며, 오디오를 저장하거나 디스크에 쓰거나 전송하지 않습니다. 권한이 없으면 막대가 평평하게 유지됩니다. 오디오를 읽을 수 없으면 인물이 잠들고 /spinner가 이유를 설명합니다.
이 프로젝트에 기록된 설치 명령:
claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install spinner@hoobnn-agent-mods
출처: https://github.com/hoobnn/hoobnn-agent-mods/tree/main/claude-code/spinner
먼저 작성자의 README에서 marketplace와 플러그인 이름을 확인하세요. 저장소 구조에 따라 명령어가 달라질 수 있습니다.
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 重新渲染全部动图和静态图。내 프로젝트인가요? 이 배지를 README나 웹사이트에 넣으면 이 페이지로 연결됩니다.