saiharsha03/clawd-spinner
clawd-spinner
clawd-spinner:Claude 工作时,Clawd 会在转圈提示词上方演绎对应动作:Sautéing 时做饭,Vibing 时跳舞,pacin
关于这个 mod
clawd-spinner
一个 Claude Code mod:Claude 工作时,Clawd 会在 spinner 那一行上方演绎 spinner 词语。
它不会消耗你的用量。 每个场景都由代码在本地绘制:没有模型调用、没有 token,也没有网络。你的用量留给真正重要的事情。
- Claude Code 的 189 个 spinner 词语各有自己的场景:Baking 会把面包滑进烤箱,Beaming 会被 UFO 拉起来,Gitifying 会画提交图,Honking 会按喇叭。
- Claude Code 之后新增的词语会回退到 11 个通用动作之一(做饭、思考、跳舞、建造……)。
- Clawd 会在头旁的对话气泡里说自己正在做什么。气泡会跟着它在场景中移动,并逐字显示。他说话像《Project Hail Mary》里的 Rocky:问题结尾会加上 ",question?",一个词说 3 次表示程度很高("Hot hot hot."),小词会被省略。
- 每个词都有专属的 10 行台词,总共 1,890 行,任意两个词都不会共享台词。Baking:"Oven very hot. Clawd wait." Gitifying:"Merge conflict, question? Ugh." 他每 10 秒换到下一行,每个回合开始的位置都不同。没见过的词会围绕它生成 二十 行("Big word. Small Clawd. Defenestrating!")。
- 想让它安静一点?
/clawd-talk会关闭(也会重新开启)对话气泡;/clawd-talk off或/clawd-talk on可以设置状态。选择会跨 session 记住。
词语如何选择场景
Claude Code 每个回合会随机选择一个 spinner 词。hooks/frame.ts 会在 hooks/scenes/ 中查找这个词(每个词一个场景);未知词会交给 hooks/acts.ts 的 actFor(),它通过词干列表匹配(saut|whisk|brew… → 做饭,……)。
台词位于 hooks/lines.ts(以词语为键);hooks/rocky.ts 会挑选一行,并为没见过的词保留 二十 行;hooks/frame.ts 中的 bubble() 会在 clawd() 上次把 Clawd 放置的位置绘制气泡。
安装
/plugin marketplace add https://github.com/saiharsha03/clawd-spinner.git
/plugin install clawd-spinner@clawd-spinner
然后执行 /reload-plugins(或重启 Claude Code)。这个 HTTPS 链接在 GitHub 中有无 SSH key 都能用;短格式 saiharsha03/clawd-spinner 可能会先尝试 SSH。也可以从 clone 后的目录运行 claude --plugin-dir ./clawd-spinner。
更新方式:先执行 /plugin marketplace update clawd-spinner,再执行 /plugin update clawd-spinner@clawd-spinner。
需要 Claude Code 2.1.287 或更新版本(mods 从该版本起默认开启)。仅支持终端,窗口至少要有 54 列。
安装
请先查看作者 README 确认 marketplace 和插件名称;命令可能随仓库结构改变。
claude plugin marketplace add saiharsha03/clawd-spinner claude plugin install clawd-spinner@clawd-spinner
原文 / README
clawd-spinner
A Claude Code mod: while Claude works, Clawd acts out the spinner word above the spinner line.
It won't use any of your usage. Every scene is drawn locally from code: no model calls, no tokens, no network. Your usage goes to the things that matter.
- Every one of Claude Code's 189 spinner words has its own scene: Baking slides bread into an oven, Beaming gets pulled up by a UFO, Gitifying draws a commit graph, Honking honks.
- A word a later Claude Code adds falls back to one of 11 general acts (cook, think, dance, build, …).
- Clawd talks about what he's doing, in a speech bubble beside his head that follows him around the scene and types itself out. He talks like Rocky from Project Hail Mary: a question ends in ", question?", a word said three times means a lot ("Hot hot hot."), and small words get dropped.
- Every word has ten lines of its own, 1,890 in all, and no two words share a line. Baking: "Oven very hot. Clawd wait." Gitifying: "Merge conflict, question? Ugh." He moves on to the next line every 10 seconds, starting somewhere different each turn. A word he has never seen gets twenty lines built around it ("Big word. Small Clawd. Defenestrating!").
- Rather have him quiet?
/clawd-talkturns his speech bubble off (and on again);/clawd-talk offor/clawd-talk onsets it. The choice is remembered across sessions.
How a word picks its scene
Claude Code picks a random spinner word each turn. hooks/frame.ts looks the word up in
hooks/scenes/ (one scene per word); an unknown word goes to actFor() in hooks/acts.ts, which
matches stem lists (saut|whisk|brew… → cook, …).
His lines are in hooks/lines.ts (keyed by the word); hooks/rocky.ts picks one and holds the
twenty for unseen words; bubble() in hooks/frame.ts draws it where clawd() last put him.
Install
/plugin marketplace add https://github.com/saiharsha03/clawd-spinner.git
/plugin install clawd-spinner@clawd-spinner
Then /reload-plugins (or restart Claude Code). The HTTPS link works with or without SSH keys for
GitHub; the short form saiharsha03/clawd-spinner may try SSH first. Or from a clone:
claude --plugin-dir ./clawd-spinner.
To update: /plugin marketplace update clawd-spinner, then /plugin update clawd-spinner@clawd-spinner.
Needs Claude Code 2.1.287 or newer (mods are on by default from there). Terminal only, in a window at
least 54 columns wide; narrower, the stock spinner shows. On Windows, a "Filename too long" error
while adding the marketplace goes away after git config --global core.longpaths true.
What the hooks do
hooks/register.tsx hooks five events and only reads them; it never changes what they carry:
session.start: in an interactive session, reads whether his speech is on, registers/clawd-talk, and starts a timer that repaints the animation about 12 times a second.command.runfor/clawd-talk: turns his speech bubble off or on and remembers the choice.turn.start: notes when the turn began, so the scene's clock starts at 0 (a subagent's turn doesn't restart it).turn.complete: stops the animation when the main turn ends.ui.renderon theSpinnercomponent: draws Clawd, and his speech bubble, above the spinner line. Below 54 columns, or outside the terminal, it hands the spinner back to Claude Code unchanged.
Privacy: what data it sends
None. The mod reads only the spinner word and the turn's elapsed time that Claude Code hands it,
and draws in the terminal. Every line Clawd says is written into the mod; none is generated. It makes no network requests, no model calls, reads and writes no files,
and stores one thing: whether you turned his speech off (talk, in Claude Code's own plugin store). There is no remote server, so there is no privacy policy to link.
Develop
claude plugin validate .
claude plugin test .
npx tsx scripts/preview.ts preview.png Baking Beaming # PNG contact sheet
/plugin-types .claude-plugin/types regenerates the editor typings (git-ignored).
Credits
Spinner word list: shanraisshan/claude-code-best-practice
(reports/claude-spinner-verbs-and-tips.md). Clawd is Anthropic's mascot; this is an unofficial fan mod.
MIT licensed.
获取徽章
这是你的项目吗?把这个徽章放进 README 或网站,链接回本页。

