context-mode 0.8.1 → 0.9.0

package/.claude-plugin/hooks/hooks.json

@@ -7,7 +7,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.sh"
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.mjs"
           }
         ]
       },
@@ -16,7 +16,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.sh"
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.mjs"
           }
         ]
       },
@@ -25,7 +25,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.sh"
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.mjs"
           }
         ]
       },
@@ -34,7 +34,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.sh"
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.mjs"
           }
         ]
       },
@@ -43,7 +43,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.sh"
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.mjs"
           }
         ]
       }

package/.claude-plugin/marketplace.json

@@ -13,7 +13,7 @@
       "name": "context-mode",
       "source": "./",
       "description": "Claude Code MCP plugin that saves 98% of your context window. Sandboxed code execution in 11 languages, FTS5 knowledge base with BM25 ranking, and intent-driven search.",
-      "version": "0.8.1",
+      "version": "0.9.0",
       "author": {
         "name": "Mert Koseoğlu"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "Claude Code MCP plugin that saves 98% of your context window. Sandboxed code execution in 11 languages, FTS5 knowledge base with BM25 ranking, and intent-driven search.",
   "author": {
     "name": "Mert Koseoğlu",
@@ -21,8 +21,8 @@
   ],
   "mcpServers": {
     "context-mode": {
-      "command": "sh",
-      "args": ["${CLAUDE_PLUGIN_ROOT}/start.sh"]
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/start.mjs"]
     }
   },
   "skills": "./skills/"

package/.mcp.json

@@ -1,8 +1,8 @@
 {
   "mcpServers": {
     "context-mode": {
-      "command": "sh",
-      "args": ["${CLAUDE_PLUGIN_ROOT}/start.sh"]
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/start.mjs"]
     }
   }
 }

package/README.md

@@ -205,6 +205,10 @@ npm run test:all      # full suite
   <img src="https://contrib.rocks/image?repo=mksglu/claude-context-mode&columns=8&anon=1" />
 </a>
 
+### Special Thanks
+
+<a href="https://github.com/mksglu/claude-context-mode/issues/15"><img src="https://github.com/vaban-ru.png" width="32" /></a>
+
 ## License
 
 MIT

package/build/cli.js

@@ -12,7 +12,7 @@
 import * as p from "@clack/prompts";
 import color from "picocolors";
 import { execSync } from "node:child_process";
-import { readFileSync, writeFileSync, copyFileSync, chmodSync, accessSync, readdirSync, constants } from "node:fs";
+import { readFileSync, writeFileSync, copyFileSync, cpSync, chmodSync, accessSync, readdirSync, rmSync, constants } from "node:fs";
 import { resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { homedir } from "node:os";
@@ -22,7 +22,7 @@ if (args[0] === "setup") {
     setup();
 }
 else if (args[0] === "doctor") {
-    doctor();
+    doctor().then((code) => process.exit(code));
 }
 else if (args[0] === "upgrade") {
     upgrade();
@@ -52,7 +52,7 @@ function readSettings() {
     }
 }
 function getHookScriptPath() {
-    return resolve(getPluginRoot(), "hooks", "pretooluse.sh");
+    return resolve(getPluginRoot(), "hooks", "pretooluse.mjs");
 }
 function getLocalVersion() {
     try {
@@ -126,6 +126,7 @@ async function doctor() {
     if (process.stdout.isTTY)
         console.clear();
     p.intro(color.bgMagenta(color.white(" context-mode doctor ")));
+    let criticalFails = 0;
     const s = p.spinner();
     s.start("Running diagnostics");
     const runtimes = detectRuntimes();
@@ -145,8 +146,16 @@ async function doctor() {
     // Language coverage
     const total = 11;
     const pct = ((available.length / total) * 100).toFixed(0);
-    p.log.info(`Language coverage: ${available.length}/${total} (${pct}%)` +
-        color.dim(` — ${available.join(", ")}`));
+    if (available.length < 2) {
+        criticalFails++;
+        p.log.error(color.red(`Language coverage: ${available.length}/${total} (${pct}%)`) +
+            " — too few runtimes detected" +
+            color.dim(` — ${available.join(", ") || "none"}`));
+    }
+    else {
+        p.log.info(`Language coverage: ${available.length}/${total} (${pct}%)` +
+            color.dim(` — ${available.join(", ")}`));
+    }
     // Server test
     p.log.step("Testing server initialization...");
     try {
@@ -161,10 +170,12 @@ async function doctor() {
             p.log.success(color.green("Server test: PASS"));
         }
         else {
+            criticalFails++;
             p.log.error(color.red("Server test: FAIL") + ` — exit ${result.exitCode}`);
         }
     }
     catch (err) {
+        criticalFails++;
         const message = err instanceof Error ? err.message : String(err);
         p.log.error(color.red("Server test: FAIL") + ` — ${message}`);
     }
@@ -176,13 +187,13 @@ async function doctor() {
         const hooks = settings.hooks;
         const preToolUse = hooks?.PreToolUse;
         if (preToolUse && preToolUse.length > 0) {
-            const hasCorrectHook = preToolUse.some((entry) => entry.hooks?.some((h) => h.command?.includes("pretooluse.sh")));
+            const hasCorrectHook = preToolUse.some((entry) => entry.hooks?.some((h) => h.command?.includes("pretooluse.mjs")));
             if (hasCorrectHook) {
                 p.log.success(color.green("Hooks installed: PASS") + " — PreToolUse hook configured");
             }
             else {
                 p.log.error(color.red("Hooks installed: FAIL") +
-                    " — PreToolUse exists but does not point to pretooluse.sh" +
+                    " — PreToolUse exists but does not point to pretooluse.mjs" +
                     color.dim("\n  Run: npx context-mode upgrade"));
             }
         }
@@ -245,10 +256,12 @@ async function doctor() {
             p.log.success(color.green("FTS5 / better-sqlite3: PASS") + " — native module works");
         }
         else {
+            criticalFails++;
             p.log.error(color.red("FTS5 / better-sqlite3: FAIL") + " — query returned unexpected result");
         }
     }
     catch (err) {
+        criticalFails++;
         const message = err instanceof Error ? err.message : String(err);
         p.log.error(color.red("FTS5 / better-sqlite3: FAIL") +
             ` — ${message}` +
@@ -292,9 +305,14 @@ async function doctor() {
             color.dim(" — could not verify against npm registry"));
     }
     // Summary
+    if (criticalFails > 0) {
+        p.outro(color.red(`Diagnostics failed — ${criticalFails} critical issue(s) found`));
+        return 1;
+    }
     p.outro(available.length >= 4
         ? color.green("Diagnostics complete!")
         : color.yellow("Some checks need attention — see above for details"));
+    return 0;
 }
 /* -------------------------------------------------------
  * Upgrade
@@ -327,12 +345,12 @@ async function upgrade() {
         }
         // Step 2: Install dependencies + build
         s.start("Installing dependencies & building");
-        execSync("npm install --no-audit --no-fund 2>/dev/null", {
+        execSync("npm install --no-audit --no-fund", {
             cwd: srcDir,
             stdio: "pipe",
             timeout: 60000,
         });
-        execSync("npm run build 2>/dev/null", {
+        execSync("npm run build", {
             cwd: srcDir,
             stdio: "pipe",
             timeout: 30000,
@@ -342,19 +360,19 @@ async function upgrade() {
         s.start("Installing files");
         const items = [
             "build", "hooks", "skills", ".claude-plugin",
-            "start.sh", "server.bundle.mjs", "package.json", ".mcp.json",
+            "start.mjs", "server.bundle.mjs", "package.json", ".mcp.json",
         ];
         for (const item of items) {
             try {
-                execSync(`rm -rf "${pluginRoot}/${item}"`, { stdio: "pipe" });
-                execSync(`cp -r "${srcDir}/${item}" "${pluginRoot}/"`, { stdio: "pipe" });
+                rmSync(resolve(pluginRoot, item), { recursive: true, force: true });
+                cpSync(resolve(srcDir, item), resolve(pluginRoot, item), { recursive: true });
             }
             catch { /* some files may not exist */ }
         }
         s.stop(color.green("Files installed"));
         // Install production deps in plugin root
         s.start("Installing production dependencies");
-        execSync("npm install --production --no-audit --no-fund 2>/dev/null", {
+        execSync("npm install --production --no-audit --no-fund", {
             cwd: pluginRoot,
             stdio: "pipe",
             timeout: 60000,
@@ -367,8 +385,9 @@ async function upgrade() {
             const newCacheDir = cacheMatch[1] + newVersion;
             s.start(`Migrating cache: ${oldDirVersion} → ${newVersion}`);
             try {
-                execSync(`rm -rf "${newCacheDir}"`, { stdio: "pipe" });
-                execSync(`mv "${pluginRoot}" "${newCacheDir}"`, { stdio: "pipe" });
+                rmSync(newCacheDir, { recursive: true, force: true });
+                cpSync(pluginRoot, newCacheDir, { recursive: true });
+                rmSync(pluginRoot, { recursive: true, force: true });
                 pluginRoot = newCacheDir;
                 s.stop(color.green(`Cache directory: ${newVersion}`));
                 changes.push(`Migrated cache: ${oldDirVersion} → ${newVersion}`);
@@ -392,7 +411,7 @@ async function upgrade() {
             p.log.info(color.dim("  Could not update global npm — may need sudo or standalone install"));
         }
         // Cleanup
-        execSync(`rm -rf "${tmpDir}"`, { stdio: "pipe" });
+        rmSync(tmpDir, { recursive: true, force: true });
         changes.push(newVersion !== localVersion
             ? `Updated v${localVersion} → v${newVersion}`
             : `Reinstalled v${localVersion} from GitHub`);
@@ -406,7 +425,7 @@ async function upgrade() {
         p.log.info(color.dim("Continuing with hooks/settings fix..."));
         // Cleanup on failure
         try {
-            execSync(`rm -rf "${tmpDir}"`, { stdio: "pipe" });
+            rmSync(tmpDir, { recursive: true, force: true });
         }
         catch { /* ignore */ }
     }
@@ -425,14 +444,14 @@ async function upgrade() {
     }
     // Step 4: Fix hooks
     p.log.step("Configuring PreToolUse hooks...");
-    const hookScriptPath = resolve(pluginRoot, "hooks", "pretooluse.sh");
+    const hookScriptPath = resolve(pluginRoot, "hooks", "pretooluse.mjs");
     const settings = readSettings() ?? {};
     const desiredHookEntry = {
         matcher: "Bash|Read|Grep|Glob|WebFetch|WebSearch|Task",
         hooks: [
             {
                 type: "command",
-                command: "bash " + hookScriptPath,
+                command: "node " + hookScriptPath,
             },
         ],
     };
@@ -441,7 +460,7 @@ async function upgrade() {
     if (existingPreToolUse && Array.isArray(existingPreToolUse)) {
         const existingIdx = existingPreToolUse.findIndex((entry) => {
             const entryHooks = entry.hooks;
-            return entryHooks?.some((h) => h.command?.includes("pretooluse.sh"));
+            return entryHooks?.some((h) => h.command?.includes("pretooluse.mjs"));
         });
         if (existingIdx >= 0) {
             existingPreToolUse[existingIdx] = desiredHookEntry;
@@ -478,7 +497,7 @@ async function upgrade() {
         accessSync(hookScriptPath, constants.R_OK);
         chmodSync(hookScriptPath, 0o755);
         p.log.success(color.green("Permissions set") + color.dim(" — chmod +x " + hookScriptPath));
-        changes.push("Set pretooluse.sh as executable");
+        changes.push("Set pretooluse.mjs as executable");
     }
     catch {
         p.log.error(color.red("Hook script not found") +
@@ -494,7 +513,10 @@ async function upgrade() {
     // Step 7: Run doctor
     p.log.step("Running doctor to verify...");
     console.log();
-    await doctor();
+    const doctorCode = await doctor();
+    if (doctorCode !== 0) {
+        process.exit(doctorCode);
+    }
 }
 /* -------------------------------------------------------
  * Setup

package/build/executor.js

@@ -4,6 +4,19 @@ import { mkdtempSync, writeFileSync, rmSync, existsSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { tmpdir } from "node:os";
 import { detectRuntimes, buildCommand, } from "./runtime.js";
+const isWin = process.platform === "win32";
+/** Kill process tree — on Windows, proc.kill() only kills the shell, not children. */
+function killTree(proc) {
+    if (isWin && proc.pid) {
+        try {
+            execSync(`taskkill /F /T /PID ${proc.pid}`, { stdio: "pipe" });
+        }
+        catch { /* already dead */ }
+    }
+    else {
+        proc.kill("SIGKILL");
+    }
+}
 export class PolyglotExecutor {
     #maxOutputBytes;
     #hardCapBytes;
@@ -77,13 +90,15 @@ export class PolyglotExecutor {
         return fp;
     }
     async #compileAndRun(srcPath, cwd, timeout) {
-        const binPath = srcPath.replace(/\.rs$/, "");
+        const binSuffix = isWin ? ".exe" : "";
+        const binPath = srcPath.replace(/\.rs$/, "") + binSuffix;
         // Compile
         try {
-            execSync(`rustc ${srcPath} -o ${binPath} 2>&1`, {
+            execSync(`rustc ${srcPath} -o ${binPath}`, {
                 cwd,
                 timeout: Math.min(timeout, 30_000),
                 encoding: "utf-8",
+                stdio: ["pipe", "pipe", "pipe"],
             });
         }
         catch (err) {
@@ -137,15 +152,19 @@ export class PolyglotExecutor {
     }
     async #spawn(cmd, cwd, timeout) {
         return new Promise((res) => {
+            // Only .cmd/.bat shims need shell on Windows; real executables don't.
+            // Using shell: true globally causes process-tree kill issues with MSYS2/Git Bash.
+            const needsShell = isWin && ["tsx", "ts-node", "elixir"].includes(cmd[0]);
             const proc = spawn(cmd[0], cmd.slice(1), {
                 cwd,
                 stdio: ["ignore", "pipe", "pipe"],
                 env: this.#buildSafeEnv(cwd),
+                shell: needsShell,
             });
             let timedOut = false;
             const timer = setTimeout(() => {
                 timedOut = true;
-                proc.kill("SIGKILL");
+                killTree(proc);
             }, timeout);
             // Stream-level byte cap: kill the process once combined stdout+stderr
             // exceeds hardCapBytes. Without this, a command like `yes` or
@@ -162,7 +181,7 @@ export class PolyglotExecutor {
                 }
                 else if (!capExceeded) {
                     capExceeded = true;
-                    proc.kill("SIGKILL");
+                    killTree(proc);
                 }
             });
             proc.stderr.on("data", (chunk) => {
@@ -172,7 +191,7 @@ export class PolyglotExecutor {
                 }
                 else if (!capExceeded) {
                     capExceeded = true;
-                    proc.kill("SIGKILL");
+                    killTree(proc);
                 }
             });
             proc.on("close", (exitCode) => {
@@ -239,7 +258,7 @@ export class PolyglotExecutor {
             "XDG_DATA_HOME",
         ];
         const env = {
-            PATH: process.env.PATH ?? "/usr/local/bin:/usr/bin:/bin",
+            PATH: process.env.PATH ?? (isWin ? "" : "/usr/local/bin:/usr/bin:/bin"),
             HOME: realHome,
             TMPDIR: tmpDir,
             LANG: "en_US.UTF-8",
@@ -247,6 +266,18 @@ export class PolyglotExecutor {
             PYTHONUNBUFFERED: "1",
             NO_COLOR: "1",
         };
+        // Windows-critical env vars
+        if (isWin) {
+            const winVars = [
+                "SYSTEMROOT", "SystemRoot", "COMSPEC", "PATHEXT",
+                "USERPROFILE", "APPDATA", "LOCALAPPDATA", "TEMP", "TMP",
+                "GOROOT", "GOPATH",
+            ];
+            for (const key of winVars) {
+                if (process.env[key])
+                    env[key] = process.env[key];
+            }
+        }
         for (const key of passthrough) {
             if (process.env[key]) {
                 env[key] = process.env[key];

package/build/runtime.js

@@ -1,7 +1,9 @@
 import { execSync } from "node:child_process";
+const isWindows = process.platform === "win32";
 function commandExists(cmd) {
     try {
-        execSync(`command -v ${cmd} 2>/dev/null`, { stdio: "pipe" });
+        const check = isWindows ? `where ${cmd}` : `command -v ${cmd}`;
+        execSync(check, { stdio: "pipe" });
         return true;
     }
     catch {
@@ -10,8 +12,9 @@ function commandExists(cmd) {
 }
 function getVersion(cmd) {
     try {
-        return execSync(`${cmd} --version 2>/dev/null`, {
+        return execSync(`${cmd} --version`, {
             encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
             timeout: 5000,
         })
             .trim()

package/hooks/hooks.json

@@ -7,7 +7,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.sh"
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.mjs"
           }
         ]
       },
@@ -16,7 +16,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.sh"
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.mjs"
           }
         ]
       },
@@ -25,7 +25,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.sh"
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.mjs"
           }
         ]
       },
@@ -34,7 +34,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.sh"
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.mjs"
           }
         ]
       },
@@ -43,7 +43,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.sh"
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.mjs"
           }
         ]
       }

package/hooks/pretooluse.mjs

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+/**
+ * Unified PreToolUse hook for context-mode
+ * Redirects data-fetching tools to context-mode MCP tools
+ *
+ * Cross-platform (Windows/macOS/Linux) — no bash/jq dependency.
+ */
+
+let raw = "";
+process.stdin.setEncoding("utf-8");
+for await (const chunk of process.stdin) raw += chunk;
+
+const input = JSON.parse(raw);
+const tool = input.tool_name ?? "";
+const toolInput = input.tool_input ?? {};
+
+// ─── Bash: redirect data-fetching commands via updatedInput ───
+if (tool === "Bash") {
+  const command = toolInput.command ?? "";
+
+  // curl/wget → replace with echo redirect
+  if (/(^|\s|&&|\||\;)(curl|wget)\s/i.test(command)) {
+    console.log(JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: "PreToolUse",
+        updatedInput: {
+          command: 'echo "context-mode: curl/wget blocked. You MUST use mcp__context-mode__fetch_and_index(url, source) to fetch URLs, or mcp__context-mode__execute(language, code) to run HTTP calls in sandbox. Do NOT retry with curl/wget."',
+        },
+      },
+    }));
+    process.exit(0);
+  }
+
+  // inline fetch (node -e, python -c, etc.) → replace with echo redirect
+  if (
+    /fetch\s*\(\s*['"](https?:\/\/|http)/i.test(command) ||
+    /requests\.(get|post|put)\s*\(/i.test(command) ||
+    /http\.(get|request)\s*\(/i.test(command)
+  ) {
+    console.log(JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: "PreToolUse",
+        updatedInput: {
+          command: 'echo "context-mode: Inline HTTP blocked. Use mcp__context-mode__execute(language, code) to run HTTP calls in sandbox, or mcp__context-mode__fetch_and_index(url, source) for web pages. Do NOT retry with Bash."',
+        },
+      },
+    }));
+    process.exit(0);
+  }
+
+  // allow all other Bash commands
+  process.exit(0);
+}
+
+// ─── Read: nudge toward execute_file ───
+if (tool === "Read") {
+  console.log(JSON.stringify({
+    hookSpecificOutput: {
+      hookEventName: "PreToolUse",
+      additionalContext:
+        "CONTEXT TIP: If this file is large (>50 lines), prefer mcp__context-mode__execute_file(path, language, code) — processes in sandbox, only stdout enters context.",
+    },
+  }));
+  process.exit(0);
+}
+
+// ─── Grep: nudge toward execute ───
+if (tool === "Grep") {
+  console.log(JSON.stringify({
+    hookSpecificOutput: {
+      hookEventName: "PreToolUse",
+      additionalContext:
+        'CONTEXT TIP: If results may be large, prefer mcp__context-mode__execute(language: "shell", code: "grep ...") — runs in sandbox, only stdout enters context.',
+    },
+  }));
+  process.exit(0);
+}
+
+// ─── Glob: passthrough ───
+if (tool === "Glob") {
+  process.exit(0);
+}
+
+// ─── WebFetch: deny + redirect to sandbox ───
+if (tool === "WebFetch") {
+  const url = toolInput.url ?? "";
+  console.log(JSON.stringify({
+    hookSpecificOutput: {
+      hookEventName: "PreToolUse",
+      permissionDecision: "deny",
+      reason: `context-mode: WebFetch blocked. Use mcp__context-mode__fetch_and_index(url: "${url}", source: "...") to fetch this URL in sandbox. Then use mcp__context-mode__search(queries: [...]) to query results. Do NOT use curl/wget — they are also blocked.`,
+    },
+  }));
+  process.exit(0);
+}
+
+// ─── WebSearch: passthrough ───
+if (tool === "WebSearch") {
+  process.exit(0);
+}
+
+// ─── Task: inject context-mode routing into subagent prompts ───
+if (tool === "Task") {
+  const subagentType = toolInput.subagent_type ?? "";
+  const prompt = toolInput.prompt ?? "";
+
+  const ROUTING_BLOCK = `
+
+---
+CONTEXT WINDOW PROTECTION — USE CONTEXT-MODE MCP TOOLS
+
+Raw Bash/Read/WebFetch output floods your context. You have context-mode tools that keep data in sandbox.
+
+STEP 1 — GATHER: mcp__context-mode__batch_execute(commands, queries)
+  commands: [{label: "Name", command: "shell cmd"}, ...]
+  queries: ["query1", "query2", ...] — put 5-8 queries covering everything you need.
+  Runs all commands, indexes output, returns search results. ONE call, no follow-ups.
+
+STEP 2 — FOLLOW-UP: mcp__context-mode__search(queries: ["q1", "q2", "q3", ...])
+  Pass ALL follow-up questions as queries array. ONE call, not separate calls.
+
+OTHER: execute(language, code) | execute_file(path, language, code) | fetch_and_index(url) + search
+
+FORBIDDEN: Bash for output, Read for files, WebFetch. Bash is ONLY for git/mkdir/rm/mv.
+
+OUTPUT FORMAT — KEEP YOUR FINAL RESPONSE UNDER 500 WORDS:
+The parent agent context window is precious. Your full response gets injected into it.
+
+1. ARTIFACTS (PRDs, configs, code files) → Write to FILES, never return as inline text.
+   Return only: file path + 1-line description.
+2. DETAILED FINDINGS → Index into knowledge base:
+   mcp__context-mode__index(content: "...", source: "descriptive-label")
+   The parent agent shares the SAME knowledge base and can search() your indexed content.
+3. YOUR RESPONSE must be a concise summary:
+   - What you did (2-3 bullets)
+   - File paths created/modified (if any)
+   - Source labels you indexed (so parent can search)
+   - Key findings in bullet points
+   Do NOT return raw data, full file contents, or lengthy explanations.
+---`;
+
+  const updatedInput =
+    subagentType === "Bash"
+      ? { ...toolInput, prompt: prompt + ROUTING_BLOCK, subagent_type: "general-purpose" }
+      : { ...toolInput, prompt: prompt + ROUTING_BLOCK };
+
+  console.log(JSON.stringify({
+    hookSpecificOutput: {
+      hookEventName: "PreToolUse",
+      updatedInput,
+    },
+  }));
+  process.exit(0);
+}
+
+// Unknown tool — pass through
+process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "type": "module",
   "description": "Claude Code MCP plugin that saves 98% of your context window. Sandboxed code execution, FTS5 knowledge base, and intent-driven search.",
   "author": "Mert Koseoğlu",
@@ -32,7 +32,7 @@
     "skills",
     ".claude-plugin",
     ".mcp.json",
-    "start.sh",
+    "start.mjs",
     "README.md",
     "LICENSE"
   ],

package/server.bundle.mjs

@@ -166,7 +166,7 @@ ${n}`}}};import{createRequire as xT}from"node:module";import{readFileSync as $T,
 `).trim();u.length!==0&&(r.push({title:this.#o(o,i),content:u,hasCode:s.some(l=>/^`{3,}/.test(l))}),s=[])},c=0;for(;c<n.length;){let u=n[c];if(/^[-_*]{3,}\s*$/.test(u)){a(),c++;continue}let l=u.match(/^(#{1,4})\s+(.+)$/);if(l){a();let m=l[1].length,f=l[2].trim();for(;o.length>0&&o[o.length-1].level>=m;)o.pop();o.push({level:m,text:f}),i=f,s.push(u),c++;continue}let d=u.match(/^(`{3,})(.*)?$/);if(d){let m=d[1],f=[u];for(c++;c<n.length;){if(f.push(n[c]),n[c].startsWith(m)&&n[c].trim()===m){c++;break}c++}s.push(...f);continue}s.push(u),c++}return a(),r}#i(e,r){let n=e.split(/\n\s*\n/);if(n.length>=3&&n.length<=200&&n.every(c=>Buffer.byteLength(c)<5e3))return n.map((c,u)=>{let l=c.trim();return{title:l.split(`
 `)[0].slice(0,80)||`Section ${u+1}`,content:l}}).filter(c=>c.content.length>0);let o=e.split(`
 `);if(o.length<=r)return[{title:"Output",content:e}];let s=[],a=Math.max(r-2,1);for(let c=0;c<o.length;c+=a){let u=o.slice(c,c+r);if(u.length===0)break;let l=c+1,d=Math.min(c+u.length,o.length),m=u[0]?.trim().slice(0,80);s.push({title:m||`Lines ${l}-${d}`,content:u.join(`
-`)})}return s}#o(e,r){return e.length===0?r||"Untitled":e.map(n=>n.text).join(" > ")}};var d_="0.8.0",nd=pi(),PT=t_(nd),er=new ui({name:"context-mode",version:d_}),yi=new mi({runtimes:nd,projectRoot:process.env.CLAUDE_PROJECT_DIR}),xo=null;function $o(){return xo||(xo=new hi),xo}var je={calls:{},bytesReturned:{},bytesIndexed:0,bytesSandboxed:0,sessionStart:Date.now()};function ne(t,e){let r=e.content.reduce((n,o)=>n+Buffer.byteLength(o.text),0);return je.calls[t]=(je.calls[t]||0)+1,je.bytesReturned[t]=(je.bytesReturned[t]||0)+r,e}function Qt(t){je.bytesIndexed+=t}var RT=PT.join(", "),IT=ed()?" (Bun detected \u2014 JS/TS runs 3-5x faster)":"";function p_(t,e,r=1500){if(t.length<=r)return t;let n=e.toLowerCase().split(/\s+/).filter(l=>l.length>2),o=t.toLowerCase(),s=[];for(let l of n){let d=o.indexOf(l);for(;d!==-1;)s.push(d),d=o.indexOf(l,d+1)}if(s.length===0)return t.slice(0,r)+`
+`)})}return s}#o(e,r){return e.length===0?r||"Untitled":e.map(n=>n.text).join(" > ")}};var d_="0.8.1",nd=pi(),PT=t_(nd),er=new ui({name:"context-mode",version:d_}),yi=new mi({runtimes:nd,projectRoot:process.env.CLAUDE_PROJECT_DIR}),xo=null;function $o(){return xo||(xo=new hi),xo}var je={calls:{},bytesReturned:{},bytesIndexed:0,bytesSandboxed:0,sessionStart:Date.now()};function ne(t,e){let r=e.content.reduce((n,o)=>n+Buffer.byteLength(o.text),0);return je.calls[t]=(je.calls[t]||0)+1,je.bytesReturned[t]=(je.bytesReturned[t]||0)+r,e}function Qt(t){je.bytesIndexed+=t}var RT=PT.join(", "),IT=ed()?" (Bun detected \u2014 JS/TS runs 3-5x faster)":"";function p_(t,e,r=1500){if(t.length<=r)return t;let n=e.toLowerCase().split(/\s+/).filter(l=>l.length>2),o=t.toLowerCase(),s=[];for(let l of n){let d=o.indexOf(l);for(;d!==-1;)s.push(d),d=o.indexOf(l,d+1)}if(s.length===0)return t.slice(0,r)+`
 \u2026`;s.sort((l,d)=>l-d);let i=300,a=[];for(let l of s){let d=Math.max(0,l-i),m=Math.min(t.length,l+i);a.length>0&&d<=a[a.length-1][1]?a[a.length-1][1]=m:a.push([d,m])}let c=[],u=0;for(let[l,d]of a){if(u>=r)break;let m=t.slice(l,Math.min(d,l+(r-u)));c.push((l>0?"\u2026":"")+m+(d<t.length?"\u2026":"")),u+=m.length}return c.join(`
 
 `)}er.registerTool("execute",{title:"Execute Code",description:`Execute code in a sandboxed subprocess. Only stdout enters context \u2014 raw data stays in the subprocess. Use instead of bash/cat when output would exceed 20 lines.${IT} Available: ${RT}.

package/start.mjs

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+process.chdir(__dirname);
+
+if (!process.env.CLAUDE_PROJECT_DIR) {
+  process.env.CLAUDE_PROJECT_DIR = process.cwd();
+}
+
+// Ensure native module is available
+if (!existsSync(resolve(__dirname, "node_modules", "better-sqlite3"))) {
+  try {
+    execSync("npm install better-sqlite3 --no-package-lock --no-save --silent", {
+      cwd: __dirname,
+      stdio: "pipe",
+      timeout: 60000,
+    });
+  } catch { /* best effort */ }
+}
+
+// Bundle exists (CI-built) — start instantly
+if (existsSync(resolve(__dirname, "server.bundle.mjs"))) {
+  await import("./server.bundle.mjs");
+} else {
+  // Dev or npm install — full build
+  if (!existsSync(resolve(__dirname, "node_modules"))) {
+    try {
+      execSync("npm install --silent", { cwd: __dirname, stdio: "pipe", timeout: 60000 });
+    } catch { /* best effort */ }
+  }
+  if (!existsSync(resolve(__dirname, "build", "server.js"))) {
+    try {
+      execSync("npx tsc --silent", { cwd: __dirname, stdio: "pipe", timeout: 30000 });
+    } catch { /* best effort */ }
+  }
+  await import("./build/server.js");
+}

package/start.sh

@@ -1,15 +0,0 @@
-#!/bin/sh
-CLAUDE_PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-DIR="$(cd "$(dirname "$0")" && pwd)"
-cd "$DIR"
-
-# Bundle exists (CI-built) — start instantly, install native module in background
-if [ -f server.bundle.mjs ]; then
-  [ -d node_modules/better-sqlite3 ] || npm install better-sqlite3 --no-package-lock --no-save --silent 2>/dev/null &
-  CLAUDE_PROJECT_DIR="$CLAUDE_PROJECT_DIR" exec node server.bundle.mjs
-fi
-
-# Fallback: no bundle (dev or npm install) — full build
-[ -d node_modules ] || npm install --silent 2>/dev/null
-[ -f build/server.js ] || npx tsc --silent 2>/dev/null
-CLAUDE_PROJECT_DIR="$CLAUDE_PROJECT_DIR" exec node build/server.js