@umang-boss/claudemon 1.2.0 → 1.3.0

package/README.md

@@ -24,22 +24,31 @@ fill your Pokedex -- all while you code.
 
 ## Install
 
+**Recommended (global install — persistent):**
+```bash
+npm install -g @umang-boss/claudemon
+claudemon install
+```
+
+**Or quick try (npx — may need reinstall after cache clear):**
 ```bash
 npx @umang-boss/claudemon install
 ```
 
-That's it! Start a new Claude Code session and type `/buddy`.
+Start a new Claude Code session and type `/buddy` to begin!
 
 **Requirements:** Node.js 18+ (Bun optional, auto-detected for faster startup)
 
 ### Other CLI Commands
 
 ```bash
-npx @umang-boss/claudemon doctor     # Check installation health
-npx @umang-boss/claudemon update     # Re-register after updates
-npx @umang-boss/claudemon uninstall  # Remove (preserves save data)
+claudemon doctor     # Check installation health
+claudemon update     # Re-register after updates
+claudemon uninstall  # Remove (preserves save data)
 ```
 
+> **Note:** `npm install -g` is recommended over `npx` because the MCP server path needs to persist. With `npx`, the path points to a temporary cache that may be cleaned up.
+
 ## Commands
 
 Once installed, use `/buddy` in Claude Code:

package/dist/src/server/tools/achievements.js

@@ -47,10 +47,9 @@ export function registerAchievementsTool(server) {
                 content: [
                     {
                         type: "text",
-                        text: "You don't have a Pokemon yet! Use buddy_starter to begin your journey.",
+                        text: "Welcome to Claudemon! Use buddy_starter to pick your first companion and start earning achievements!",
                     },
                 ],
-                isError: true,
             };
         }
         const unlockedIds = new Set(state.achievements.map((a) => a.achievementId));

package/dist/src/server/tools/catch.js

@@ -43,10 +43,9 @@ export function registerCatchTool(server) {
                 content: [
                     {
                         type: "text",
-                        text: "You don't have a Pokemon yet! Use buddy_starter to pick your first partner.",
+                        text: "Welcome to Claudemon! Use buddy_starter to pick your first companion before catching wild Pokemon!",
                     },
                 ],
-                isError: true,
             };
         }
         const encounter = state.pendingEncounter;
@@ -79,10 +78,9 @@ export function registerCatchTool(server) {
                 content: [
                     {
                         type: "text",
-                        text: "No active Pokemon found in your party.",
+                        text: "Welcome to Claudemon! Use buddy_starter to pick your first companion before catching wild Pokemon!",
                     },
                 ],
-                isError: true,
             };
         }
         const typeStr = formatTypes(species.types);

package/dist/src/server/tools/evolve.js

@@ -36,10 +36,9 @@ export function registerEvolveTool(server) {
                 content: [
                     {
                         type: "text",
-                        text: "You don't have a Pokemon yet! Use buddy_starter to pick your first partner.",
+                        text: "Welcome to Claudemon! Use buddy_starter to pick your first companion before evolving!",
                     },
                 ],
-                isError: true,
             };
         }
         const active = stateManager.getActivePokemon();
@@ -48,10 +47,9 @@ export function registerEvolveTool(server) {
                 content: [
                     {
                         type: "text",
-                        text: "No active Pokemon found in your party.",
+                        text: "Welcome to Claudemon! Use buddy_starter to pick your first companion before evolving!",
                     },
                 ],
-                isError: true,
             };
         }
         const species = POKEMON_BY_ID.get(active.pokemonId);

package/dist/src/server/tools/legendary.js

@@ -16,10 +16,9 @@ export function registerLegendaryTool(server) {
                 content: [
                     {
                         type: "text",
-                        text: "You don't have a Pokemon yet! Use buddy_starter to begin your journey.",
+                        text: "Welcome to Claudemon! Use buddy_starter to pick your first companion and begin your legendary quests!",
                     },
                 ],
-                isError: true,
             };
         }
         const progress = getQuestProgress(state);

package/dist/src/server/tools/party.js

@@ -20,10 +20,9 @@ export function registerPartyTool(server) {
                 content: [
                     {
                         type: "text",
-                        text: "You don't have a Pokemon yet! Use buddy_starter to pick your first partner.",
+                        text: "Welcome to Claudemon! Use buddy_starter to pick your first companion and build your party!",
                     },
                 ],
-                isError: true,
             };
         }
         const action = params.action ?? "list";

package/dist/src/server/tools/pet.js

@@ -41,10 +41,9 @@ export function registerPetTool(server) {
                 content: [
                     {
                         type: "text",
-                        text: "You don't have a Pokemon yet! Use buddy_starter to pick your first partner.",
+                        text: "Welcome to Claudemon! Use buddy_starter to pick your first companion -- then you can pet them!",
                     },
                 ],
-                isError: true,
             };
         }
         const active = stateManager.getActivePokemon();
@@ -53,10 +52,9 @@ export function registerPetTool(server) {
                 content: [
                     {
                         type: "text",
-                        text: "No active Pokemon found in your party.",
+                        text: "Welcome to Claudemon! Use buddy_starter to pick your first companion -- then you can pet them!",
                     },
                 ],
-                isError: true,
             };
         }
         const species = POKEMON_BY_ID.get(active.pokemonId);

package/dist/src/server/tools/pokedex.js

@@ -23,10 +23,9 @@ export function registerPokedexTool(server) {
                 content: [
                     {
                         type: "text",
-                        text: "You don't have a Pokemon yet! Use buddy_starter to begin your journey.",
+                        text: "Welcome to Claudemon! Use buddy_starter to pick your first companion and start filling your Pokedex!",
                     },
                 ],
-                isError: true,
             };
         }
         // ── Specific Pokemon lookup ────────────────────────────

package/dist/src/server/tools/rename.js

@@ -11,15 +11,23 @@ export function registerRenameTool(server) {
         const state = await stateManager.load();
         if (!state || state.party.length === 0) {
             return {
-                content: [{ type: "text", text: "No Pokemon to rename! Pick a starter first." }],
-                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: "Welcome to Claudemon! Use buddy_starter to pick your first companion -- then you can give them a nickname!",
+                    },
+                ],
             };
         }
         const active = stateManager.getActivePokemon();
         if (!active) {
             return {
-                content: [{ type: "text", text: "No active Pokemon found." }],
-                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: "Welcome to Claudemon! Use buddy_starter to pick your first companion -- then you can give them a nickname!",
+                    },
+                ],
             };
         }
         const species = POKEMON_BY_ID.get(active.pokemonId);

package/dist/src/server/tools/show.js

@@ -21,10 +21,9 @@ export function registerShowTool(server) {
                 content: [
                     {
                         type: "text",
-                        text: "You don't have a Pokemon yet! Use buddy_starter to pick your first partner.",
+                        text: "Welcome to Claudemon! You don't have a Pokemon yet. Use /buddy starter to pick your first companion!",
                     },
                 ],
-                isError: true,
             };
         }
         const active = stateManager.getActivePokemon();

package/dist/src/server/tools/starter.js

@@ -56,10 +56,32 @@ async function getStarters() {
     catch {
         // No saved options or expired — generate new ones
     }
-    // Generate fresh random 3
+    // Generate fresh random 3 with different primary types
     const seed = hashString(`claudemon-${Date.now()}-${Math.random()}`);
     const shuffled = seededShuffle(STARTER_POOL, seed);
-    const starters = [shuffled[0], shuffled[1], shuffled[2]];
+    const starters = [];
+    const usedTypes = new Set();
+    for (const id of shuffled) {
+        if (starters.length >= 3)
+            break;
+        const pokemon = POKEMON_BY_ID.get(id);
+        if (!pokemon)
+            continue;
+        const primaryType = pokemon.types[0];
+        if (usedTypes.has(primaryType))
+            continue;
+        usedTypes.add(primaryType);
+        starters.push(id);
+    }
+    // Fallback if not enough unique types (shouldn't happen with 39 starters)
+    if (starters.length < 3) {
+        for (const id of shuffled) {
+            if (starters.length >= 3)
+                break;
+            if (!starters.includes(id))
+                starters.push(id);
+        }
+    }
     // Save for consistency until they pick
     try {
         const { writeFile, mkdir } = await import("node:fs/promises");
@@ -99,7 +121,6 @@ export function registerStarterTool(server) {
                         text: "You already have a Pokemon partner! Use buddy_show to check on them.",
                     },
                 ],
-                isError: true,
             };
         }
         const starterIds = await getStarters();

package/dist/src/server/tools/stats.js

@@ -19,10 +19,9 @@ export function registerStatsTool(server) {
                 content: [
                     {
                         type: "text",
-                        text: "You don't have a Pokemon yet! Use buddy_starter to pick your first partner.",
+                        text: "Welcome to Claudemon! Use buddy_starter to pick your first companion and start your coding adventure!",
                     },
                 ],
-                isError: true,
             };
         }
         const active = stateManager.getActivePokemon();
@@ -31,10 +30,9 @@ export function registerStatsTool(server) {
                 content: [
                     {
                         type: "text",
-                        text: "No active Pokemon found in your party.",
+                        text: "Welcome to Claudemon! Use buddy_starter to pick your first companion and start your coding adventure!",
                     },
                 ],
-                isError: true,
             };
         }
         const species = POKEMON_BY_ID.get(active.pokemonId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umang-boss/claudemon",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Pokemon coding companion for Claude Code — Gotta code 'em all!",
   "type": "module",
   "main": "dist/src/server/index.js",
@@ -33,8 +33,7 @@
     "test": "bun test",
     "typecheck": "tsc --noEmit",
     "format": "prettier --write \"src/**/*.ts\" \"cli/**/*.ts\" \"scripts/**/*.ts\" \"tests/**/*.ts\" --ignore-unknown",
-    "format:check": "prettier --check \"src/**/*.ts\" \"cli/**/*.ts\" \"scripts/**/*.ts\" \"tests/**/*.ts\" --ignore-unknown",
-    "prepare": "husky"
+    "format:check": "prettier --check \"src/**/*.ts\" \"cli/**/*.ts\" \"scripts/**/*.ts\" \"tests/**/*.ts\" --ignore-unknown"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",

package/src/server/tools/achievements.ts

@@ -58,10 +58,9 @@ export function registerAchievementsTool(server: McpServer): void {
           content: [
             {
               type: "text" as const,
-              text: "You don't have a Pokemon yet! Use buddy_starter to begin your journey.",
+              text: "Welcome to Claudemon! Use buddy_starter to pick your first companion and start earning achievements!",
             },
           ],
-          isError: true,
         };
       }
 

package/src/server/tools/catch.ts

@@ -59,10 +59,9 @@ export function registerCatchTool(server: McpServer): void {
           content: [
             {
               type: "text" as const,
-              text: "You don't have a Pokemon yet! Use buddy_starter to pick your first partner.",
+              text: "Welcome to Claudemon! Use buddy_starter to pick your first companion before catching wild Pokemon!",
             },
           ],
-          isError: true,
         };
       }
 
@@ -98,10 +97,9 @@ export function registerCatchTool(server: McpServer): void {
           content: [
             {
               type: "text" as const,
-              text: "No active Pokemon found in your party.",
+              text: "Welcome to Claudemon! Use buddy_starter to pick your first companion before catching wild Pokemon!",
             },
           ],
-          isError: true,
         };
       }
 

package/src/server/tools/evolve.ts

@@ -51,10 +51,9 @@ export function registerEvolveTool(server: McpServer): void {
           content: [
             {
               type: "text" as const,
-              text: "You don't have a Pokemon yet! Use buddy_starter to pick your first partner.",
+              text: "Welcome to Claudemon! Use buddy_starter to pick your first companion before evolving!",
             },
           ],
-          isError: true,
         };
       }
 
@@ -64,10 +63,9 @@ export function registerEvolveTool(server: McpServer): void {
           content: [
             {
               type: "text" as const,
-              text: "No active Pokemon found in your party.",
+              text: "Welcome to Claudemon! Use buddy_starter to pick your first companion before evolving!",
             },
           ],
-          isError: true,
         };
       }
 

package/src/server/tools/legendary.ts

@@ -24,10 +24,9 @@ export function registerLegendaryTool(server: McpServer): void {
           content: [
             {
               type: "text" as const,
-              text: "You don't have a Pokemon yet! Use buddy_starter to begin your journey.",
+              text: "Welcome to Claudemon! Use buddy_starter to pick your first companion and begin your legendary quests!",
             },
           ],
-          isError: true,
         };
       }
 

package/src/server/tools/party.ts

@@ -28,10 +28,9 @@ export function registerPartyTool(server: McpServer): void {
           content: [
             {
               type: "text" as const,
-              text: "You don't have a Pokemon yet! Use buddy_starter to pick your first partner.",
+              text: "Welcome to Claudemon! Use buddy_starter to pick your first companion and build your party!",
             },
           ],
-          isError: true,
         };
       }
 

package/src/server/tools/pet.ts

@@ -52,10 +52,9 @@ export function registerPetTool(server: McpServer): void {
           content: [
             {
               type: "text" as const,
-              text: "You don't have a Pokemon yet! Use buddy_starter to pick your first partner.",
+              text: "Welcome to Claudemon! Use buddy_starter to pick your first companion -- then you can pet them!",
             },
           ],
-          isError: true,
         };
       }
 
@@ -65,10 +64,9 @@ export function registerPetTool(server: McpServer): void {
           content: [
             {
               type: "text" as const,
-              text: "No active Pokemon found in your party.",
+              text: "Welcome to Claudemon! Use buddy_starter to pick your first companion -- then you can pet them!",
             },
           ],
-          isError: true,
         };
       }
 

package/src/server/tools/pokedex.ts

@@ -32,10 +32,9 @@ export function registerPokedexTool(server: McpServer): void {
           content: [
             {
               type: "text" as const,
-              text: "You don't have a Pokemon yet! Use buddy_starter to begin your journey.",
+              text: "Welcome to Claudemon! Use buddy_starter to pick your first companion and start filling your Pokedex!",
             },
           ],
-          isError: true,
         };
       }
 

package/src/server/tools/rename.ts

@@ -19,16 +19,24 @@ export function registerRenameTool(server: McpServer): void {
 
       if (!state || state.party.length === 0) {
         return {
-          content: [{ type: "text" as const, text: "No Pokemon to rename! Pick a starter first." }],
-          isError: true,
+          content: [
+            {
+              type: "text" as const,
+              text: "Welcome to Claudemon! Use buddy_starter to pick your first companion -- then you can give them a nickname!",
+            },
+          ],
         };
       }
 
       const active = stateManager.getActivePokemon();
       if (!active) {
         return {
-          content: [{ type: "text" as const, text: "No active Pokemon found." }],
-          isError: true,
+          content: [
+            {
+              type: "text" as const,
+              text: "Welcome to Claudemon! Use buddy_starter to pick your first companion -- then you can give them a nickname!",
+            },
+          ],
         };
       }
 

package/src/server/tools/show.ts

@@ -30,10 +30,9 @@ export function registerShowTool(server: McpServer): void {
           content: [
             {
               type: "text" as const,
-              text: "You don't have a Pokemon yet! Use buddy_starter to pick your first partner.",
+              text: "Welcome to Claudemon! You don't have a Pokemon yet. Use /buddy starter to pick your first companion!",
             },
           ],
-          isError: true,
         };
       }
 

package/src/server/tools/starter.ts

@@ -65,10 +65,29 @@ async function getStarters(): Promise<number[]> {
     // No saved options or expired — generate new ones
   }
 
-  // Generate fresh random 3
+  // Generate fresh random 3 with different primary types
   const seed = hashString(`claudemon-${Date.now()}-${Math.random()}`);
   const shuffled = seededShuffle(STARTER_POOL, seed);
-  const starters = [shuffled[0]!, shuffled[1]!, shuffled[2]!];
+  const starters: number[] = [];
+  const usedTypes = new Set<string>();
+
+  for (const id of shuffled) {
+    if (starters.length >= 3) break;
+    const pokemon = POKEMON_BY_ID.get(id);
+    if (!pokemon) continue;
+    const primaryType = pokemon.types[0];
+    if (usedTypes.has(primaryType)) continue;
+    usedTypes.add(primaryType);
+    starters.push(id);
+  }
+
+  // Fallback if not enough unique types (shouldn't happen with 39 starters)
+  if (starters.length < 3) {
+    for (const id of shuffled) {
+      if (starters.length >= 3) break;
+      if (!starters.includes(id)) starters.push(id);
+    }
+  }
 
   // Save for consistency until they pick
   try {
@@ -116,7 +135,6 @@ export function registerStarterTool(server: McpServer): void {
               text: "You already have a Pokemon partner! Use buddy_show to check on them.",
             },
           ],
-          isError: true,
         };
       }
 

package/src/server/tools/stats.ts

@@ -28,10 +28,9 @@ export function registerStatsTool(server: McpServer): void {
           content: [
             {
               type: "text" as const,
-              text: "You don't have a Pokemon yet! Use buddy_starter to pick your first partner.",
+              text: "Welcome to Claudemon! Use buddy_starter to pick your first companion and start your coding adventure!",
             },
           ],
-          isError: true,
         };
       }
 
@@ -41,10 +40,9 @@ export function registerStatsTool(server: McpServer): void {
           content: [
             {
               type: "text" as const,
-              text: "No active Pokemon found in your party.",
+              text: "Welcome to Claudemon! Use buddy_starter to pick your first companion and start your coding adventure!",
             },
           ],
-          isError: true,
         };
       }