Clawd Actor: a Clawd Claude Code mod that acts out what Claude is doing
Clawd, Claude Code's mascot, acts out the spinner word and the running tool on a small stage above the prompt.
Permissions
- Reads filesCan read files and list directories on your machine ($.fs.read / list / stat / exists).
- NetworkCan make HTTP requests or talk to MCP servers ($.http.fetch / $.mcp.*).
- Calls the model (uses your quota)Can send its own requests to Claude, which count against your plan's usage ($.model.* / $.agent.spawn).
- Intercepts tool callsSees every tool call Claude makes (tool.call / tool.check) and could block or change it.
- Changes the UIDraws into the Claude Code interface: bands, panes, status text, toasts (ui.render / $.ui.*).
- Adds commands/toolsRegisters new slash commands or tools that you or Claude can invoke ($.command.register / $.tool.register).
- Stores dataKeeps data between sessions in the plugin's private store ($.store.*).
- tested with
- v2.1.310
- last tested
- requires
- Claude Code ≥ 2.1.287
- surfaces
- above-prompt, toast
Install inside Claude Code:
/plugin install clawd-actor --marketplace BrianHuang813/clawd-actorWhat does this mod do?
Clawd Actor is a community mod by Brian Huang (BrianHuang813), published at BrianHuang813/clawd-actor. This Clawd Claude Code mod puts Claude Code's mascot on a small stage above the prompt while a turn runs. Clawd acts out the spinner's -ing word, so Sautéing cooks and Pondering thinks, and then rotates through a show of 32 scenes, changing every 15 seconds. When the turn ends, Clawd leaves and the stage draws nothing.
According to the author's README, the mod also:
- picks the opening scene from the running tool when one is already running (
Bashtypes,EditandWritesketch,Agentherds sheep); - dresses Clawd for some scenes, such as a detective's fedora for thinking or an astronaut helmet for levitating;
- brings small coloured Clawds along in some scenes;
- adds a
/clawdcommand:/clawd pet,feed,wave,danceandshiftplay a short reaction, and any other text is answered by Clawd in a speech bubble.
The stage follows the terminal width, up to 60 columns, and stays out when the band is too short for it.
Install
The install block above adds the author's marketplace and installs the plugin from it. Then run /reload-plugins or restart Claude Code. The mod needs a Claude Code build that supports function-hook mods; the author developed it on 2.1.296 and we loaded it on 2.1.310.
$ install clawd-actor
Requires Claude Code ≥ 2.1.287
Installs from the author's own marketplace: BrianHuang813/clawd-actor
1.One line, inside Claude Code
/plugin install clawd-actor --marketplace BrianHuang813/clawd-actorPaste into a running session (v2.1.275+). Claude Code asks to add the marketplace first.
2.From your shell
claude plugin marketplace add BrianHuang813/clawd-actor claude plugin install clawd-actor@clawd-actorThen run /reload-plugins in any session that is already open.
3.Try it without installing
git clone https://github.com/BrianHuang813/clawd-actor claude --plugin-dir ./clawd-actorLoads the mod for one session only. Nothing is added to your settings.
How it works
The mod is one function-hooks module, hooks/register.tsx, plus two pure helper files: hooks/scenes.ts (the 5-row cell grid, the scenes and the costumes) and hooks/chat.ts (the /clawd parser, the persona prompt and the speech bubble). One timer, started in session.start, advances a frame counter every 140 ms and only writes while a turn runs. The Spinner render hook only observes the word and passes the render on. The AbovePrompt hook draws the stage and stacks whatever other band mods draw beneath it. This is from register.tsx:
// While a tool runs Clawd acts it out; back to the rotation once it returns
on('tool.call', async ($, e, next) => {
running.push({ id: e.tool_use_id, tool: e.tool })
try {
return await next(e)
} finally {
const i = running.findIndex(r => r.id === e.tool_use_id)
if (i >= 0) running.splice(i, 1)
}
})The /clawd command is registered as immediate, so it runs mid-turn without interrupting Claude. Its command.run hook returns no text, so nothing reaches the transcript or the model. A chat message calls $.model.complete from a one-shot timer, so the prompt never waits on the reply, and a reply that arrives after a newer /clawd is dropped. The turn's show is also kept in $.state, so /reload-plugins in the middle of a turn picks up where it was.
Customize it
There are no settings. You steer Clawd only through the command: /clawd pet, /clawd feed, /clawd wave (or hi, hello), /clawd dance, /clawd shift (or 閃身步), or any other text to chat. /clawd with nothing after it shows the help line. The scenes, costumes and the spinner-word table live in hooks/scenes.ts, so changing them means editing that file in a clone and loading it with --plugin-dir.
Permissions & safety
We read every file the plugin loads before running it: hooks/register.tsx, hooks/chat.ts, hooks/scenes.ts (searched for network, process and eval use, none found), hooks/hooks.json, the manifests and the update skill. There is no minified or bundled code and no binary in the load path. The tools/ folder (frame renderers and a Pillow script for the README GIFs) is not referenced by the plugin. Here is what we found:
- Network:
$.http.fetchruns once per session, two seconds after start-up, atregister.tsx:64. It readsraw.githubusercontent.com/BrianHuang813/clawd-actor/main/.claude-plugin/plugin.jsonto compare versions. On the first session after an update it also reads the release fromapi.github.com. Both are plain GET requests that send nothing of yours, and a failure is silently ignored. This is on by default and has no switch. - Model call: only when you type
/clawd <text>. The text (cut to 500 characters) goes tohaikuthrough$.model.complete, with a persona prompt and a line on what the spinner says and which tool runs. It counts against your usage and never enters Claude's conversation. - Files: no writes.
$.fs.readreads only the plugin's ownplugin.json.$.storekeeps the last-seen version inside the plugin's own store. - Processes, daemons, secrets, telemetry: none. No process is started, no environment variable or credential is read, and there is no analytics.
- Intercepts tool calls: the
tool.callhook only records the tool name and always passes the call on unchanged. The validator lists it as a gating hook without.catch; since the hook neither blocks nor rewrites anything, this has no user-facing effect. - Prompt content: no
additionalContextand no prompt rewriting. We found no hidden or zero-width characters in the repository. - Update skill:
/clawd-actor:updateis a skill that lets Claude runclaude plugin list,claude plugin marketplace update clawd-actorandclaude plugin update clawd-actor@clawd-actor, and fetch the GitHub releases API. Its allowed tools are limited to those commands. - License: MIT, with a LICENSE file ("Copyright (c) 2026 Brian Huang").
claude plugin validate passed with no errors; its only finding is a non-blocking directory warning that the plugin has no icon. claude plugin test ran 23 tests across 4 files and all passed. To turn the mod off, run /plugin disable clawd-actor.
- Reads files
- Can read files and list directories on your machine ($.fs.read / list / stat / exists).
- Network
- Can make HTTP requests or talk to MCP servers ($.http.fetch / $.mcp.*).
- Calls the model (uses your quota)
- Can send its own requests to Claude, which count against your plan's usage ($.model.* / $.agent.spawn).
- Intercepts tool calls
- Sees every tool call Claude makes (tool.call / tool.check) and could block or change it.
- Changes the UI
- Draws into the Claude Code interface: bands, panes, status text, toasts (ui.render / $.ui.*).
- Adds commands/tools
- Registers new slash commands or tools that you or Claude can invoke ($.command.register / $.tool.register).
- Stores data
- Keeps data between sessions in the plugin's private store ($.store.*).
Compatibility & troubleshooting
We loaded the plugin on Claude Code 2.1.310 on macOS. Clawd shows in claude in a terminal, including an editor's terminal, and in the Code tab of the Desktop app. According to the README, the VS Code chat panel, claude -p and cloud sessions draw no mod interface, so nothing shows there. If Clawd does not appear:
- Check that a turn is actually running; the stage is empty while Claude is idle.
- Look for another band mod that answers without calling
next(e). It hides everything beneath it, Clawd included. - Make sure the band has enough free rows. When it is too short for the stage, Clawd stays out.
- The
shiftscene needs a terminal font that draws CJK characters two columns wide. - After installing from the shell into an open session, run
/reload-plugins.
To check that it works, send Claude a prompt that takes a few seconds, such as reading a large file, and watch the area above the prompt. Then try /clawd pet while it runs.
FAQ
- Does Clawd show while Claude Code is idle?
- No. The frame timer only redraws during a turn, so the stage is empty between turns. The one exception is the /clawd command, which brings Clawd out for a few seconds to react and then lets it leave again.
- Does talking to Clawd with /clawd cost anything?
- Actions such as /clawd pet, feed, wave, dance and shift are free and instant, with no model call. Any other text is sent to the haiku model through $.model.complete, one small call per message, on your usage. The answer appears only in Clawd's bubble and is not written to the transcript.
- Does the mod send my prompts or code anywhere?
- Not by itself. Its only network requests are two GitHub reads for the update notice. The text you type after /clawd, up to 500 characters, goes to Haiku through Claude Code, together with a one-line status of what the spinner says and which tool is running. Your conversation with Claude is not sent.
- How do I turn the update notice off?
- There is no setting for it. Once a session the mod fetches plugin.json from the main branch on GitHub and shows a toast if the version there is newer. Offline, or when the fetch is refused, it stays silent. To remove the check, run /plugin disable clawd-actor.
- Why does Clawd not show up for me?
- The stage is drawn in the AbovePrompt band, so it needs a terminal session with the mod interface. The VS Code chat panel, claude -p and cloud sessions draw none. Another band mod that answers without calling next(e) can also hide everything beneath it, and the band needs enough free rows for the stage.
# Related mods
Claudinho
Live football scores above the Claude Code prompt, with goal toasts, a goal celebration and a match pane.
- above-prompt
- pane
- toast
- Reads files
- Runs commands
- Reads your prompts
- Changes the UI
- Adds commands/tools
tested with v2.1.303
FeaturedMindful Claude Breathing
Guided breathing animation above the Claude Code prompt while Claude works; the spinner counts the breath with you.
- above-prompt
- spinner
- Changes the UI
- Adds commands/tools
- Stores data
tested with v2.1.291
Featuredcc-arcade Games Above the Prompt
Snake, Tetris, Doom, 2048 and more games above the Claude Code prompt, plus a pet fed by Claude's work.
- above-prompt
- toast
- Intercepts tool calls
- Changes the UI
- Adds commands/tools
- Stores data
tested with v2.1.291
More in Timers, todos, standups, Slash commands.