claudeers.
// Claude Plugins

clawd-actor

Claude Code mod: Clawd acts out what Claude is doing, above the prompt

// Claude Plugins[ cli ][ api ][ web ][ claude ]#claude#animation#claude-code#claude-code-mod#claude-code-plugin#clawd#hooks#spinner#plugins◷ MIT$open-sourceupdated about 1 month ago
Actively maintained
100/100
last commit 20 days ago
last release 20 days ago
releases 11
open issues 2
// star history

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.
// or install directly (claude-plugin)
/plugin marketplace add BrianHuang813/clawd-actor
/plugin install clawd-actor@BrianHuang813/clawd-actor
// or clone
git clone https://github.com/BrianHuang813/clawd-actor

// compatibility

Platformscli, api, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageTypeScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

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.

Clawd watching a baby Clawd hatch, dancing with two backup dancers, walking with two little ones in a row, and cooking at a pot that stays put

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: Bash types, Read/Grep/Glob think, Edit/Write sketch, Agent herds sheep, Web* checks the weather, TodoWrite/Skill juggles, 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).
SceneSpinner words (some of them)
thinkPondering, Musing, Clauding, Noodling, Ruminating
chalkDeciphering, Elucidating, Philosophising, Deliberating, Reasoning
cook / bake / brewSautéing, Simmering, Whisking / Baking, Kneading / Brewing, Percolating
walk / run / moonwalkMoseying, Wandering / Scampering, Galloping / Moonwalking
herdHerding, Wrangling, Mustering
spinSpinning, Churning, Reticulating, Combobulating
magic / levitateConjuring, Manifesting, Transmuting / Levitating, Hyperspacing
hatch / growHatching, Incubating / Sprouting, Germinating
forge / computeForging, Crafting, Creating / Computing, Crunching, Synthesizing
dance / juggle / honkVibing, Grooving, Boogieing / Juggling / Honking, Booping
sketch / weather / thunderSketching, Doodling / Misting, Billowing / Thundering
dig / flowBurrowing, Spelunking / Flowing, Undulating
kick / skate / campfireKicking, 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.render on Spinner only observes: it remembers the word and mode and lets the engine draw the spinner as usual.
  • tool.call notes the tool in flight and forgets it when the call returns.
  • One timer, started in session.start, advances a frame counter in $.state every 140 ms while a turn runs; the band reads it, which subscribes it to redraws. A timer started inside a turn.start hook does not outlive that dispatch, which is why it lives in session.start.
  • Whether to draw at all follows the band's own isWorking prop.
  • hooks/scenes.ts is pure: a 4-row grid of cells, a scene per name, sceneAt() choosing the scene for a frame and frameRows() 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.

17 views
★ 27 stars
unclaimed
updated about 1 month ago

// embed badge

clawd-actor on Claudeers
[![Claudeers](https://claudeers.com/api/badge/clawd-actor.svg)](https://claudeers.com/clawd-actor)

// retro hit counter

clawd-actor hit counter
[![Hits](https://claudeers.com/api/counter/clawd-actor.svg)](https://claudeers.com/clawd-actor)

// reviews

// guestbook

0/500

// related in Claude Plugins

🔓

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

// pluginsmultica-ai/★ 230,631[ claude ]
🔓

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…

// pluginsanthropics/⟨Python⟩★ 154,558[ claude ]
🔓

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

// pluginsHKUDS/⟨Python⟩★ 58,467◷ Apache-2.0[ claude ]
🔓

financial-services — a Claude ecosystem project on GitHub.

// pluginsanthropics/⟨Python⟩★ 41,027◷ Apache-2.0[ claude ]
→ see how clawd-actor connects across the ecosystem