saiharsha03/clawd-spinner
clawd-spinner
clawd-spinner:Claude 工作時,Clawd 會在 spinner 文字上方演出對應動作: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可以設定狀態。選擇會跨工作階段保留。
文字如何選擇場景
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 或網站,連回本頁。

