
clawd-actor
Claude Code mod: Clawd acts out what Claude is doing, above the prompt
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up clawd-actor (claude-plugin project) into my current project. Found on https://claudeers.com/clawd-actor Repo: https://github.com/BrianHuang813/clawd-actor Homepage/docs: — Detected install method: claude-plugin → /plugin install clawd-actor@BrianHuang813/clawd-actor Category: plugins. Platforms: cli, api, web. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: active; community-verified: false. Confirm the source before running anything.
/plugin marketplace add BrianHuang813/clawd-actor /plugin install clawd-actor@BrianHuang813/clawd-actor
git clone https://github.com/BrianHuang813/clawd-actor
// compatibility
| Platforms | cli, api, web |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | TypeScript |
clawd-actor
A Claude Code mod: while Claude works, Clawd walks onto a little stage above the prompt and
acts out what is going on — the spinner's -ing word (Sautéing, Pondering, Herding…) and
whatever tool is running right now.

Four scenes at the real frame rate, about 15 s in all (a real turn changes scene every 15 s). Every frame is the mod's own output, rendered by tools/.
What it does
- Acts out the spinner word. 29 scenes, matched by word stem, so Flambéing cooks and Dilly-dallying strolls. A word it does not know falls back to what the turn is doing (typing for tool use, talking while responding, thinking otherwise).
- Acts out the running tool. In a turn's first 15 seconds a running tool picks the scene
instead:
Bashtypes,Read/Grep/Globthink,Edit/Writesketch,Agentherds sheep,Web*checks the weather,TodoWrite/Skilljuggles, MCP tools cast spells, anything else is hammered at the forge. - Changes scene every 15 seconds on long turns, whatever tools run, in an order shuffled per session that picks up where the last turn stopped, never the same scene twice in a row.
- Wanders the stage. When all it carries is a thought bubble, notes or sparks, Clawd strolls left and right, swinging arms and legs, hopping at each turn and landing with a squash. By a pot, an oven, an anvil or a plant it stays put and works; the stage follows the terminal width (up to 60 columns). At the blackboard the board stays put and Clawd steps back to admire its work. By the campfire it sits still with a purple friend, and only the fire and their eyes move.
- Brings little friends. Small Clawds in blue, yellow, green and pink tag along: one copies its idle hop a beat late, two dance backup, two walk in a row behind it (and lead the way back), two sit by the campfire when the stage is wide enough, and one hatches from the egg, stands in its shell and hops out to say hello.
- Has a face. Happy ^ ^ eyes, blinks, glances around, and sways so its far side falls into shadow, after the official Clawd animation; on the move it looks where it is going.
- Leaves when the turn ends, and draws nothing while idle (the frame timer only redraws during a turn).
| Scene | Spinner words (some of them) |
|---|---|
| think | Pondering, Musing, Clauding, Noodling, Ruminating |
| chalk | Deciphering, Elucidating, Philosophising, Deliberating, Reasoning |
| cook / bake / brew | Sautéing, Simmering, Whisking / Baking, Kneading / Brewing, Percolating |
| walk / run / moonwalk | Moseying, Wandering / Scampering, Galloping / Moonwalking |
| herd | Herding, Wrangling, Mustering |
| spin | Spinning, Churning, Reticulating, Combobulating |
| magic / levitate | Conjuring, Manifesting, Transmuting / Levitating, Hyperspacing |
| hatch / grow | Hatching, Incubating / Sprouting, Germinating |
| forge / compute | Forging, Crafting, Creating / Computing, Crunching, Synthesizing |
| dance / juggle / honk | Vibing, Grooving, Boogieing / Juggling / Honking, Booping |
| sketch / weather / thunder | Sketching, Doodling / Misting, Billowing / Thundering |
| dig / flow | Burrowing, Spelunking / Flowing, Undulating |
| kick / skate / campfire | Kicking, Dribbling / Skating, Gliding / Kindling, Smoldering — no built-in word matches these yet, so they mostly turn up in the rotation |
Install
Requires a Claude Code build with function-hook mods (claude plugin validate knows hooks.json
modules). Developed and tested on Claude Code 2.1.289.
From this repository as a marketplace:
/plugin marketplace add BrianHuang813/clawd-actor
/plugin install clawd-actor@clawd-actor
/reload-plugins
Or straight from a clone, for one session:
git clone https://github.com/BrianHuang813/clawd-actor
claude --plugin-dir ./clawd-actor
Plays well with other band mods
The stage is drawn in the AbovePrompt band. The hook always calls next(e) and stacks what the
mods beneath it draw under the stage, so other band mods keep showing. A band mod that answers
without calling next(e) hides everything beneath it — if Clawd never shows up, look for one.
How it works
ui.renderonSpinneronly observes: it remembers the word and mode and lets the engine draw the spinner as usual.tool.callnotes the tool in flight and forgets it when the call returns.- One timer, started in
session.start, advances a frame counter in$.stateevery 140 ms while a turn runs; the band reads it, which subscribes it to redraws. A timer started inside aturn.starthook does not outlive that dispatch, which is why it lives insession.start. - Whether to draw at all follows the band's own
isWorkingprop. hooks/scenes.tsis pure: a 4-row grid of cells, a scene per name,sceneAt()choosing the scene for a frame andframeRows()turning the grid into coloured runs.
Develop
claude plugin validate .
claude plugin test .
The tests check that every scene keeps the stage size at 30, 40 and 60 columns and moves Clawd about only in the scenes without set pieces (the rest are checked to stay put), that no prop is ever drawn over Clawd's face, that a turn opens on the running tool or the spinner word and then rotates through every other scene whatever tools run, picking up where the last turn stopped, and that the timer animates Clawd during a turn and lets go after it.
Block characters and symbols are drawn one cell wide; a terminal font that draws some of them wider may shift a frame.
To regenerate assets/demo.gif after changing a scene (Node 22+ and Python with Pillow):
node tools/frames.ts > frames.json # the frames, straight from hooks/scenes.ts
python tools/render.py frames.json assets/demo.gif
tools/render.py uses DejaVu Sans Mono and draws block elements as exact rectangles; edit the
font path at its top for your system.
Notes
Clawd is Claude Code's mascot; the sprite follows the one on Claude Code's welcome screen. This is a fan-made mod, not affiliated with or endorsed by Anthropic.
// faq
What is clawd-actor?
Claude Code mod: Clawd acts out what Claude is doing, above the prompt. It is open-source on GitHub.
Is clawd-actor free to use?
clawd-actor is open-source under the MIT license, so it is free to use.
What category does clawd-actor belong to?
clawd-actor is listed under plugins in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/clawd-actor)
// retro hit counter
[](https://claudeers.com/clawd-actor)
// reviews
// guestbook
// related in Claude Plugins
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explainin…
"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/
financial-services — a Claude ecosystem project on GitHub.