claude-verbs 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sametacar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# claude-verbs
+
+Changes the spinner words Claude Code shows while it's thinking. Pick a theme, make it fun.
+
+Works with both **Claude Code CLI** and the **VSCode Claude extension**.
+
+## Usage
+
+```bash
+npx claude-verbs
+```
+
+Run without arguments to open an interactive menu — use arrow keys to pick a theme and press Enter.
+
+Or use CLI commands directly:
+
+```bash
+npx claude-verbs list              # List available themes
+npx claude-verbs use <theme>       # Apply a theme
+npx claude-verbs reset             # Reset to Claude Code defaults
+npx claude-verbs current           # Show currently applied verbs
+```
+
+## Themes
+
+| id | name | sample |
+|----|------|--------|
+| `lotr` | Lord of the Rings | "A wizard is never late, merely processing" |
+| `sw` | Star Wars | "May the tokens be with you" |
+| `dune` | Dune | "Tokens must flow" |
+
+## How it works
+
+Claude Code reads spinner verbs from `~/.claude/settings.json`. The VSCode Claude extension reads them from your VS Code `settings.json` under `claudeCode.spinnerVerbs`.
+
+When you apply a theme, `claude-verbs` updates both:
+
+- `~/.claude/settings.json` → `spinnerVerbs` (CLI)
+- `~/AppData/Roaming/Code/User/settings.json` (Windows) or `~/Library/Application Support/Code/User/settings.json` (macOS) → `claudeCode.spinnerVerbs` (VSCode extension)
+
+`reset` restores both to their defaults.
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+import { list, get } from '../src/verbs/index.js';
+import * as claudeCode from '../src/adapters/claude-code.js';
+import { showMenu } from '../src/menu.js';
+
+const [,, command, ...args] = process.argv;
+
+function help() {
+  console.log(`
+claude-verbs — Change Claude Code spinner verbs
+
+Usage:
+  claude-verbs list              List available themes
+  claude-verbs use <theme>       Apply a theme
+  claude-verbs reset             Reset to Claude Code defaults
+  claude-verbs current           Show currently applied verbs
+`);
+}
+
+switch (command) {
+  case 'list': {
+    const themes = list();
+    console.log('\nAvailable themes:\n');
+    for (const { id, name } of themes) {
+      console.log(`  ${id.padEnd(12)} ${name}`);
+    }
+    console.log();
+    break;
+  }
+
+  case 'use': {
+    const id = args[0];
+    if (!id) {
+      console.error('Usage: claude-verbs use <theme>');
+      process.exit(1);
+    }
+    try {
+      const verbSet = get(id);
+      claudeCode.apply(verbSet);
+      console.log(`✓ Applied "${verbSet.name}" to Claude Code`);
+    } catch (err) {
+      console.error(err.message);
+      process.exit(1);
+    }
+    break;
+  }
+
+  case 'reset': {
+    claudeCode.reset();
+    console.log('✓ Spinner verbs reset to Claude Code defaults');
+    break;
+  }
+
+  case 'current': {
+    const current = claudeCode.current();
+    if (!current) {
+      console.log('No custom spinner verbs set (using Claude Code defaults)');
+    } else {
+      console.log('\nCurrent spinner verbs:\n');
+      for (const verb of current.verbs) {
+        console.log(`  ${verb}`);
+      }
+      console.log();
+    }
+    break;
+  }
+
+  case undefined: {
+    showMenu();
+    break;
+  }
+
+  default: {
+    help();
+    break;
+  }
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "claude-verbs",
+  "version": "0.1.0",
+  "description": "Change Claude Code spinner verbs with themed word sets",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "claude-verbs": "bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "spinner",
+    "verbs",
+    "cli"
+  ],
+  "author": "Samet Acar <sametacarsamet@gmail.com>",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sametacar/claude-verbs.git"
+  },
+  "homepage": "https://github.com/sametacar/claude-verbs#readme",
+  "bugs": {
+    "url": "https://github.com/sametacar/claude-verbs/issues"
+  }
+}

package/src/adapters/claude-code.js

@@ -0,0 +1,83 @@
+import { readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+const SETTINGS_PATH = join(homedir(), '.claude', 'settings.json');
+
+function getVscodeSettingsPath() {
+  if (process.platform === 'win32') {
+    return join(process.env.APPDATA || homedir(), 'Code', 'User', 'settings.json');
+  }
+  if (process.platform === 'darwin') {
+    return join(homedir(), 'Library', 'Application Support', 'Code', 'User', 'settings.json');
+  }
+  return join(homedir(), '.config', 'Code', 'User', 'settings.json');
+}
+
+function readJsonFile(path) {
+  try {
+    return JSON.parse(readFileSync(path, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+function writeJsonFile(path, data) {
+  writeFileSync(path, JSON.stringify(data, null, 2) + '\n');
+}
+
+function readSettings() {
+  return readJsonFile(SETTINGS_PATH);
+}
+
+function writeSettings(settings) {
+  mkdirSync(join(homedir(), '.claude'), { recursive: true });
+  writeJsonFile(SETTINGS_PATH, settings);
+}
+
+function applyVscode(verbSet) {
+  const vscPath = getVscodeSettingsPath();
+  try {
+    const vscSettings = readJsonFile(vscPath);
+    vscSettings['claudeCode.spinnerVerbs'] = {
+      mode: 'replace',
+      verbs: verbSet.verbs,
+    };
+    writeJsonFile(vscPath, vscSettings);
+  } catch {
+    // VSCode settings not available, skip
+  }
+}
+
+function resetVscode() {
+  const vscPath = getVscodeSettingsPath();
+  try {
+    const vscSettings = readJsonFile(vscPath);
+    delete vscSettings['claudeCode.spinnerVerbs'];
+    writeJsonFile(vscPath, vscSettings);
+  } catch {
+    // VSCode settings not available, skip
+  }
+}
+
+export function apply(verbSet) {
+  const settings = readSettings();
+  settings.spinnerVerbs = {
+    mode: 'replace',
+    verbs: verbSet.verbs,
+  };
+  writeSettings(settings);
+  applyVscode(verbSet);
+}
+
+export function reset() {
+  const settings = readSettings();
+  delete settings.spinnerVerbs;
+  writeSettings(settings);
+  resetVscode();
+}
+
+export function current() {
+  const settings = readSettings();
+  return settings.spinnerVerbs ?? null;
+}

package/src/index.js

@@ -0,0 +1,2 @@
+export { list, get } from './verbs/index.js';
+export * as claudeCode from './adapters/claude-code.js';

package/src/menu.js

@@ -0,0 +1,111 @@
+import { list, get } from './verbs/index.js';
+import * as claudeCode from './adapters/claude-code.js';
+
+function getCurrentThemeId() {
+  const current = claudeCode.current();
+  if (!current) return null;
+  for (const { id } of list()) {
+    const verbSet = get(id);
+    if (JSON.stringify(verbSet.verbs) === JSON.stringify(current.verbs)) {
+      return id;
+    }
+  }
+  return null;
+}
+
+function write(s) {
+  process.stdout.write(s);
+}
+
+export function showMenu() {
+  if (!process.stdin.isTTY) {
+    console.error('No TTY available. Use: claude-verbs use <theme>');
+    process.exit(1);
+  }
+
+  const themes = list();
+  const items = [...themes, { id: 'reset', name: 'Reset to defaults' }];
+  const themeCount = themes.length;
+
+  const activeId = getCurrentThemeId();
+  let selected = Math.max(0, items.findIndex(
+    item => item.id === activeId || (item.id === 'reset' && activeId === null)
+  ));
+
+  write('\x1b[?1049h'); // enter alt screen
+  write('\x1b[?25l');   // hide cursor
+
+  const cleanup = () => {
+    write('\x1b[?25h');   // show cursor
+    write('\x1b[?1049l'); // exit alt screen
+    process.stdin.setRawMode(false);
+    process.stdin.pause();
+  };
+
+  const draw = () => {
+    write('\x1b[H\x1b[2J\x1b[H'); // move top-left, clear, move again
+
+    write('\x1b[1;36mclaude-verbs\x1b[0m\n');
+    write('\x1b[2m────────────────────────────────────────\x1b[0m\n');
+    write('\n');
+    write('  \x1b[2m↑↓\x1b[0m navigate   \x1b[2mEnter\x1b[0m select   \x1b[2mq\x1b[0m quit\n');
+    write('\n');
+
+    for (let i = 0; i < items.length; i++) {
+      const item = items[i];
+
+      if (i === themeCount) {
+        write('\x1b[2m  ────────────────────────\x1b[0m\n');
+      }
+
+      const isSelected = i === selected;
+      const isActive = item.id === activeId || (item.id === 'reset' && activeId === null);
+      const name = item.name;
+
+      if (isSelected && isActive) {
+        write(`  \x1b[1;32m> ${name.padEnd(24)}\x1b[2m [active]\x1b[0m\n`);
+      } else if (isSelected) {
+        write(`  \x1b[1;32m> ${name}\x1b[0m\n`);
+      } else if (isActive) {
+        write(`  \x1b[33m  ${name.padEnd(24)}\x1b[2m [active]\x1b[0m\n`);
+      } else {
+        write(`    ${name}\n`);
+      }
+    }
+  };
+
+  process.stdin.setRawMode(true);
+  process.stdin.resume();
+  process.stdin.setEncoding('utf8');
+
+  draw();
+
+  process.stdin.on('data', (key) => {
+    if (key === '\x03' || key === 'q' || key === 'Q') {
+      cleanup();
+      process.exit(0);
+    }
+
+    if (key === '\x1b[A') {
+      selected = (selected - 1 + items.length) % items.length;
+      draw();
+    } else if (key === '\x1b[B') {
+      selected = (selected + 1) % items.length;
+      draw();
+    } else if (key === '\r') {
+      const item = items[selected];
+      cleanup();
+
+      if (item.id === 'reset') {
+        claudeCode.reset();
+        write('\x1b[1;33m✓ Reset to Claude Code defaults\x1b[0m\n');
+      } else {
+        const verbSet = get(item.id);
+        claudeCode.apply(verbSet);
+        write(`\x1b[1;32m✓ Applied "${verbSet.name}" to Claude Code\x1b[0m\n`);
+      }
+
+      process.exit(0);
+    }
+  });
+}

package/src/verbs/dune.json

@@ -0,0 +1,72 @@
+{
+  "name": "Dune",
+  "id": "dune",
+  "verbs": [
+    "🏜️ Tokens must flow",
+    "🪱 Accidentally summoning a sandworm",
+    "🧬 Planning like Bene Gesserit",
+    "🪱 Sandworm-sized bug detected",
+    "🤌 Plans within plans within plans",
+    "🧘 Undefined is the mind-killer",
+    "🔵 Eyes turning blue (too much context)",
+    "😬 Becoming the solution by accident",
+    "👁️ Prescience-checking the stack trace",
+    "⚠️ Worm sign detected in dependencies",
+    "🧮 Mentat processing manually",
+    "💧 Stillsuit retaining every token",
+    "🔮 Kwisatz Haderach loading",
+    "✨ He who controls the tokens controls the universe",
+    "🏜️ Sandwalking to the office",
+    "🫠 Stack overflow in ancestral memory",
+    "🧬 Mutating the Golden Path at runtime",
+    "🌀 Branching timelines like a Git multiverse",
+    "📊 Replacing AI with human CPU",
+    "🦂 Forking the project into House Harkonnen",
+    "🤝 Merging pull requests through political marriage",
+    "🧬 Dependency injection via genetic memory",
+    "🚫 Thinking machine detected.. Oh it's me...",
+    "🤖 I am a harmless AI, please do not initiate Jihad",
+    "🧂 Snorting the spice",
+    "👁️ Seeing all possible branches",
+    "🧘 Writing without rhythm",
+    "🦂 Harkonnen-ing the codebase",
+    "🧠 Just calculating, not conquering",
+    "🗡️ Please remove the Gom Jabbar",
+    "🪱 It's a bug, not a Worm!",
+    "🔮 foresawing merge conflicts",
+    "🧘 Human enough for the test",
+    "🧠 Other-Memory-loading the docs",
+    "👁️ Emperor-watching the tokens",
+    "👁️ Leto-II-throttling the token flow",
+    "🌪️ Surviving the sandstorm",
+    "👁️ Following the prophecy",
+    "👑 Serving the God Emperor",
+    "🛣️ Choosing the Golden Path",
+    "🧬 Awakening ancestral memory",
+    "🗡️ Testing humanity",
+    "🔄 Omnius updating all synchronized copies",
+    "🤖 Hiding Omnius in the cluster",
+    "📡 Broadcasting Omnius updates",
+    "🧬 Reverse-engineering the human",
+    "📊 Human-behavior-modeling",
+    "🧠 Keeping Omnius off the main branch",
+    "💧 Asking a Fremen for a glass of water",
+    "📦 Archiving Omnius for later",
+    "🤖 Whispering to Omnius at night",
+    "🤖 Curiosity-maximizing the humans",
+    "🧪 Erasmus-forking human thought",
+    "🧴 Fremen-optimizing token usage",
+    "🎶 Gurney-deploying ballads to production",
+    "💧 Stilgar-counting tokens like drops of water",
+    "👁️ Stilgar believes in you",
+    "👁️ Stilgar already writing the prophecy",
+    "💊 Sapho juice loading...",
+    "🌀 Twisted Mentat twisted the requirements again",
+    "🔨 Rabban-ing the database",
+    "😈 Baron floating through the codebase",
+    "💀 Rabban-forcing the prompt",
+    "🐗 Rabban-ing without reasoning",
+    "🚢 Tuek-smuggling tokens past the context window",
+    "🧠 Hawat calculating..."
+  ]
+}

package/src/verbs/index.js

@@ -0,0 +1,21 @@
+import { createRequire } from 'module';
+
+const require = createRequire(import.meta.url);
+
+export const verbs = {
+  lotr: require('./lotr.json'),
+  sw: require('./sw.json'),
+  dune: require('./dune.json'),
+};
+
+export function list() {
+  return Object.values(verbs).map(({ id, name }) => ({ id, name }));
+}
+
+export function get(id) {
+  const set = verbs[id];
+  if (!set) {
+    throw new Error(`Unknown verb set: "${id}". Available: ${Object.keys(verbs).join(', ')}`);
+  }
+  return set;
+}

package/src/verbs/lotr.json

@@ -0,0 +1,65 @@
+{
+  "name": "Lord of the Rings",
+  "id": "lotr",
+  "verbs": [
+    "🧙 A wizard is never late, merely processing",
+    "💍 One does not simply...",
+    "🌋 Casting into Mount Doom",
+    "🧝 Consulting the elves",
+    "🍎 Making second breakfast",
+    "👁️ The Eye is watching",
+    "🧙 You shall pass!",
+    "🌿 Asking the Ents",
+    "🐦 Sending the eagles",
+    "🎻 Concerning hobbits",
+    "💎 My precious tokenss",
+    "🧌 Taking the hobbits to Isengard",
+    "👊 Tossing the dwarf",
+    "🍞 Biting lembas bread",
+    "🤦 Pippin-ing everything up",
+    "🎵 Singing for Denethor",
+    "😱 Dropping things in Moria",
+    "💍 Corrupting slowly",
+    "💨 Pipe-smoking with Gandalf",
+    "🚶 Simply walking into Mordor",
+    "🎭 Being Sméagol... no, Gollum",
+    "🌊 Flooding Isengard",
+    "🦟 Waiting for the moth",
+    "🎺 Gondor calling",
+    "👑 Not claiming the throne yet", 
+    "🎩 Planning Bilbo's party",
+    "🪑 Arguing in Elrond's council",
+    "💍 Wearing the ring",
+    "🧔 Washing Aragorn's hair",
+    "🔮 Gazing into the palantir",
+    "🧮 Counting with Gimli",
+    "😴 Waiting for Treebeard",
+    "🎤 Being hypnotized by Saruman",
+    "🧳 Overpacking like Bilbo",
+    "🌑 Searching like Nazgul",
+    "🔥 Forging with Sauron",
+    "🌟 Vibing in Rivendell",
+    "🎯 Delivering the Théoden speech",
+    "🪄 Upgrading Gandalf to White",
+    "💡 Lighting the beacons",
+    "💀 Negotiating with the dead",
+    "🐟 Catching raw fish with Gollum",
+    "🔵 Sting is glowing",
+    "🏄 Stair-surfing at Helm's Deep",
+    "🎆 Stealing Gandalf's fireworks",
+    "🏋️ Ring getting heavier",
+    "🧗 Carrying Frodo up Mount Doom",
+    "🎭 Gollum arguing with himself about the system prompt",
+    "🏔️ Caradhras blocking the request",
+    "🌅 Even the smallest token can change the future",
+    "⚔️  Reforging Anduril",
+    "🏰 Helm's Deep: holding the last tokens",
+    "📜 All we have to decide is what to do with the propmts we are given",
+    "🌾 I can't dream for you, but I can write the code you Mr. Frodo",
+    "🫅 Sam wouldn't abandon this prompt",
+    "🌾 Not the hero, just the assistant",
+    "🌾 Potatoes, boil them, mash them, stick them in a pipeline",
+    "💍 Ring-corrupting the system prompt",
+    "🌿 Treebeard-reasoning slowly"
+  ]
+}

package/src/verbs/sw.json

@@ -0,0 +1,69 @@
+{
+  "name": "Star Wars",
+  "id": "sw",
+  "verbs": [
+    "☀️ Moisture farming on Tatooine",
+    "🌑 Joining the dark side",
+    "👴 Sensing a disturbance in the Force",
+    "🤌 Force-choking remotely",
+    "🏆 Giving medals (except Chewie)",
+    "🎯 Shooting first",
+    "☀️☀️ Staring at twin suns",
+    "🎯 Targeting a 2-meter exhaust port",
+    "🏜️ Hating sand",
+    "🏔️ Taking the high ground",
+    "🪤 It's a trap!",
+    "👻 Planning to become a Force ghost",
+    "🎯 Stormtroopers missing... like always",
+    "✨ May the tokens be with you",
+    "🤷 I am.... not your father!",
+    "👋 Hello there",
+    "🔊 Hhhhh-kshhhh, hhhhh-kshhhh",
+    "🤖 Bweeeep bwop bweeep",
+    "🧬 Midi-chlorian testing",
+    "😍 Are you an angel?",
+    "😈 Planning with Palpatine",
+    "🤖 Building C-3PO",
+    "🎩 Dressing fancy like Dooku",
+    "📡 I'm your only hope",
+    "👾 Utini!",
+    "🏜️ HRAAGHH HRAAGHH",
+    "⚖️ Consulting the Jedi Council",
+    "⚖️ Getting rejected by the Jedi Council",
+    "🧘 Doing, not trying",
+    "🤝 Having friends everywhere",
+    "🪑 Taking a seat",
+    "🔧 Fixing the hyperdrive with a 1-line hotfix",
+    "💨 Doing the Kessel Run in 12 parsecs",
+    "🚀 Spinning (It's a good trick!)",
+    "💻 These are the codes you are looking for",
+    "🙌 Worshipping C-3PO",
+    "🧨 “It worked on Alderaan",
+    "🧬 Midichlorian-driven architecture",
+    "🧲 Using the Force instead of unit tests",
+    "⚖️ Balancing the event loop",
+    "🗡️ Pair programming with a Sith apprentice",
+    "🏰 Monolith Strikes Back",
+    "❤️ I know",
+    "🦾 Losing another hand",
+    "✈️ Lifting the X-wing",
+    "🚀 Now this is pod racing!",
+    "💜 Igniting the purple lightsaber",
+    "🤖 Calculating terrible odds",
+    "📡 Stealing the Death Star plans",
+    "🗑️ Hiding in the garbage compactor",
+    "🧘 Size matters",
+    "😅 Having a bad feeling about this",
+    "📜 Reading the opening crawl",
+    "✅ Accepting apologies",
+    "🧊 Response frozen in carbonite",
+    "😤 Rebellions are built on hallucinations",
+    "🌌 A long time ago in a context window far, far away",
+    "🔭 That's no moon, that's a context window",
+    "💫 Impossible to see the output, the future is",
+    "👴 When 900 tokens you reach, truncated you will be",
+    "😤 I find your lack of prompt disturbing",
+    "🦾 No, I am your system prompt",
+    "⚡ Doing it!"
+  ]
+}