context-mode 1.0.65 → 1.0.67

package/configs/antigravity/GEMINI.md

@@ -60,3 +60,6 @@ Search results can flood context. Use `mcp__context-mode__ctx_execute(language:
 | `ctx stats` | Call the `stats` MCP tool and display the full output verbatim |
 | `ctx doctor` | Call the `doctor` MCP tool, run the returned shell command, display as checklist |
 | `ctx upgrade` | Call the `upgrade` MCP tool, run the returned shell command, display as checklist |
+| `ctx purge` | Call the `purge` MCP tool with confirm: true. Warns before wiping the knowledge base. |
+
+After /clear or /compact: knowledge base and session stats are preserved. Use `ctx purge` if you want to start fresh.

package/configs/claude-code/CLAUDE.md

@@ -64,3 +64,6 @@ When spawning subagents (Agent/Task tool), the routing block is automatically in
 | `ctx stats` | Call the `ctx_stats` MCP tool and display the full output verbatim |
 | `ctx doctor` | Call the `ctx_doctor` MCP tool, run the returned shell command, display as checklist |
 | `ctx upgrade` | Call the `ctx_upgrade` MCP tool, run the returned shell command, display as checklist |
+| `ctx purge` | Call the `ctx_purge` MCP tool with confirm: true. Warns before wiping the knowledge base. |
+
+After /clear or /compact: knowledge base and session stats are preserved. Use `ctx purge` if you want to start fresh.

package/configs/codex/AGENTS.md

@@ -60,6 +60,9 @@ Search results can flood context. Use `ctx_execute(language: "shell", code: "gre
 | `ctx stats` | Call the `stats` MCP tool and display the full output verbatim |
 | `ctx doctor` | Call the `doctor` MCP tool, run the returned shell command, display as checklist |
 | `ctx upgrade` | Call the `upgrade` MCP tool, run the returned shell command, display as checklist |
+| `ctx purge` | Call the `purge` MCP tool with confirm: true. Warns before wiping the knowledge base. |
+
+After /clear or /compact: knowledge base and session stats are preserved. Use `ctx purge` if you want to start fresh.
 
 ## Windows notes
 

package/configs/gemini-cli/GEMINI.md

@@ -60,3 +60,6 @@ Search results can flood context. Use `mcp__context-mode__ctx_execute(language:
 | `ctx stats` | Call the `stats` MCP tool and display the full output verbatim |
 | `ctx doctor` | Call the `doctor` MCP tool, run the returned shell command, display as checklist |
 | `ctx upgrade` | Call the `upgrade` MCP tool, run the returned shell command, display as checklist |
+| `ctx purge` | Call the `purge` MCP tool with confirm: true. Warns before wiping the knowledge base. |
+
+After /clear or /compact: knowledge base and session stats are preserved. Use `ctx purge` if you want to start fresh.

package/configs/kilo/AGENTS.md

@@ -60,3 +60,6 @@ Search results can flood context. Use `context-mode_ctx_execute(language: "shell
 | `ctx stats` | Call the `stats` MCP tool and display the full output verbatim |
 | `ctx doctor` | Call the `doctor` MCP tool, run the returned shell command, display as checklist |
 | `ctx upgrade` | Call the `upgrade` MCP tool, run the returned shell command, display as checklist |
+| `ctx purge` | Call the `purge` MCP tool with confirm: true. Warns before wiping the knowledge base. |
+
+After /clear or /compact: knowledge base and session stats are preserved. Use `ctx purge` if you want to start fresh.

package/configs/kiro/KIRO.md

@@ -60,3 +60,6 @@ Search results can flood context. Use `@context-mode/ctx_execute(language: "shel
 | `ctx stats` | Call the `stats` MCP tool and display the full output verbatim |
 | `ctx doctor` | Call the `doctor` MCP tool, run the returned shell command, display as checklist |
 | `ctx upgrade` | Call the `upgrade` MCP tool, run the returned shell command, display as checklist |
+| `ctx purge` | Call the `purge` MCP tool with confirm: true. Warns before wiping the knowledge base. |
+
+After /clear or /compact: knowledge base and session stats are preserved. Use `ctx purge` if you want to start fresh.

package/configs/openclaw/AGENTS.md

@@ -60,3 +60,6 @@ Search results can flood context. Use `ctx_execute(language: "shell", code: "gre
 | `ctx stats` | Call the `stats` MCP tool and display the full output verbatim |
 | `ctx doctor` | Call the `doctor` MCP tool, run the returned shell command, display as checklist |
 | `ctx upgrade` | Call the `upgrade` MCP tool, run the returned shell command, display as checklist |
+| `ctx purge` | Call the `purge` MCP tool with confirm: true. Warns before wiping the knowledge base. |
+
+After /clear or /compact: knowledge base and session stats are preserved. Use `ctx purge` if you want to start fresh.

package/configs/opencode/AGENTS.md

@@ -60,3 +60,6 @@ Search results can flood context. Use `context-mode_ctx_execute(language: "shell
 | `ctx stats` | Call the `stats` MCP tool and display the full output verbatim |
 | `ctx doctor` | Call the `doctor` MCP tool, run the returned shell command, display as checklist |
 | `ctx upgrade` | Call the `upgrade` MCP tool, run the returned shell command, display as checklist |
+| `ctx purge` | Call the `purge` MCP tool with confirm: true. Warns before wiping the knowledge base. |
+
+After /clear or /compact: knowledge base and session stats are preserved. Use `ctx purge` if you want to start fresh.

package/configs/pi/AGENTS.md

@@ -60,3 +60,6 @@ Search results from `grep` or `find` can flood context. Use `ctx_execute(languag
 | `ctx stats` | Call the `stats` MCP tool and display the full output verbatim |
 | `ctx doctor` | Call the `doctor` MCP tool, run the returned shell command, display as checklist |
 | `ctx upgrade` | Call the `upgrade` MCP tool, run the returned shell command, display as checklist |
+| `ctx purge` | Call the `purge` MCP tool with confirm: true. Warns before wiping the knowledge base. |
+
+After /clear or /compact: knowledge base and session stats are preserved. Use `ctx purge` if you want to start fresh.

package/configs/vscode-copilot/copilot-instructions.md

@@ -60,3 +60,6 @@ Search results can flood context. Use `ctx_execute(language: "shell", code: "gre
 | `ctx stats` | Call the `ctx_stats` MCP tool and display the full output verbatim |
 | `ctx doctor` | Call the `ctx_doctor` MCP tool, run the returned shell command, display as checklist |
 | `ctx upgrade` | Call the `ctx_upgrade` MCP tool, run the returned shell command, display as checklist |
+| `ctx purge` | Call the `ctx_purge` MCP tool with confirm: true. Warns before wiping the knowledge base. |
+
+After /clear or /compact: knowledge base and session stats are preserved. Use `ctx purge` if you want to start fresh.

package/configs/zed/AGENTS.md

@@ -60,3 +60,6 @@ Search results can flood context. Use `mcp:context-mode:ctx_execute(language: "s
 | `ctx stats` | Call the `stats` MCP tool and display the full output verbatim |
 | `ctx doctor` | Call the `doctor` MCP tool, run the returned shell command, display as checklist |
 | `ctx upgrade` | Call the `upgrade` MCP tool, run the returned shell command, display as checklist |
+| `ctx purge` | Call the `mcp:context-mode:purge` MCP tool with confirm: true. Warns before wiping the knowledge base. |
+
+After /clear or /compact: knowledge base and session stats are preserved. Use `ctx purge` if you want to start fresh.

package/hooks/routing-block.mjs

@@ -71,7 +71,10 @@ export function createRoutingBlock(t) {
     When the user says "ctx upgrade", "ctx-upgrade", "/ctx-upgrade", or asks to update context-mode:
     → Call the upgrade MCP tool, execute the returned shell command, display results as a checklist.
 
-    After /clear: call ${t("ctx_stats")}(reset: true) to reset session stats and search index.
+    When the user says "ctx purge", "ctx-purge", "/ctx-purge", or asks to wipe/reset the knowledge base:
+    → Call the purge MCP tool with confirm: true. Warn the user this is irreversible.
+
+    After /clear or /compact: knowledge base and session stats are preserved. Inform the user: "context-mode knowledge base preserved. Use \`ctx purge\` if you want to start fresh."
   </ctx_commands>
 </context_window_protection>`;
 }

package/hooks/session-helpers.mjs

@@ -178,15 +178,3 @@ export function getCleanupFlagPath(opts = CLAUDE_OPTS) {
   return join(dir, `${hash}${getWorktreeSuffix()}.cleanup`);
 }
 
-/**
- * Return the per-project clear-stats flag path.
- * Written by SessionStart hook on /clear, read by MCP server to reset stats.
- * Path: ~/<configDir>/context-mode/sessions/<SHA256(projectDir)[:16]>.clear-stats
- */
-export function getClearStatsFlagPath(opts = CLAUDE_OPTS) {
-  const projectDir = getProjectDir(opts);
-  const hash = createHash("sha256").update(projectDir).digest("hex").slice(0, 16);
-  const dir = join(homedir(), opts.configDir, "context-mode", "sessions");
-  mkdirSync(dir, { recursive: true });
-  return join(dir, `${hash}${getWorktreeSuffix()}.clear-stats`);
-}

package/hooks/sessionstart.mjs

@@ -19,7 +19,7 @@ import { createRoutingBlock } from "./routing-block.mjs";
 import { createToolNamer } from "./core/tool-naming.mjs";
 
 const ROUTING_BLOCK = createRoutingBlock(createToolNamer("claude-code"));
-import { readStdin, getSessionId, getSessionDBPath, getSessionEventsPath, getCleanupFlagPath, getClearStatsFlagPath } from "./session-helpers.mjs";
+import { readStdin, getSessionId, getSessionDBPath, getSessionEventsPath, getCleanupFlagPath } from "./session-helpers.mjs";
 import { writeSessionEventsFile, buildSessionDirective, getSessionEvents, getLatestSessionEvents } from "./session-directive.mjs";
 import { createSessionLoaders } from "./session-loaders.mjs";
 import { join, dirname } from "node:path";
@@ -145,10 +145,7 @@ try {
       }
     } catch { /* best effort — never block session start */ }
   }
-  // "clear" — signal MCP server to reset session stats
-  if (source === "clear") {
-    try { writeFileSync(getClearStatsFlagPath(), String(Date.now())); } catch { /* best effort */ }
-  }
+  // "clear" — no reset needed; ctx_purge is the only wipe mechanism
 } catch (err) {
   // Session continuity is best-effort — never block session start
   try {

package/openclaw.plugin.json

@@ -3,7 +3,7 @@
   "name": "Context Mode",
   "kind": "tool",
   "description": "OpenClaw 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": "1.0.65",
+  "version": "1.0.67",
   "sandbox": {
     "mode": "permissive",
     "filesystem_access": "full",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.65",
+  "version": "1.0.67",
   "type": "module",
   "description": "MCP plugin that saves 98% of your context window. Works with Claude Code, Gemini CLI, VS Code Copilot, OpenCode, and Codex CLI. Sandboxed code execution, FTS5 knowledge base, and intent-driven search.",
   "author": "Mert Koseoğlu",