install-spinner

name	install-spinner
description	Install themed spinner verb packs for Claude Code. Fetches spinner packs directly from the awesome-claude-spinners repository and installs them into the user's settings. Use when the user wants to customize their Claude Code spinner, install spinner verbs, or change spinner themes.
license	MIT
metadata	{"author":"alexpl292","version":"1.0.0"}

Install Spinner

Install themed spinner verb packs for Claude Code from the awesome-claude-spinners repository.

Install a Pack

1. Fetch the list of available spinner packs from GitHub:

https://api.github.com/repos/alexpl292/awesome-claude-spinners/contents/spinners

Parse the JSON response to get the list of .json files. Extract the pack names by removing the .json extension.

2. Present the packs to the user in a table with three columns: Pack name, a short description, and a couple of example verbs. Use this reference:

Pack	Description	Examples
90s-kid	90s nostalgia	"Dialing up the internet", "Blowing into the cartridge"
blue-collar-dev	Trades & construction humor	"Hammering out code", "Duct-taping that together"
borat	Borat Sagdiyev	"Very nice! Great success-ing", "High five-ing the compiler"
cat	Cat-themed	"Knocking things off the table", "Napping on the keyboard"
chaos	Absurdist & chaotic humor	"Flipping the table", "Sacrificing a semicolon"
coffee	Coffee & food themed	"Brewing a fresh pot", "Letting it simmer"
corporate	Corporate buzzwords & jargon	"Synergizing", "Circling back"
cowboy	Wild West & frontier	"Lassoing the solution", "Riding into the sunset"
darth-vader	Star Wars' Sith Lord	"Finding your lack of tests disturbing", "Force-pushing to the remote"
detective	Noir detective style	"Following the trail", "Cracking the case"
developer	Programming & dev culture	"Deploying to prod on Friday", "Rewriting in Rust"
gardening	Gardening & growing	"Planting the seed", "Pulling the weeds"
gym-bro	Gym & fitness culture	"Crushing the set", "Going beast mode"
honest-no-filter	Brutally honest dev thoughts	"Making it worse first", "Hoping this compiles"
meme	Internet memes & viral phrases	"Yeeting the bugs", "Going sicko mode"
michael-scott	The Office's Michael Scott	"Declaring bankruptcy on the old code", "Somehow managing"
motivational	Hype & motivational phrases	"Absolutely crushing it", "Leveling up"
ninja	Ninja & stealth	"Moving through the shadows", "Striking silently"
ocean	Ocean & underwater	"Diving into the deep end", "Surfing the data waves"
philosophical	Deep thoughts & philosophy	"Pondering existence", "Contemplating the void"
pirate	Pirate speak	"Plundering the codebase", "Sailing the seven repos"
retro-gaming	Retro gaming references	"Inserting coin", "Loading save file"
sarcastic-ai	Self-aware AI humor	"Hallucinating responsibly", "Confidently guessing"
sf-entrepreneur	San Francisco tech scene	"Grabbing a Blue Bottle coffee", "Cold-emailing a16z"
shakespeare	Shakespearean & old English	"Prithee, a moment", "Once more unto the breach"
space	Space & sci-fi	"Initiating hyperdrive", "Scanning the sector"
startup	Startup culture	"Disrupting the industry", "Iterating on the MVP"
superhero	Superhero themed	"Suiting up", "Saving the day"
the-dude	Big Lebowski's The Dude	"Abiding", "Sipping a White Russian"
therapist	Therapy speak & self-care	"Holding space for the code", "Unpacking that"
time-traveler	Time travel & paradoxes	"Firing up the flux capacitor", "Rewriting the timeline"
vibecoder	Vibe coding culture	"Letting the AI cook", "Shipping on good vibes"
vim	Vim editor enthusiasts	"Exiting vim (attempting)", "Yanking the line"
walter-white	Breaking Bad's Heisenberg	"Being the one who codes", "Going full Heisenberg"
wholesome	Wholesome & cozy vibes	"Watering the plants", "Believing in you"
wizard	Fantasy & magic themed	"Casting a spell", "Consulting the ancient scrolls"
yoda	Star Wars' Jedi Master	"Reading the code, I am", "Trying not, doing"
zombie	Zombie apocalypse survival	"Reanimating dead code", "Double-tapping the bug"
bob-ross	Happy little accidents	"Adding a happy little function", "No mistakes, just features"
gordon-ramsay	Angry chef yelling at code	"This code is RAW", "WHERE'S THE ERROR HANDLING"
jack-sparrow	Chaotic pirate captain	"This is the day you almost caught a bug", "Why is the rum gone"
panicker	Pure dev anxiety	"OH NO OH NO OH NO", "Everything is on fire"
sherlock-holmes	Deductive reasoning	"Eliminating the impossible", "The game is afoot"
spanish-incantations	Programmer spells & dev humor (ES)	"Invocando daemons", "Culpando a git"
colombian-spanish	Colombian Spanish slang & regions	"Tomando tinto", "Joropeando"
rubber-duck	Rubber-duck debugging	"Explaining it to the duck", "Waiting for the duck's verdict"

If a pack exists in the fetched list but is not in this table, still show it (with no description).

Ask the user to pick one.

3. Once the user picks a pack, fetch its contents from:

https://raw.githubusercontent.com/alexpl292/awesome-claude-spinners/main/spinners/<pack-name>.json

4. Read the user's ~/.claude/settings.json file.

5. Copy the spinnerVerbs field from the fetched spinner JSON into ~/.claude/settings.json. If the spinnerVerbs field already exists in settings.json, replace its value. If it doesn't exist, create it.

IMPORTANT: Do not modify any other fields in settings.json. Only change spinnerVerbs.

6. After successful installation, print:

Spinner pack "<pack-name>" installed successfully!
No need to restart Claude Code — the new spinners are active immediately.

Remove Spinners

If the user asks to remove or reset spinners, read ~/.claude/settings.json and delete the spinnerVerbs field entirely. Do not modify any other fields. After removal, print:

Spinner pack removed. Default spinners are back.
No need to restart Claude Code — the change takes effect immediately.