alexpl292/install-spinner

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" |

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.