grepmax 0.7.36 → 0.7.38

package/README.md

@@ -29,44 +29,51 @@ Natural-language search that works like `grep`. Fast, local, and built for codin
 
 ## Quick Start
 
-1. **Install**
-   ```bash
-   npm install -g grepmax
-   ```
-
-2.  **Setup (Recommended)**
+```bash
+npm install -g grepmax        # 1. Install
+cd my-repo && gmax index      # 2. Index (models download automatically)
+gmax "where do we handle auth?"  # 3. Search
+```
 
-    ```bash
-    gmax setup
-    ```
+That's it. No setup required — gmax auto-detects your platform (GPU on Apple Silicon, CPU elsewhere) and downloads models on first use.
 
-    Downloads embedding models (~150MB) upfront and lets you choose between CPU (ONNX) and GPU (MLX) embedding modes. If you skip this, models download automatically on first use.
+### Optional: Interactive Setup
 
-3.  **Index**
+```bash
+gmax setup                    # Choose model tier + embedding mode interactively
+```
 
-    ```bash
-    cd my-repo
-    gmax index
-    ```
+Run this if you want to:
+- Switch between **CPU** (ONNX, works everywhere) and **GPU** (MLX, Apple Silicon only, ~3x faster)
+- Choose between **small** model (384d, 47M params, fast) and **standard** model (768d, 149M params, better quality)
 
-    Indexes into a centralized store at `~/.gmax/lancedb/`. You can index any directory — a single repo, a monorepo, or an entire workspace.
+### Quick Config (Non-Interactive)
 
-4.  **Search**
+```bash
+gmax config                          # View current settings
+gmax config --embed-mode cpu         # Switch to CPU
+gmax config --embed-mode gpu         # Switch to GPU (Apple Silicon only)
+gmax config --model-tier standard    # Switch to larger model
+```
 
-    ```bash
-    gmax "where do we handle authentication?"
-    ```
+### Verify Installation
 
-5.  **Trace** (Call Graph)
+```bash
+gmax doctor                   # Check models, index, servers
+```
 
-    ```bash
-    gmax trace "function_name"
-    ```
-    See who calls a function (upstream dependencies) and what it calls (downstream dependencies).
+### Core Commands
 
-    ```bash
-    gmax symbols                  # List all indexed symbols
-    ```
+```bash
+gmax "where do we handle auth?"      # Semantic search
+gmax "VectorDB" --symbol --agent     # Search + call graph (compact output)
+gmax trace handleAuth -d 2           # Call graph (2-hop)
+gmax skeleton src/lib/search/        # File structure (directory)
+gmax project                         # Project overview
+gmax related src/lib/syncer.ts       # Dependencies + dependents
+gmax recent                          # Recently modified files
+gmax symbols auth                    # List indexed symbols
+```
 
 In our public benchmarks, `grepmax` can save about 20% of your LLM tokens and deliver a 30% speedup.
 
@@ -82,6 +89,8 @@ In our public benchmarks, `grepmax` can save about 20% of your LLM tokens and de
 2. Open Claude Code — the plugin auto-starts the MLX GPU server and a background file watcher.
 3. Claude uses `gmax` for semantic searches automatically via MCP tools.
 
+Plugin files (skill instructions, hooks) auto-update when you run `npm update -g grepmax` — no need to re-run `install-claude-code`.
+
 ### Opencode
 1. Run `gmax install-opencode`
 2. OC uses `gmax` for semantic searches via MCP.

package/dist/commands/setup.js

@@ -119,23 +119,22 @@ exports.setup = new commander_1.Command("setup")
     }
     const selectedTier = config_1.MODEL_TIERS[modelTier];
     // Step 5: Embed mode selection
+    const isAppleSilicon = process.arch === "arm64" && process.platform === "darwin";
     const embedMode = yield p.select({
-        message: "Embedding mode",
+        message: "Are you on Apple Silicon (M1/M2/M3/M4)?",
         options: [
             {
-                value: "cpu",
-                label: "CPU only",
-                hint: "ONNX — works everywhere",
+                value: "gpu",
+                label: "Yes — use GPU acceleration",
+                hint: "~3x faster indexing and search via MLX",
             },
             {
-                value: "gpu",
-                label: "GPU (MLX)",
-                hint: "Apple Silicon only, faster indexing + search",
+                value: "cpu",
+                label: "No — use CPU",
+                hint: "Works on all platforms (Intel, Linux, Windows)",
             },
         ],
-        initialValue: (_c = existingConfig === null || existingConfig === void 0 ? void 0 : existingConfig.embedMode) !== null && _c !== void 0 ? _c : (process.arch === "arm64" && process.platform === "darwin"
-            ? "gpu"
-            : "cpu"),
+        initialValue: (_c = existingConfig === null || existingConfig === void 0 ? void 0 : existingConfig.embedMode) !== null && _c !== void 0 ? _c : (isAppleSilicon ? "gpu" : "cpu"),
     });
     if (p.isCancel(embedMode)) {
         p.cancel("Setup cancelled");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.36",
+  "version": "0.7.38",
   "author": "Robert Owens <robowens@me.com>",
   "homepage": "https://github.com/reowens/grepmax",
   "bugs": {
@@ -23,6 +23,7 @@
   "files": [
     "dist",
     "plugins",
+    "scripts/postinstall.js",
     "mlx-embed-server",
     "README.md",
     "LICENSE",
@@ -62,6 +63,7 @@
     "vitest": "^1.6.1"
   },
   "scripts": {
+    "postinstall": "node scripts/postinstall.js",
     "prebuild": "mkdir -p dist",
     "build": "tsc",
     "postbuild": "chmod +x dist/index.js",

package/plugins/grepmax/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.36",
+  "version": "0.7.38",
   "description": "Semantic code search for Claude Code. Automatically indexes your project and provides intelligent search capabilities.",
   "author": {
     "name": "Robert Owens",

package/plugins/grepmax/skills/grepmax/SKILL.md

@@ -4,12 +4,13 @@ description: Semantic code search. Use alongside grep - grep for exact strings,
 allowed-tools: "mcp__grepmax__semantic_search, mcp__grepmax__code_skeleton, mcp__grepmax__trace_calls, mcp__grepmax__list_symbols, mcp__grepmax__index_status, mcp__grepmax__summarize_directory, mcp__grepmax__summarize_project, mcp__grepmax__related_files, mcp__grepmax__recent_changes, Bash(gmax:*), Read"
 ---
 
-## What gmax does
+## When to use what
 
-Semantic code search — finds code by meaning, not just strings.
-
-- grep/ripgrep: exact string match
-- gmax: concept match ("where do we handle auth?", "how does booking flow work?")
+- **Know the exact string/symbol?** → `Grep` tool (fastest, zero overhead)
+- **Know the file already?** → `Read` tool directly
+- **Searching by concept/behavior?** → `Bash(gmax "query" --agent)` (semantic search)
+- **Need file structure?** → `Bash(gmax skeleton <path>)`
+- **Need call flow?** → `Bash(gmax trace <symbol>)`
 
 ## IMPORTANT: Use CLI, not MCP tools
 

package/scripts/postinstall.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+/**
+ * Postinstall: sync plugin files (SKILL.md, hooks, plugin.json) to
+ * the Claude Code plugin cache if it exists. This ensures `npm update -g grepmax`
+ * automatically updates the skill instructions without needing `gmax install-claude-code`.
+ */
+const fs = require("node:fs");
+const path = require("node:path");
+const os = require("node:os");
+
+const pluginCacheBase = path.join(os.homedir(), ".claude", "plugins", "cache", "grepmax", "grepmax");
+const sourcePlugin = path.join(__dirname, "..", "plugins", "grepmax");
+
+if (!fs.existsSync(pluginCacheBase) || !fs.existsSync(sourcePlugin)) {
+  // Plugin not installed via Claude Code — skip silently
+  process.exit(0);
+}
+
+// Find installed version directories
+let entries;
+try {
+  entries = fs.readdirSync(pluginCacheBase, { withFileTypes: true });
+} catch {
+  process.exit(0);
+}
+
+const versionDirs = entries.filter((e) => e.isDirectory()).map((e) => e.name);
+if (versionDirs.length === 0) process.exit(0);
+
+// Sync files to each installed version
+function copyRecursive(src, dest) {
+  if (!fs.existsSync(src)) return;
+  const stat = fs.statSync(src);
+  if (stat.isDirectory()) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src)) {
+      copyRecursive(path.join(src, entry), path.join(dest, entry));
+    }
+  } else {
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.copyFileSync(src, dest);
+  }
+}
+
+for (const ver of versionDirs) {
+  const destDir = path.join(pluginCacheBase, ver);
+  try {
+    // Sync skills
+    copyRecursive(
+      path.join(sourcePlugin, "skills"),
+      path.join(destDir, "skills"),
+    );
+    // Sync hooks
+    copyRecursive(
+      path.join(sourcePlugin, "hooks"),
+      path.join(destDir, "hooks"),
+    );
+    // Sync hooks.json
+    const hooksJson = path.join(sourcePlugin, "hooks.json");
+    if (fs.existsSync(hooksJson)) {
+      fs.copyFileSync(hooksJson, path.join(destDir, "hooks.json"));
+    }
+  } catch {
+    // Best-effort — don't fail the install
+  }
+}