claude-spinner-verbs 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rob Howley
+
+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,121 @@
+# Claude Spinner Verbs
+
+> "Thinking..." is the most boring thing a genius could say.
+
+Customize the text that appears while Claude is working. Replace the default spinner verbs with something that has a little more personality.
+
+**Before**: "Thinking...", "Processing...", "Working..." 🥱
+
+**After**: "Paying the iron price...", "With fire and blood..." ⚔️🐉
+
+All availble themes can be viewed in [/spinner-verbs](https://github.com/robhowley/claude-spinner-verbs/tree/main/spinner-verbs)
+
+---
+
+## Pi Integration
+
+If you use [pi](https://pi.dev), install this as a pi package directly from GitHub:
+
+```shell
+pi install git:github.com/robhowley/claude-spinner-verbs
+```
+
+That's it. The extension registers automatically and picks up your configuration on the next session start.
+
+### Switching Themes with `/verbs`
+
+Change your verb list at any time during a session:
+
+```
+/verbs game-of-thrones
+/verbs doc-emrick
+/verbs (default)
+```
+
+Run `/verbs` with no argument to get an interactive picker. Use `(default)` to restore Claude's built-in spinner.
+
+### Auto-configure via `settings.json`
+
+Set your preferred theme once and forget about it. Pi checks both project-local (`.pi/settings.json`) and global (`~/.pi/agent/settings.json`) settings on session start.
+
+**Use a built-in theme by name:**
+
+```json
+{
+  "spinnerVerbs": "game-of-thrones"
+}
+```
+
+**Point to your own custom verbs file:**
+
+```json
+{
+  "spinnerVerbsFile": "~/my-verbs.json"
+}
+```
+
+The path supports three forms and is resolved relative to the `settings.json` file that contains it — not relative to your working directory:
+
+| Form | Example | Resolved as |
+|------|---------|-------------|
+| `~/...` | `~/my-verbs.json` | Expanded from your home directory |
+| `/absolute/...` | `/etc/my-verbs.json` | Used as-is |
+| `relative/...` | `../my-verbs.json` | Relative to the `settings.json` file's directory |
+
+So if your `.pi/settings.json` contains `"spinnerVerbsFile": "../my-verbs.json"`, it resolves to `my-verbs.json` in the project root — not wherever you launched pi from.
+
+Your custom file can be a plain JSON array:
+
+```json
+["Brewing coffee...", "Asking the oracle...", "Consulting the void..."]
+```
+
+**Priority order**: `--verbs` CLI flag → project `.pi/settings.json` → global `~/.pi/agent/settings.json`
+
+---
+
+## Claude Code Integration
+
+### Quick Start
+
+Install any theme with a single command:
+
+```shell
+curl -sL https://raw.githubusercontent.com/robhowley/claude-spinner-verbs/main/update-spinner-verbs.sh | bash -s game-of-thrones
+```
+
+Replace `game-of-thrones` with any theme name from the [`/spinner-verbs`](./spinner-verbs) directory.
+
+### How It Works
+
+The script will:
+- Download the specified theme
+- Create `.claude/settings.json` if it doesn't exist
+- Merge the spinner verbs into your existing settings
+
+### Manual Installation
+
+Edit your Claude settings file directly:
+
+```
+~/.claude/settings.json            # global
+[project-root]/.claude/settings.json  # project-specific
+```
+
+Add the spinner verbs configuration:
+
+```json
+{
+  "spinnerVerbs": {
+    "mode": "replace",
+    "verbs": [
+      "Paying the iron price...",
+      "What is dead may never die..."
+    ]
+  }
+}
+```
+
+**Modes**:
+- `"replace"` — swap out the defaults entirely
+- `"append"` — add your verbs alongside the defaults

package/extensions/spinner-verbs.ts

@@ -0,0 +1,121 @@
+import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
+import { readdirSync, readFileSync, existsSync } from "node:fs";
+import { join, dirname, basename } from "node:path";
+import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
+
+export default function (pi: ExtensionAPI) {
+  const dir = dirname(fileURLToPath(import.meta.url));
+  const verbsDir = join(dir, "..", "spinner-verbs");
+
+  const available = readdirSync(verbsDir)
+    .filter((f) => f.endsWith(".json"))
+    .map((f) => basename(f, ".json"));
+
+  const DEFAULT = "(default)";
+  const availableWithDefault = [...available, DEFAULT];
+
+  function loadVerbs(name: string): string[] {
+    const data = JSON.parse(readFileSync(join(verbsDir, `${name}.json`), "utf-8"));
+    return data?.spinnerVerbs?.verbs ?? data;
+  }
+
+  pi.registerFlag("verbs", {
+    description: `Spinner verb list (${available.join(", ")})`,
+    type: "string",
+    default: "(default)",
+  });
+
+  let interval: ReturnType<typeof setInterval> | undefined;
+
+  function activate(verbs: string[], ctx: ExtensionContext) {
+    clearInterval(interval);
+    const pick = () => verbs[Math.floor(Math.random() * verbs.length)];
+    ctx.ui.setWorkingMessage(`${pick()}...`);
+    interval = setInterval(() => ctx.ui.setWorkingMessage(`${pick()}...`), 3000);
+  }
+
+  function readSettings(settingsPath: string): Record<string, unknown> | undefined {
+    if (!existsSync(settingsPath)) return undefined;
+    try {
+      return JSON.parse(readFileSync(settingsPath, "utf-8"));
+    } catch {
+      return undefined;
+    }
+  }
+
+  function resolveVerbs(settingsPath: string): string[] | undefined {
+    const settings = readSettings(settingsPath);
+    if (!settings) return undefined;
+
+    const named = settings.spinnerVerbs;
+    if (typeof named === "string" && available.includes(named)) {
+      return loadVerbs(named);
+    }
+
+    const filePath = settings.spinnerVerbsFile;
+    if (typeof filePath === "string") {
+      const resolved = filePath.startsWith("~")
+        ? join(homedir(), filePath.slice(1))
+        : filePath.startsWith("/")
+        ? filePath
+        : join(dirname(settingsPath), filePath);
+      if (existsSync(resolved)) {
+        try {
+          const data = JSON.parse(readFileSync(resolved, "utf-8"));
+          const verbs = data?.spinnerVerbs?.verbs ?? data;
+          if (Array.isArray(verbs) && verbs.length > 0) return verbs;
+        } catch {}
+      }
+    }
+
+    return undefined;
+  }
+
+  pi.on("session_start", async (_event, ctx) => {
+    const flag = pi.getFlag("--verbs") as string;
+    const projectSettings = join(ctx.cwd, ".pi", "settings.json");
+    const globalSettings = join(homedir(), ".pi", "agent", "settings.json");
+
+    let verbs: string[] | undefined;
+
+    if (flag && flag !== "(default)" && available.includes(flag)) {
+      verbs = loadVerbs(flag);
+    }
+
+    verbs ??= resolveVerbs(projectSettings) ?? resolveVerbs(globalSettings);
+
+    if (verbs) activate(verbs, ctx);
+  });
+
+  pi.registerCommand("verbs", {
+    description: "Choose spinner verb list",
+    getArgumentCompletions: (prefix: string) => {
+      const matches = availableWithDefault
+        .filter((v) => v.startsWith(prefix))
+        .map((v) => ({ value: v, label: v }));
+      return matches.length > 0 ? matches : null;
+    },
+    handler: async (args, ctx) => {
+      const arg = args?.trim();
+      if (arg && arg !== DEFAULT && !available.includes(arg)) {
+        ctx.ui.notify(`Unknown verb list: ${arg}. Available: ${availableWithDefault.join(", ")}`, "error");
+        return;
+      }
+      const choice = arg || await ctx.ui.select("Spinner verbs:", availableWithDefault);
+      if (!choice) return;
+      if (choice === DEFAULT) {
+        clearInterval(interval);
+        ctx.ui.setWorkingMessage();
+        ctx.ui.notify("Restored default spinner", "info");
+      } else {
+        activate(loadVerbs(choice), ctx);
+        ctx.ui.notify(`Spinner: ${choice}`, "info");
+      }
+    },
+  });
+
+  pi.on("session_shutdown", () => {
+    clearInterval(interval);
+  });
+}

package/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "claude-spinner-verbs",
+  "version": "1.0.0",
+  "keywords": ["pi-package"],
+  "pi": {
+    "extensions": ["./extensions"]
+  }
+}

package/spinner-verbs/action-movie.json

@@ -0,0 +1,21 @@
+{
+  "spinnerVerbs": {
+    "verbs": [
+      "Yippee-ki-yay",
+      "I\u2019ll be back",
+      "Hasta la vista, baby",
+      "Get to the chopper",
+      "Say hello to my little friend",
+      "Go ahead, make my day",
+      "Welcome to the party, pal",
+      "I have a particular set of skills",
+      "If it bleeds, we can kill it",
+      "This is Sparta",
+      "Witness me",
+      "Shaken, not stirred",
+      "Come with me if you want to live",
+      "I know kung fu",
+      "Dodge this"
+    ]
+  }
+}

package/spinner-verbs/doc-emrick.json

@@ -0,0 +1,57 @@
+{
+  "spinnerVerbs": {
+    "mode": "replace",
+    "verbs": [
+      "Shunting",
+      "Sliding",
+      "Fiddling",
+      "Rattling",
+      "Forking",
+      "Shoveling",
+      "Chipping",
+      "Poking",
+      "Jamming",
+      "Ricocheting",
+      "Knifing",
+      "Tapping",
+      "Skipping",
+      "Banking",
+      "Throwing",
+      "Punching",
+      "Pushing",
+      "Flipping",
+      "Dragging",
+      "Soccering",
+      "Passing",
+      "Dandling",
+      "Firing",
+      "Slashing",
+      "Sheathing",
+      "Steering",
+      "Scoring",
+      "Leading",
+      "Rifling",
+      "Careening",
+      "Directing",
+      "Hoisting",
+      "Pitching",
+      "Popping",
+      "Swatting",
+      "Finessing",
+      "Wanding",
+      "Banging",
+      "Handing",
+      "Forcing",
+      "Swiping",
+      "Plunging",
+      "Lobbing",
+      "Nudging",
+      "Jabbing",
+      "Dribbling",
+      "Brushing",
+      "Weaving",
+      "Squibbing",
+      "Stashing"
+    ]
+  }
+}

package/spinner-verbs/game-of-thrones.json

@@ -0,0 +1,69 @@
+{
+  "spinnerVerbs": {
+    "mode": "replace",
+    "verbs": [
+      "Taking the black",
+      "Saying the words",
+      "Swearing the oath",
+      "My watch begins",
+      "Standing the watch",
+      "Holding the Wall",
+      "Manning the Wall",
+      "Guarding the realms of men",
+      "Going ranging",
+      "Sending a raven",
+      "Lighting the beacon",
+      "Sealing the gates",
+      "Paying the iron price",
+      "What is dead may never die",
+      "Rising again, harder and stronger",
+      "Going reaving",
+      "Calling the kingsmoot",
+      "Crowning a king",
+      "Bending the knee",
+      "Swearing fealty",
+      "Before gods and men",
+      "Calling the banners",
+      "Holding court",
+      "Taking counsel",
+      "Passing judgment",
+      "Rendering the king's justice",
+      "Naming an heir",
+      "Naming a Hand",
+      "Sitting the Iron Throne",
+      "Stripping lands and titles",
+      "Sending to the Wall",
+      "Winter is coming",
+      "The North remembers",
+      "The King in the North",
+      "Dracarys",
+      "Blood of my blood",
+      "Breaking the wheel",
+      "With fire and blood",
+      "Claiming a dragon",
+      "Stallion who mounts the world",
+      "Words are wind",
+      "The night is dark and full of terrors",
+      "Valar Morghulis",
+      "Valar Dohaeris",
+      "A Lannister always pays his debts",
+      "For the good of the realm",
+      "Chaos is a ladder",
+      "Ours is the fury",
+      "Growing Strong",
+      "Hear Me Roar",
+      "As High as Honor",
+      "Unbowed, Unbent, Unbroken",
+      "Family, duty, honor",
+      "By the old gods and the new",
+      "By your leave",
+      "Bread and salt",
+      "Trial by combat",
+      "We do not sow",
+      "Night gathers",
+      "I pledge my life and honor",
+      "For this night and all the nights to come",
+      "Khaleesi commands"
+    ]
+  }
+}

package/spinner-verbs/game-show.json

@@ -0,0 +1,26 @@
+{
+  "spinnerVerbs": {
+    "verbs": [
+      "Come on down",
+      "Survey says",
+      "Is that your final answer",
+      "Show me the money",
+      "Big money no whammies",
+      "Spin the wheel",
+      "Let\u2019s make a deal",
+      "You are the weakest link",
+      "The tribe has spoken",
+      "Deal or no deal",
+      "Lock it in",
+      "Phone a friend",
+      "Ask the audience",
+      "Press your luck",
+      "Higher or lower",
+      "Pass or play",
+      "Top answer on the board",
+      "The envelope please",
+      "The moment of truth",
+      "Jackpot"
+    ]
+  }
+}

package/spinner-verbs/lord-of-the-rings.json

@@ -0,0 +1,23 @@
+{
+  "spinnerVerbs": {
+    "verbs": [
+      "One does not simply",
+      "You shall not pass",
+      "So it begins",
+      "The beacons are lit",
+      "Gondor calls for aid",
+      "And Rohan will answer",
+      "A wizard is never late",
+      "The board is set",
+      "The pieces are moving",
+      "A red sun rises",
+      "The road goes ever on",
+      "For Frodo",
+      "My precious",
+      "All we have to decide",
+      "This day we fight",
+      "Boil \u2019em, mash \u2019em, stick \u2019em in a stew",
+      "Looks like meat\u2019s back on the menu, boys"
+    ]
+  }
+}

package/spinner-verbs/momentum.json

@@ -0,0 +1,21 @@
+{
+  "spinnerVerbs": {
+    "verbs": [
+      "Making moves\u2026",
+      "Spinning up\u2026",
+      "Getting traction\u2026",
+      "Lighting the fuse\u2026",
+      "Cranking up\u2026",
+      "Getting the ball rolling\u2026",
+      "Kicking things off\u2026",
+      "Setting things in motion\u2026",
+      "Rolling out\u2026",
+      "Booting up\u2026",
+      "Firing it up\u2026",
+      "Taking shape\u2026",
+      "In motion\u2026",
+      "Coming together\u2026",
+      "Making it happen\u2026"
+    ]
+  }
+}