claudeers.
// Claude Plugins

rainbow-spinner

A Claude Code mod that draws the spinner line in colour styles switched with /spinner

// Claude Plugins[ cli ][ api ][ claude ]#claude#plugins◷ MIT$open-sourceupdated 6 days ago

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 rainbow-spinner (claude-plugin project) into my current project.
Found on https://claudeers.com/rainbow-spinner
Repo: https://github.com/Wizard1209/rainbow-spinner
Homepage/docs: https://wizard1209.github.io/rainbow-spinner/
Detected install method: claude-plugin → /plugin install rainbow-spinner@Wizard1209/rainbow-spinner
Category: plugins. Platforms: cli, api.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)

⚠ Unverified / not recently updated — review before pasting a run-this config.

/plugin marketplace add Wizard1209/rainbow-spinner
/plugin install rainbow-spinner@Wizard1209/rainbow-spinner
// or clone
git clone https://github.com/Wizard1209/rainbow-spinner

// compatibility

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

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

Tokens of Claude Opus and Fable spent on building this mod: 29M in, cache reads not counted, and 8M out Pull requests are welcome

rainbow-spinner

A Claude Code mod that draws the spinner line, the working indicator under the chat, in colour styles switched with /spinner.

A kitty window: Claude Code starts, the mod is installed, and each style is switched on in turn while Claude works

Install

In a Claude Code session:

/plugin install rainbow-spinner --marketplace Wizard1209/rainbow-spinner

Claude Code asks to confirm the marketplace and the install scope; /spinner is there at once, without a restart. claude plugin install takes the same arguments in a shell.

# update, then restart Claude Code
claude plugin marketplace update rainbow-spinner && claude plugin update rainbow-spinner

# remove; add --scope to uninstall for a project install
claude plugin uninstall rainbow-spinner && claude plugin marketplace remove rainbow-spinner

The mod uses Claude Code's function hooks, an early-access plugin API that may change between releases. It is tested with Claude Code 2.1.322.

Use

/spinner <style>
StyleThe spinner line
offClaude Code's own. The default: the mod changes nothing.
temperColoured text.
holoThe spinner's word drawn as a picture.
bloomPastel text after a growing plant icon.

/spinner alone names the style that is on and lists the styles. The choice is kept across sessions, and a /spinner given while Claude works runs when the turn ends.

Where the terminal cannot draw a style, the line is drawn as temper and the reply says why:

rainbow-spinner: spinner: holo → temper · Claude Code draws no pictures in this terminal

Where Claude can fix that, the reply is a box with the reason and what to ask Claude for:

╭──────────────────────────────────────────────────────────────────────────╮
│ The holo style is drawn as temper: iTerm2 shows pictures only in Claude  │
│ Code's fullscreen mode.                                                  │
│ Ask Claude to turn on fullscreen mode.                                   │
╰──────────────────────────────────────────────────────────────────────────╯

Styles

The colours are made for a dark background.

temper

The spinner line in the temper style

Rims of colour spread from the middle of the word. Under a rim a letter passes through the colours of tempered steel and sinks back into black.

holo

The spinner line in the holo style

The same colours in bands about two letters wide, so the colour moves inside each letter. The picture's letters are JetBrains Mono, whatever the terminal's font; a word in another script, such as Cyrillic, is drawn as temper.

bloom

The spinner line in the bloom style

A pastel rainbow flows along the line while a plant grows before the word, from seed to flower.

Terminals

temper is text and draws in any terminal. holo needs a terminal Claude Code sends pictures to, or WezTerm running the mod's WezTerm module. bloom draws its plant with the terminal's font where that has Nerd Font icons, otherwise as a picture.

Terminalholobloom plantTested
kitty 0.48 (macOS, Linux under WSLg)picturefont iconyes
iTerm2 3.7 (macOS), fullscreen modepicturefont icon if the profile font is a Nerd Font, else pictureyes
iTerm2 3.7 (macOS), main screentemperfont icon if the profile font is a Nerd Font, else temperyes
WezTerm 20240203 and nightly (macOS), nightly (Windows, WSL pane)picture with the WezTerm module, else temperfont iconyes
Ghosttypicturefont iconno
Windows Terminal, Terminal.apptempertemperno
Any other terminaltemper, or a picture if Claude Code sends onethe sameno

Rows marked yes were tested; the rest is what Claude Code's documentation and the mod's code say. Fullscreen mode is Claude Code's fullscreen renderer (/tui fullscreen); the main screen is its classic one. Inside tmux the mod tries pictures, and Claude Code sends them only with tmux's allow-passthrough and focus-events on.

Cost

CPU of the Claude Code process while Claude works, in per cent of one core (Apple M-series):

Spinner linekittyiTerm2, fullscreen mode
Claude Code's own5–62.7
temper11–126.5
holo20–2210.3

bloom costs about as much as temper. The cost is there only while Claude works, and it is the same in a hidden tab. The WezTerm module has a cost of its own: see its README.

How it works

A style is a colour field: a function from a place on the line and a time to a colour. The mod takes over Claude Code's spinner component and samples the field at each letter for text, or at each pixel column of the word for a picture, which goes to the terminal as PNG frames swapped in place.

The architecture page shows it in diagrams.

Development

claude --plugin-dir .                           # a session with the mod from this folder
claude plugin test .                            # tests
npx -y -p [email protected] tsc -p . --noEmit    # type-check
claude plugin validate .                        # manifests and hooks
lua tests/wezterm.test.lua                      # the WezTerm module, with Lua 5.4

The type-check reads Claude Code's API types from .claude-plugin/types/, which Claude Code writes when an interactive session loads the mod from this folder: run claude --plugin-dir . once. A claude -p run does not write them. types/state.d.ts, which .claude-plugin/plugin.json names, declares the type of the mod's session state. A style is one file in hooks/styles/ that exports a Style (hooks/core/style.ts), plus one entry in STYLES in hooks/styles/index.ts and its name in the tests that list the styles, tests/command.test.tsx and tests/caps.test.ts.

bench/ holds the live harness: it records what kitty and iTerm2 show of the line, frame by frame, and what that costs.

Contributing

Contributions are welcome. Two good places to start:

  • A style of your own. The style itself is one file in hooks/styles/; CONTRIBUTING.md walks through the rest.
  • A terminal marked "no" in the table above. Run the mod there and open an issue with what you see.

Licence

MIT © 2026 Wizard1209. The plant icons are from Material Design Icons (Apache-2.0) and the letters of holo from JetBrains Mono (OFL-1.1): see THIRD_PARTY.md.

// faq

What is rainbow-spinner?

A Claude Code mod that draws the spinner line in colour styles switched with /spinner. It is open-source on GitHub.

Is rainbow-spinner free to use?

rainbow-spinner is open-source under the MIT license, so it is free to use.

What category does rainbow-spinner belong to?

rainbow-spinner is listed under plugins in the Claudeers registry of Claude-compatible tools.

5 views
★ 10 stars
unclaimed
updated 6 days ago

// embed badge

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

// retro hit counter

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

// 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⟩★ 156,472[ 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,409◷ Apache-2.0[ claude ]
→ see how rainbow-spinner connects across the ecosystem