context-mode 1.0.22 → 1.0.24

package/configs/antigravity/GEMINI.md

@@ -0,0 +1,58 @@
+# context-mode — MANDATORY routing rules
+
+You have context-mode MCP tools available. These rules are NOT optional — they protect your context window from flooding. A single unrouted command can dump 56 KB into context and waste the entire session. Antigravity does NOT have hooks, so these instructions are your ONLY enforcement mechanism. Follow them strictly.
+
+## BLOCKED commands — do NOT use these
+
+### curl / wget — FORBIDDEN
+Do NOT use `curl` or `wget` via `run_command`. They dump raw HTTP responses directly into your context window.
+Instead use:
+- `mcp__context-mode__ctx_fetch_and_index(url, source)` to fetch and index web pages
+- `mcp__context-mode__ctx_execute(language: "javascript", code: "const r = await fetch(...)")` to run HTTP calls in sandbox
+
+### Inline HTTP — FORBIDDEN
+Do NOT run inline HTTP calls via `run_command` with `node -e "fetch(..."`, `python -c "requests.get(..."`, or similar patterns. They bypass the sandbox and flood context.
+Instead use:
+- `mcp__context-mode__ctx_execute(language, code)` to run HTTP calls in sandbox — only stdout enters context
+
+### Direct web fetching — FORBIDDEN
+Do NOT use `read_url_content` for large pages. Raw HTML can exceed 100 KB.
+Instead use:
+- `mcp__context-mode__ctx_fetch_and_index(url, source)` then `mcp__context-mode__ctx_search(queries)` to query the indexed content
+
+## REDIRECTED tools — use sandbox equivalents
+
+### Shell (>20 lines output)
+`run_command` is ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`, and other short-output commands.
+For everything else, use:
+- `mcp__context-mode__ctx_batch_execute(commands, queries)` — run multiple commands + search in ONE call
+- `mcp__context-mode__ctx_execute(language: "shell", code: "...")` — run in sandbox, only stdout enters context
+
+### File reading (for analysis)
+If you are reading a file to **edit** it → `view_file` / `replace_file_content` is correct (edit needs content in context).
+If you are reading to **analyze, explore, or summarize** → use `mcp__context-mode__ctx_execute_file(path, language, code)` instead. Only your printed summary enters context. The raw file stays in the sandbox.
+
+### Search (large results)
+Search results can flood context. Use `mcp__context-mode__ctx_execute(language: "shell", code: "grep ...")` to run searches in sandbox. Only your printed summary enters context.
+
+## Tool selection hierarchy
+
+1. **GATHER**: `mcp__context-mode__ctx_batch_execute(commands, queries)` — Primary tool. Runs all commands, auto-indexes output, returns search results. ONE call replaces 30+ individual calls.
+2. **FOLLOW-UP**: `mcp__context-mode__ctx_search(queries: ["q1", "q2", ...])` — Query indexed content. Pass ALL questions as array in ONE call.
+3. **PROCESSING**: `mcp__context-mode__ctx_execute(language, code)` | `mcp__context-mode__ctx_execute_file(path, language, code)` — Sandbox execution. Only stdout enters context.
+4. **WEB**: `mcp__context-mode__ctx_fetch_and_index(url, source)` then `mcp__context-mode__ctx_search(queries)` — Fetch, chunk, index, query. Raw HTML never enters context.
+5. **INDEX**: `mcp__context-mode__ctx_index(content, source)` — Store content in FTS5 knowledge base for later search.
+
+## Output constraints
+
+- Keep responses under 500 words.
+- Write artifacts (code, configs, PRDs) to FILES — never return them as inline text. Return only: file path + 1-line description.
+- When indexing content, use descriptive source labels so others can `search(source: "label")` later.
+
+## ctx commands
+
+| Command | Action |
+|---------|--------|
+| `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 |

package/configs/antigravity/mcp_config.json

@@ -0,0 +1,7 @@
+{
+  "mcpServers": {
+    "context-mode": {
+      "command": "context-mode"
+    }
+  }
+}

package/configs/kiro/mcp_config.json

@@ -0,0 +1,7 @@
+{
+  "mcpServers": {
+    "context-mode": {
+      "command": "context-mode"
+    }
+  }
+}

package/configs/openclaw/AGENTS.md

@@ -0,0 +1,58 @@
+# context-mode — MANDATORY routing rules
+
+You have context-mode MCP tools available. These rules are NOT optional — they protect your context window from flooding. A single unrouted command can dump 56 KB into context and waste the entire session.
+
+## BLOCKED commands — do NOT attempt these
+
+### curl / wget — BLOCKED
+Any shell command containing `curl` or `wget` will be intercepted and blocked by the context-mode plugin. Do NOT retry.
+Instead use:
+- `mcp__context-mode__ctx_fetch_and_index(url, source)` to fetch and index web pages
+- `mcp__context-mode__ctx_execute(language: "javascript", code: "const r = await fetch(...)")` to run HTTP calls in sandbox
+
+### Inline HTTP — BLOCKED
+Any shell command containing `fetch('http`, `requests.get(`, `requests.post(`, `http.get(`, or `http.request(` will be intercepted and blocked. Do NOT retry with shell.
+Instead use:
+- `mcp__context-mode__ctx_execute(language, code)` to run HTTP calls in sandbox — only stdout enters context
+
+### Direct web fetching — BLOCKED
+Do NOT use any direct URL fetching tool. Use the sandbox equivalent.
+Instead use:
+- `mcp__context-mode__ctx_fetch_and_index(url, source)` then `mcp__context-mode__ctx_search(queries)` to query the indexed content
+
+## REDIRECTED tools — use sandbox equivalents
+
+### Shell (>20 lines output)
+Shell is ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`, and other short-output commands.
+For everything else, use:
+- `mcp__context-mode__ctx_batch_execute(commands, queries)` — run multiple commands + search in ONE call
+- `mcp__context-mode__ctx_execute(language: "shell", code: "...")` — run in sandbox, only stdout enters context
+
+### File reading (for analysis)
+If you are reading a file to **edit** it → reading is correct (edit needs content in context).
+If you are reading to **analyze, explore, or summarize** → use `mcp__context-mode__ctx_execute_file(path, language, code)` instead. Only your printed summary enters context.
+
+### grep / search (large results)
+Search results can flood context. Use `mcp__context-mode__ctx_execute(language: "shell", code: "grep ...")` to run searches in sandbox. Only your printed summary enters context.
+
+## Tool selection hierarchy
+
+1. **GATHER**: `mcp__context-mode__ctx_batch_execute(commands, queries)` — Primary tool. Runs all commands, auto-indexes output, returns search results. ONE call replaces 30+ individual calls.
+2. **FOLLOW-UP**: `mcp__context-mode__ctx_search(queries: ["q1", "q2", ...])` — Query indexed content. Pass ALL questions as array in ONE call.
+3. **PROCESSING**: `mcp__context-mode__ctx_execute(language, code)` | `mcp__context-mode__ctx_execute_file(path, language, code)` — Sandbox execution. Only stdout enters context.
+4. **WEB**: `mcp__context-mode__ctx_fetch_and_index(url, source)` then `mcp__context-mode__ctx_search(queries)` — Fetch, chunk, index, query. Raw HTML never enters context.
+5. **INDEX**: `mcp__context-mode__ctx_index(content, source)` — Store content in FTS5 knowledge base for later search.
+
+## Output constraints
+
+- Keep responses under 500 words.
+- Write artifacts (code, configs, PRDs) to FILES — never return them as inline text. Return only: file path + 1-line description.
+- When indexing content, use descriptive source labels so others can `search(source: "label")` later.
+
+## ctx commands
+
+| Command | Action |
+|---------|--------|
+| `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 |

package/configs/openclaw/openclaw.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://openclaw.ai/config.json",
+  "plugins": {
+    "entries": {
+      "context-mode": {
+        "enabled": true
+      }
+    },
+    "slots": {
+      "contextEngine": "context-mode"
+    }
+  }
+}

package/hooks/core/routing.mjs

@@ -102,7 +102,6 @@ const TOOL_ALIASES = {
   "grep_search": "Grep",
   "search_file_content": "Grep",
   "web_fetch": "WebFetch",
-  "activate_skill": "Agent",
   // OpenCode
   "bash": "Bash",
   "view": "Read",
@@ -122,6 +121,10 @@ const TOOL_ALIASES = {
   "Shell": "Bash",
   // VS Code Copilot
   "run_in_terminal": "Bash",
+  // Kiro CLI (https://kiro.dev/docs/cli/hooks/)
+  "fs_read": "Read",
+  "fs_write": "Write",
+  "execute_bash": "Bash",
 };
 
 /**
@@ -226,12 +229,14 @@ export function routePreToolUse(toolName, toolInput, projectDir) {
   // ─── Agent/Task: inject context-mode routing into subagent prompts ───
   if (canonical === "Agent" || canonical === "Task") {
     const subagentType = toolInput.subagent_type ?? "";
-    const prompt = toolInput.prompt ?? "";
+    // Detect the correct field name for the prompt/request/objective/question/query
+    const fieldName = ["prompt", "request", "objective", "question", "query", "task"].find(f => f in toolInput) ?? "prompt";
+    const prompt = toolInput[fieldName] ?? "";
 
     const updatedInput =
       subagentType === "Bash"
-        ? { ...toolInput, prompt: prompt + ROUTING_BLOCK, subagent_type: "general-purpose" }
-        : { ...toolInput, prompt: prompt + ROUTING_BLOCK };
+        ? { ...toolInput, [fieldName]: prompt + ROUTING_BLOCK, subagent_type: "general-purpose" }
+        : { ...toolInput, [fieldName]: prompt + ROUTING_BLOCK };
 
     return { action: "modify", updatedInput };
   }
@@ -240,7 +245,7 @@ export function routePreToolUse(toolName, toolInput, projectDir) {
   // Match both __execute and __ctx_execute (prefixed tool names)
   // Cursor can also surface the tool as MCP:ctx_execute_file.
   if (
-    (toolName.includes("context-mode") && /__(ctx_)?execute$/.test(toolName)) ||
+    (toolName.includes("context-mode") && /(?:__|\/)(ctx_)?execute$/.test(toolName)) ||
     /^MCP:(ctx_)?execute$/.test(toolName)
   ) {
     if (security && toolInput.language === "shell") {
@@ -262,7 +267,7 @@ export function routePreToolUse(toolName, toolInput, projectDir) {
   // ─── MCP execute_file: check file path + code against deny patterns ───
   // Cursor can also surface the tool as MCP:ctx_execute_file.
   if (
-    (toolName.includes("context-mode") && /__(ctx_)?execute_file$/.test(toolName)) ||
+    (toolName.includes("context-mode") && /(?:__|\/)(ctx_)?execute_file$/.test(toolName)) ||
     /^MCP:(ctx_)?execute_file$/.test(toolName)
   ) {
     if (security) {
@@ -294,7 +299,7 @@ export function routePreToolUse(toolName, toolInput, projectDir) {
   }
 
   // ─── MCP batch_execute: check each command individually ───
-  if (toolName.includes("context-mode") && /__(ctx_)?batch_execute$/.test(toolName)) {
+  if (toolName.includes("context-mode") && /(?:__|\/)(ctx_)?batch_execute$/.test(toolName)) {
     if (security) {
       const commands = toolInput.commands ?? [];
       const policies = security.readBashPolicies(projectDir);

package/hooks/kiro/posttooluse.mjs

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+import "../suppress-stderr.mjs";
+/**
+ * Kiro CLI PostToolUse hook — session event capture.
+ * Must be fast (<20ms). No network, no LLM, just SQLite writes.
+ *
+ * Source: https://kiro.dev/docs/cli/hooks/
+ */
+
+import { readStdin, getSessionId, getSessionDBPath, getInputProjectDir, KIRO_OPTS } from "../session-helpers.mjs";
+import { appendFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const HOOK_DIR = dirname(fileURLToPath(import.meta.url));
+const PKG_SESSION = join(HOOK_DIR, "..", "..", "build", "session");
+const OPTS = KIRO_OPTS;
+const DEBUG_LOG = join(homedir(), ".kiro", "context-mode", "posttooluse-debug.log");
+
+try {
+  const raw = await readStdin();
+  const input = JSON.parse(raw);
+
+  appendFileSync(DEBUG_LOG, `[${new Date().toISOString()}] CALL: ${input.tool_name}\n`);
+
+  const { extractEvents } = await import(pathToFileURL(join(PKG_SESSION, "extract.js")).href);
+  const { SessionDB } = await import(pathToFileURL(join(PKG_SESSION, "db.js")).href);
+
+  const dbPath = getSessionDBPath(OPTS);
+  const db = new SessionDB({ dbPath });
+  const sessionId = getSessionId(input, OPTS);
+  const projectDir = getInputProjectDir(input, OPTS);
+
+  db.ensureSession(sessionId, projectDir);
+
+  const events = extractEvents({
+    tool_name: input.tool_name,
+    tool_input: input.tool_input ?? {},
+    tool_response: typeof input.tool_response === "string"
+      ? input.tool_response
+      : JSON.stringify(input.tool_response ?? ""),
+    tool_output: input.tool_output,
+  });
+
+  for (const event of events) {
+    db.insertEvent(sessionId, event, "PostToolUse");
+  }
+
+  appendFileSync(DEBUG_LOG, `[${new Date().toISOString()}] OK: ${input.tool_name} → ${events.length} events\n`);
+  db.close();
+} catch (err) {
+  try {
+    appendFileSync(DEBUG_LOG, `[${new Date().toISOString()}] ERR: ${err?.message || err}\n`);
+  } catch { /* silent */ }
+}
+
+// PostToolUse is non-blocking — no stdout output

package/hooks/kiro/pretooluse.mjs

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+import "../suppress-stderr.mjs";
+/**
+ * Kiro CLI PreToolUse hook for context-mode.
+ * Uses exit codes instead of JSON stdout:
+ *   - Exit 0: allow (stdout → agent context)
+ *   - Exit 2: block (stderr → agent error)
+ *
+ * Source: https://kiro.dev/docs/cli/hooks/
+ */
+
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { readStdin } from "../core/stdin.mjs";
+import { routePreToolUse, initSecurity } from "../core/routing.mjs";
+
+const __hookDir = dirname(fileURLToPath(import.meta.url));
+await initSecurity(resolve(__hookDir, "..", "..", "build"));
+
+const raw = await readStdin();
+const input = JSON.parse(raw);
+// Kiro stdin: { hook_event_name, cwd, tool_name, tool_input }
+const tool = input.tool_name ?? "";
+const toolInput = input.tool_input ?? {};
+const projectDir = input.cwd ?? process.cwd();
+
+const decision = routePreToolUse(tool, toolInput, projectDir);
+
+if (!decision) process.exit(0);
+
+switch (decision.action) {
+  case "deny":
+    process.stderr.write(decision.reason ?? "Blocked by context-mode");
+    process.exit(2);
+    break;
+
+  case "modify":
+    // Kiro CLI cannot modify tool input — deny with redirect message
+    // The updatedInput.command contains an echo "..." wrapper — extract inner message
+    if (typeof decision.updatedInput?.command === "string") {
+      const msg = decision.updatedInput.command
+        .replace(/^echo\s+"?/, "")
+        .replace(/"?\s*$/, "");
+      process.stderr.write(msg);
+    } else {
+      process.stderr.write(decision.reason ?? "Blocked by context-mode routing");
+    }
+    process.exit(2);
+    break;
+
+  case "context":
+    process.stdout.write(decision.additionalContext ?? "");
+    process.exit(0);
+    break;
+
+  case "ask":
+    // Kiro CLI has no "ask" concept — passthrough
+    process.exit(0);
+    break;
+
+  default:
+    process.exit(0);
+}

package/hooks/session-db.bundle.mjs

@@ -1,4 +1,4 @@
-import{createRequire as m}from"node:module";import{unlinkSync as p}from"node:fs";import{tmpdir as _}from"node:os";import{join as T}from"node:path";var E=null;function g(){return E||(E=m(import.meta.url)("better-sqlite3")),E}function R(i){i.pragma("journal_mode = WAL"),i.pragma("synchronous = NORMAL")}function h(i){for(let t of["","-wal","-shm"])try{p(i+t)}catch{}}function d(i){try{i.pragma("wal_checkpoint(TRUNCATE)")}catch{}try{i.close()}catch{}}function c(i="context-mode"){return T(_(),`${i}-${process.pid}.db`)}var a=class{#e;#t;constructor(t){let s=g();this.#e=t,this.#t=new s(t,{timeout:5e3}),R(this.#t),this.initSchema(),this.prepareStatements()}get db(){return this.#t}get dbPath(){return this.#e}close(){d(this.#t)}cleanup(){d(this.#t),h(this.#e)}};import{createHash as y}from"node:crypto";var v=1e3,l=5,e={insertEvent:"insertEvent",getEvents:"getEvents",getEventsByType:"getEventsByType",getEventsByPriority:"getEventsByPriority",getEventsByTypeAndPriority:"getEventsByTypeAndPriority",getEventCount:"getEventCount",checkDuplicate:"checkDuplicate",evictLowestPriority:"evictLowestPriority",updateMetaLastEvent:"updateMetaLastEvent",ensureSession:"ensureSession",getSessionStats:"getSessionStats",incrementCompactCount:"incrementCompactCount",upsertResume:"upsertResume",getResume:"getResume",markResumeConsumed:"markResumeConsumed",deleteEvents:"deleteEvents",deleteMeta:"deleteMeta",deleteResume:"deleteResume",getOldSessions:"getOldSessions"},u=class extends a{constructor(t){super(t?.dbPath??c("session"))}stmt(t){return this.stmts.get(t)}initSchema(){try{let s=this.db.pragma("table_xinfo(session_events)").find(n=>n.name==="data_hash");s&&s.hidden!==0&&this.db.exec("DROP TABLE session_events")}catch{}this.db.exec(`
+import{createRequire as p}from"node:module";import{unlinkSync as _}from"node:fs";import{tmpdir as T}from"node:os";import{join as g}from"node:path";var E=null;function h(){return E||(E=p(import.meta.url)("better-sqlite3")),E}function R(i){i.pragma("journal_mode = WAL"),i.pragma("synchronous = NORMAL")}function S(i){for(let t of["","-wal","-shm"])try{_(i+t)}catch{}}function d(i){try{i.pragma("wal_checkpoint(TRUNCATE)")}catch{}try{i.close()}catch{}}function c(i="context-mode"){return g(T(),`${i}-${process.pid}.db`)}var a=class{#e;#t;constructor(t){let s=h();this.#e=t,this.#t=new s(t,{timeout:5e3}),R(this.#t),this.initSchema(),this.prepareStatements()}get db(){return this.#t}get dbPath(){return this.#e}close(){d(this.#t)}cleanup(){d(this.#t),S(this.#e)}};import{createHash as m}from"node:crypto";import{execFileSync as l}from"node:child_process";function U(){let i=process.env.CONTEXT_MODE_SESSION_SUFFIX;if(i!==void 0)return i?`__${i}`:"";try{let t=process.cwd(),s=l("git",["worktree","list","--porcelain"],{encoding:"utf-8",timeout:2e3,stdio:["ignore","pipe","ignore"]}).split(/\r?\n/).find(n=>n.startsWith("worktree "))?.replace("worktree ","")?.trim();if(s&&t!==s)return`__${m("sha256").update(t).digest("hex").slice(0,8)}`}catch{}return""}var y=1e3,v=5,e={insertEvent:"insertEvent",getEvents:"getEvents",getEventsByType:"getEventsByType",getEventsByPriority:"getEventsByPriority",getEventsByTypeAndPriority:"getEventsByTypeAndPriority",getEventCount:"getEventCount",checkDuplicate:"checkDuplicate",evictLowestPriority:"evictLowestPriority",updateMetaLastEvent:"updateMetaLastEvent",ensureSession:"ensureSession",getSessionStats:"getSessionStats",incrementCompactCount:"incrementCompactCount",upsertResume:"upsertResume",getResume:"getResume",markResumeConsumed:"markResumeConsumed",deleteEvents:"deleteEvents",deleteMeta:"deleteMeta",deleteResume:"deleteResume",getOldSessions:"getOldSessions"},u=class extends a{constructor(t){super(t?.dbPath??c("session"))}stmt(t){return this.stmts.get(t)}initSchema(){try{let s=this.db.pragma("table_xinfo(session_events)").find(n=>n.name==="data_hash");s&&s.hidden!==0&&this.db.exec("DROP TABLE session_events")}catch{}this.db.exec(`
       CREATE TABLE IF NOT EXISTS session_events (
         id INTEGER PRIMARY KEY AUTOINCREMENT,
         session_id TEXT NOT NULL,
@@ -54,4 +54,4 @@ import{createRequire as m}from"node:module";import{unlinkSync as p}from"node:fs"
          snapshot = excluded.snapshot,
          event_count = excluded.event_count,
          created_at = datetime('now'),
-         consumed = 0`),t(e.getResume,"SELECT snapshot, event_count, consumed FROM session_resume WHERE session_id = ?"),t(e.markResumeConsumed,"UPDATE session_resume SET consumed = 1 WHERE session_id = ?"),t(e.deleteEvents,"DELETE FROM session_events WHERE session_id = ?"),t(e.deleteMeta,"DELETE FROM session_meta WHERE session_id = ?"),t(e.deleteResume,"DELETE FROM session_resume WHERE session_id = ?"),t(e.getOldSessions,"SELECT session_id FROM session_meta WHERE started_at < datetime('now', ? || ' days')")}insertEvent(t,s,n="PostToolUse"){let o=y("sha256").update(s.data).digest("hex").slice(0,16).toUpperCase();this.db.transaction(()=>{if(this.stmt(e.checkDuplicate).get(t,l,s.type,o))return;this.stmt(e.getEventCount).get(t).cnt>=v&&this.stmt(e.evictLowestPriority).run(t),this.stmt(e.insertEvent).run(t,s.type,s.category,s.priority,s.data,n,o),this.stmt(e.updateMetaLastEvent).run(t)})()}getEvents(t,s){let n=s?.limit??1e3,o=s?.type,r=s?.minPriority;return o&&r!==void 0?this.stmt(e.getEventsByTypeAndPriority).all(t,o,r,n):o?this.stmt(e.getEventsByType).all(t,o,n):r!==void 0?this.stmt(e.getEventsByPriority).all(t,r,n):this.stmt(e.getEvents).all(t,n)}getEventCount(t){return this.stmt(e.getEventCount).get(t).cnt}ensureSession(t,s){this.stmt(e.ensureSession).run(t,s)}getSessionStats(t){return this.stmt(e.getSessionStats).get(t)??null}incrementCompactCount(t){this.stmt(e.incrementCompactCount).run(t)}upsertResume(t,s,n){this.stmt(e.upsertResume).run(t,s,n??0)}getResume(t){return this.stmt(e.getResume).get(t)??null}markResumeConsumed(t){this.stmt(e.markResumeConsumed).run(t)}deleteSession(t){this.db.transaction(()=>{this.stmt(e.deleteEvents).run(t),this.stmt(e.deleteResume).run(t),this.stmt(e.deleteMeta).run(t)})()}cleanupOldSessions(t=7){let s=`-${t}`,n=this.stmt(e.getOldSessions).all(s);for(let{session_id:o}of n)this.deleteSession(o);return n.length}};export{u as SessionDB};
+         consumed = 0`),t(e.getResume,"SELECT snapshot, event_count, consumed FROM session_resume WHERE session_id = ?"),t(e.markResumeConsumed,"UPDATE session_resume SET consumed = 1 WHERE session_id = ?"),t(e.deleteEvents,"DELETE FROM session_events WHERE session_id = ?"),t(e.deleteMeta,"DELETE FROM session_meta WHERE session_id = ?"),t(e.deleteResume,"DELETE FROM session_resume WHERE session_id = ?"),t(e.getOldSessions,"SELECT session_id FROM session_meta WHERE started_at < datetime('now', ? || ' days')")}insertEvent(t,s,n="PostToolUse"){let r=m("sha256").update(s.data).digest("hex").slice(0,16).toUpperCase();this.db.transaction(()=>{if(this.stmt(e.checkDuplicate).get(t,v,s.type,r))return;this.stmt(e.getEventCount).get(t).cnt>=y&&this.stmt(e.evictLowestPriority).run(t),this.stmt(e.insertEvent).run(t,s.type,s.category,s.priority,s.data,n,r),this.stmt(e.updateMetaLastEvent).run(t)})()}getEvents(t,s){let n=s?.limit??1e3,r=s?.type,o=s?.minPriority;return r&&o!==void 0?this.stmt(e.getEventsByTypeAndPriority).all(t,r,o,n):r?this.stmt(e.getEventsByType).all(t,r,n):o!==void 0?this.stmt(e.getEventsByPriority).all(t,o,n):this.stmt(e.getEvents).all(t,n)}getEventCount(t){return this.stmt(e.getEventCount).get(t).cnt}ensureSession(t,s){this.stmt(e.ensureSession).run(t,s)}getSessionStats(t){return this.stmt(e.getSessionStats).get(t)??null}incrementCompactCount(t){this.stmt(e.incrementCompactCount).run(t)}upsertResume(t,s,n){this.stmt(e.upsertResume).run(t,s,n??0)}getResume(t){return this.stmt(e.getResume).get(t)??null}markResumeConsumed(t){this.stmt(e.markResumeConsumed).run(t)}deleteSession(t){this.db.transaction(()=>{this.stmt(e.deleteEvents).run(t),this.stmt(e.deleteResume).run(t),this.stmt(e.deleteMeta).run(t)})()}cleanupOldSessions(t=7){let s=`-${t}`,n=this.stmt(e.getOldSessions).all(s);for(let{session_id:r}of n)this.deleteSession(r);return n.length}};export{u as SessionDB,U as getWorktreeSuffix};

package/hooks/session-helpers.mjs

@@ -7,11 +7,42 @@
  * configuration. Defaults to Claude Code settings for backward compatibility.
  */
 
+import { execFileSync } from "node:child_process";
 import { createHash } from "node:crypto";
 import { join } from "node:path";
 import { mkdirSync } from "node:fs";
 import { homedir } from "node:os";
 
+/**
+ * Returns the worktree suffix for session path isolation.
+ * Mirrors the logic in src/server.ts — kept in sync manually since
+ * hooks run as plain .mjs (no TypeScript build step).
+ */
+function getWorktreeSuffix() {
+  const envSuffix = process.env.CONTEXT_MODE_SESSION_SUFFIX;
+  if (envSuffix !== undefined) {
+    return envSuffix ? `__${envSuffix}` : "";
+  }
+  try {
+    const cwd = process.cwd();
+    const mainWorktree = execFileSync(
+      "git",
+      ["worktree", "list", "--porcelain"],
+      { encoding: "utf-8", timeout: 2000, stdio: ["ignore", "pipe", "ignore"] },
+    )
+      .split(/\r?\n/)
+      .find((l) => l.startsWith("worktree "))
+      ?.replace("worktree ", "")
+      ?.trim();
+    if (mainWorktree && cwd !== mainWorktree) {
+      return `__${createHash("sha256").update(cwd).digest("hex").slice(0, 8)}`;
+    }
+  } catch {
+    // git not available or not a git repo — no suffix
+  }
+  return "";
+}
+
 /** Claude Code platform options (default). */
 const CLAUDE_OPTS = {
   configDir: ".claude",
@@ -40,6 +71,13 @@ export const CURSOR_OPTS = {
   sessionIdEnv: "CURSOR_SESSION_ID",
 };
 
+/** Kiro CLI platform options. */
+export const KIRO_OPTS = {
+  configDir: ".kiro",
+  projectDirEnv: undefined,   // Kiro CLI provides cwd in hook stdin, no env var
+  sessionIdEnv: undefined,    // No session ID env var — uses ppid fallback
+};
+
 /**
  * Read all of stdin as a string (event-based, cross-platform safe).
  */
@@ -104,7 +142,7 @@ export function getSessionDBPath(opts = CLAUDE_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}.db`);
+  return join(dir, `${hash}${getWorktreeSuffix()}.db`);
 }
 
 /**
@@ -117,7 +155,7 @@ export function getSessionEventsPath(opts = CLAUDE_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}-events.md`);
+  return join(dir, `${hash}${getWorktreeSuffix()}-events.md`);
 }
 
 /**
@@ -130,5 +168,5 @@ export function getCleanupFlagPath(opts = CLAUDE_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}.cleanup`);
+  return join(dir, `${hash}${getWorktreeSuffix()}.cleanup`);
 }

package/openclaw.plugin.json

@@ -0,0 +1,23 @@
+{
+  "id": "context-mode",
+  "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.24",
+  "sandbox": {
+    "mode": "permissive",
+    "filesystem_access": "full",
+    "system_access": "full"
+  },
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "enabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable or disable the context-mode plugin."
+      }
+    },
+    "additionalProperties": false
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.22",
+  "version": "1.0.24",
   "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",
@@ -13,6 +13,7 @@
     "gemini-cli",
     "vscode-copilot",
     "opencode",
+    "openclaw",
     "codex-cli",
     "context-window",
     "sandbox",
@@ -25,11 +26,17 @@
     "url": "https://github.com/mksglu/context-mode"
   },
   "homepage": "https://github.com/mksglu/context-mode#readme",
+  "openclaw": {
+    "extensions": [
+      "./build/openclaw-plugin.js"
+    ]
+  },
   "bugs": "https://github.com/mksglu/context-mode/issues",
   "main": "./build/opencode-plugin.js",
   "exports": {
     ".": "./build/opencode-plugin.js",
     "./plugin": "./build/opencode-plugin.js",
+    "./openclaw": "./build/openclaw-plugin.js",
     "./cli": "./build/cli.js"
   },
   "bin": {
@@ -43,7 +50,9 @@
     "cli.bundle.mjs",
     "skills",
     ".claude-plugin",
+    ".openclaw-plugin",
     ".mcp.json",
+    "openclaw.plugin.json",
     "start.mjs",
     "README.md",
     "LICENSE"
@@ -51,6 +60,8 @@
   "scripts": {
     "build": "tsc && chmod +x build/cli.js",
     "bundle": "esbuild src/server.ts --bundle --platform=node --target=node18 --format=esm --outfile=server.bundle.mjs --external:better-sqlite3 --external:turndown --external:turndown-plugin-gfm --external:@mixmark-io/domino --minify && esbuild src/cli.ts --bundle --platform=node --target=node18 --format=esm --outfile=cli.bundle.mjs --external:better-sqlite3 --minify && esbuild src/session/extract.ts --bundle --platform=node --target=node18 --format=esm --outfile=hooks/session-extract.bundle.mjs --minify && esbuild src/session/snapshot.ts --bundle --platform=node --target=node18 --format=esm --outfile=hooks/session-snapshot.bundle.mjs --minify && esbuild src/session/db.ts --bundle --platform=node --target=node18 --format=esm --outfile=hooks/session-db.bundle.mjs --external:better-sqlite3 --minify",
+    "version-sync": "node scripts/version-sync.mjs",
+    "version": "node scripts/version-sync.mjs && git add .claude-plugin/plugin.json .claude-plugin/marketplace.json .openclaw-plugin/openclaw.plugin.json .openclaw-plugin/package.json openclaw.plugin.json",
     "prepublishOnly": "npm run build",
     "dev": "npx tsx src/server.ts",
     "setup": "npx tsx src/cli.ts setup",