tomevault-io Install Spinner
Install themed spinner verb packs for Claude Code from the awesome-claude-spinners repository.
Install a Pack
- 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.
- 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" |
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.
- Once the user picks a pack, fetch its contents from:
https://raw.githubusercontent.com/alexpl292/awesome-claude-spinners/main/spinners/<pack-name>.json
Read the user's
~/.claude/settings.jsonfile.Copy the
spinnerVerbsfield from the fetched spinner JSON into~/.claude/settings.json. If thespinnerVerbsfield already exists insettings.json, replace its value. If it doesn't exist, create it.
IMPORTANT: Do not modify any other fields in settings.json. Only change spinnerVerbs.
- 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.
Source: AlexPl292/awesome-claude-spinners — distributed by TomeVault.