context-mode 1.0.14 → 1.0.16

package/hooks/cursor/pretooluse.mjs

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import "../suppress-stderr.mjs";
+/**
+ * Cursor preToolUse hook for context-mode.
+ */
+
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { readStdin, getInputProjectDir, CURSOR_OPTS } from "../session-helpers.mjs";
+import { routePreToolUse, initSecurity } from "../core/routing.mjs";
+import { formatDecision } from "../core/formatters.mjs";
+
+const __hookDir = dirname(fileURLToPath(import.meta.url));
+await initSecurity(resolve(__hookDir, "..", "..", "build"));
+
+const raw = await readStdin();
+const input = JSON.parse(raw);
+const tool = input.tool_name ?? "";
+const toolInput = input.tool_input ?? {};
+const projectDir = getInputProjectDir(input, CURSOR_OPTS);
+
+const decision = routePreToolUse(tool, toolInput, projectDir);
+const response = formatDecision("cursor", decision);
+// Cursor treats empty stdout as an invalid hook response,
+// so even passthrough decisions must emit a syntactically valid no-op payload.
+process.stdout.write(JSON.stringify(response ?? { agent_message: "" }) + "\n");

package/hooks/cursor/sessionstart.mjs

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+import "../suppress-stderr.mjs";
+/**
+ * Cursor sessionStart hook for context-mode.
+ */
+
+import { ROUTING_BLOCK } from "../routing-block.mjs";
+import {
+  writeSessionEventsFile,
+  buildSessionDirective,
+  getSessionEvents,
+  getLatestSessionEvents,
+} from "../session-directive.mjs";
+import {
+  readStdin,
+  getSessionId,
+  getSessionDBPath,
+  getSessionEventsPath,
+  getCleanupFlagPath,
+  getInputProjectDir,
+  CURSOR_OPTS,
+} from "../session-helpers.mjs";
+import { join } from "node:path";
+import { readFileSync, writeFileSync, unlinkSync } from "node:fs";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const HOOK_DIR = fileURLToPath(new URL(".", import.meta.url));
+const PKG_SESSION = join(HOOK_DIR, "..", "..", "build", "session");
+const OPTS = CURSOR_OPTS;
+
+let additionalContext = ROUTING_BLOCK;
+
+try {
+  const raw = await readStdin();
+  const input = JSON.parse(raw);
+  const source = input.source ?? input.trigger ?? "startup";
+  const projectDir = getInputProjectDir(input, CURSOR_OPTS);
+
+  if (projectDir && !process.env.CURSOR_CWD) {
+    process.env.CURSOR_CWD = projectDir;
+  }
+
+  if (source === "compact" || source === "resume") {
+    const { SessionDB } = await import(pathToFileURL(join(PKG_SESSION, "db.js")).href);
+    const dbPath = getSessionDBPath(OPTS);
+    const db = new SessionDB({ dbPath });
+
+    if (source === "compact") {
+      const sessionId = getSessionId(input, OPTS);
+      const resume = db.getResume(sessionId);
+      if (resume && !resume.consumed) {
+        db.markResumeConsumed(sessionId);
+      }
+    } else {
+      try { unlinkSync(getCleanupFlagPath(OPTS)); } catch { /* no flag */ }
+    }
+
+    const events = source === "compact"
+      ? getSessionEvents(db, getSessionId(input, OPTS))
+      : getLatestSessionEvents(db);
+    if (events.length > 0) {
+      const eventMeta = writeSessionEventsFile(events, getSessionEventsPath(OPTS));
+      additionalContext += buildSessionDirective(source, eventMeta);
+    }
+
+    db.close();
+  } else if (source === "startup") {
+    const { SessionDB } = await import(pathToFileURL(join(PKG_SESSION, "db.js")).href);
+    const dbPath = getSessionDBPath(OPTS);
+    const db = new SessionDB({ dbPath });
+    try { unlinkSync(getSessionEventsPath(OPTS)); } catch { /* no stale file */ }
+
+    const cleanupFlag = getCleanupFlagPath(OPTS);
+    let previousWasFresh = false;
+    try { readFileSync(cleanupFlag); previousWasFresh = true; } catch { /* no flag */ }
+
+    if (previousWasFresh) {
+      db.cleanupOldSessions(0);
+    } else {
+      db.cleanupOldSessions(7);
+    }
+    db.db.exec(`DELETE FROM session_events WHERE session_id NOT IN (SELECT session_id FROM session_meta)`);
+    writeFileSync(cleanupFlag, new Date().toISOString(), "utf-8");
+
+    const sessionId = getSessionId(input, OPTS);
+    db.ensureSession(sessionId, projectDir);
+
+    db.close();
+  }
+  // clear => routing block only
+} catch {
+  // Cursor treats stderr as hook failure; swallow and continue.
+}
+
+// Cursor treats empty stdout as an invalid hook response,
+// so SessionStart always emits an explicit additional_context payload.
+process.stdout.write(JSON.stringify({ additional_context: additionalContext }) + "\n");

package/hooks/formatters/cursor.mjs

@@ -0,0 +1,37 @@
+/**
+ * Cursor formatter — converts routing decisions into native Cursor hook output.
+ *
+ * Cursor expects flat response objects:
+ *   { permission: "deny" | "ask", user_message?: string }
+ *   { updated_input: { ... } }
+ *   { agent_message: "..." }
+ */
+export function formatDecision(decision) {
+  if (!decision) return null;
+
+  switch (decision.action) {
+    case "deny":
+      return {
+        permission: "deny",
+        user_message: decision.reason ?? "Blocked by context-mode",
+      };
+
+    case "ask":
+      return {
+        permission: "ask",
+      };
+
+    case "modify":
+      return {
+        updated_input: decision.updatedInput,
+      };
+
+    case "context":
+      return {
+        agent_message: decision.additionalContext ?? "",
+      };
+
+    default:
+      return null;
+  }
+}

package/hooks/gemini-cli/sessionstart.mjs

@@ -85,6 +85,13 @@ try {
     const sessionId = getSessionId(input, OPTS);
     const projectDir = getProjectDir(OPTS);
     db.ensureSession(sessionId, projectDir);
+
+    // Auto-write GEMINI.md on startup if missing or not merged yet
+    try {
+      const { GeminiCLIAdapter } = await import(pathToFileURL(join(HOOK_DIR, "..", "..", "build", "adapters", "gemini-cli", "index.js")).href);
+      new GeminiCLIAdapter().writeRoutingInstructions(projectDir, join(HOOK_DIR, "..", ".."));
+    } catch { /* best effort — don't block session start */ }
+
     const ruleFilePaths = [
       join(homedir(), ".gemini", "GEMINI.md"),
       join(projectDir, "GEMINI.md"),

package/hooks/session-helpers.mjs

@@ -33,6 +33,13 @@ export const VSCODE_OPTS = {
   sessionIdEnv: undefined,
 };
 
+/** Cursor platform options. */
+export const CURSOR_OPTS = {
+  configDir: ".cursor",
+  projectDirEnv: "CURSOR_CWD",
+  sessionIdEnv: "CURSOR_SESSION_ID",
+};
+
 /**
  * Read all of stdin as a string (event-based, cross-platform safe).
  */
@@ -55,6 +62,20 @@ export function getProjectDir(opts = CLAUDE_OPTS) {
   return process.env[opts.projectDirEnv] || process.cwd();
 }
 
+/**
+ * Get the project directory from hook input when available.
+ * Falls back to the platform env var and finally process.cwd().
+ */
+export function getInputProjectDir(input, opts = CLAUDE_OPTS) {
+  if (typeof input?.cwd === "string" && input.cwd.length > 0) {
+    return input.cwd;
+  }
+  if (Array.isArray(input?.workspace_roots) && input.workspace_roots.length > 0) {
+    return String(input.workspace_roots[0]);
+  }
+  return getProjectDir(opts);
+}
+
 /**
  * Derive session ID from hook input.
  * Priority: transcript_path UUID > sessionId (camelCase) > session_id > env var > ppid fallback.
@@ -64,6 +85,7 @@ export function getSessionId(input, opts = CLAUDE_OPTS) {
     const match = input.transcript_path.match(/([a-f0-9-]{36})\.jsonl$/);
     if (match) return match[1];
   }
+  if (input.conversation_id) return input.conversation_id;
   if (input.sessionId) return input.sessionId;
   if (input.session_id) return input.session_id;
   if (opts.sessionIdEnv && process.env[opts.sessionIdEnv]) {

package/hooks/vscode-copilot/sessionstart.mjs

@@ -85,6 +85,13 @@ try {
     const sessionId = getSessionId(input, OPTS);
     const projectDir = getProjectDir(OPTS);
     db.ensureSession(sessionId, projectDir);
+
+    // Auto-write copilot-instructions.md on first startup if not present
+    try {
+      const { VSCodeCopilotAdapter } = await import(pathToFileURL(join(HOOK_DIR, "..", "..", "build", "adapters", "vscode-copilot", "index.js")).href);
+      new VSCodeCopilotAdapter().writeRoutingInstructions(projectDir, join(HOOK_DIR, "..", ".."));
+    } catch { /* best effort — don't block session start */ }
+
     const ruleFilePaths = [
       join(projectDir, ".github", "copilot-instructions.md"),
     ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "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",
@@ -81,5 +81,6 @@
     "tsx": "^4.21.0",
     "typescript": "^5.7.0",
     "vitest": "^4.0.18"
-  }
+  },
+  "packageManager": "pnpm@10.23.0+sha512.21c4e5698002ade97e4efe8b8b4a89a8de3c85a37919f957e7a0f30f38fbc5bbdd05980ffe29179b2fb6e6e691242e098d945d1601772cad0fef5fb6411e2a4b"
 }

package/server.bundle.mjs

@@ -79,7 +79,7 @@ ${r}`),n==="elixir"&&gy(Fi(this.#r,"mix.exs"))&&(r=`Path.wildcard(Path.join(${JS
 
 ${r}`);let s=Fi(e,`script.${o[n]}`);return n==="shell"?my(s,r,{encoding:"utf-8",mode:448}):my(s,r,"utf-8"),s}async#a(e,r,n){let o=fr?".exe":"",s=e.replace(/\.rs$/,"")+o;try{_y(`rustc ${e} -o ${s}`,{cwd:r,timeout:Math.min(n,3e4),encoding:"utf-8",stdio:["pipe","pipe","pipe"]})}catch(i){return{stdout:"",stderr:`Compilation failed:
 ${i instanceof Error?i.stderr||i.message:String(i)}`,exitCode:1,timedOut:!1}}return this.#s([s],r,n)}async#s(e,r,n,o=!1){return new Promise(s=>{let i=fr&&["tsx","ts-node","elixir"].includes(e[0]),a=e[0],c;fr&&e.length===2&&e[1]?c=[e[1].replace(/\\/g,"/")]:c=fr?e.slice(1).map(y=>y.replace(/\\/g,"/")):e.slice(1);let u=hR(a,c,{cwd:r,stdio:["ignore","pipe","pipe"],env:this.#c(r),shell:i}),l=!1,d=!1,f=setTimeout(()=>{if(l=!0,o){d=!0,u.pid&&this.#o.add(u.pid),u.unref(),u.stdout.destroy(),u.stderr.destroy();let y=Buffer.concat(m).toString("utf-8"),v=Buffer.concat(p).toString("utf-8"),b=this.#e;s({stdout:Fo(y,b),stderr:Fo(v,b),exitCode:0,timedOut:!0,backgrounded:!0})}else Ld(u)},n),m=[],p=[],h=0,g=!1;u.stdout.on("data",y=>{h+=y.length,h<=this.#t?m.push(y):g||(g=!0,Ld(u))}),u.stderr.on("data",y=>{h+=y.length,h<=this.#t?p.push(y):g||(g=!0,Ld(u))}),u.on("close",y=>{if(clearTimeout(f),d)return;let v=Buffer.concat(m).toString("utf-8"),b=Buffer.concat(p).toString("utf-8");g&&(b+=`
-[output capped at ${(this.#t/1024/1024).toFixed(0)}MB \u2014 process killed]`);let w=this.#e,R=Fo(v,w),ie=Fo(b,w);s({stdout:R,stderr:ie,exitCode:l?1:y??1,timedOut:l})}),u.on("error",y=>{clearTimeout(f),!d&&s({stdout:"",stderr:y.message,exitCode:1,timedOut:!1})})})}#c(e){let r=process.env.HOME??process.env.USERPROFILE??e,n=["GH_TOKEN","GITHUB_TOKEN","GH_HOST","AWS_ACCESS_KEY_ID","AWS_SECRET_ACCESS_KEY","AWS_SESSION_TOKEN","AWS_REGION","AWS_DEFAULT_REGION","AWS_PROFILE","GOOGLE_APPLICATION_CREDENTIALS","CLOUDSDK_CONFIG","DOCKER_HOST","KUBECONFIG","NPM_TOKEN","NODE_AUTH_TOKEN","npm_config_registry","HTTP_PROXY","HTTPS_PROXY","NO_PROXY","SSL_CERT_FILE","CURL_CA_BUNDLE","XDG_CONFIG_HOME","XDG_DATA_HOME","SSH_AUTH_SOCK","SSH_AGENT_PID","DIRENV_DIR","DIRENV_FILE","DIRENV_DIFF","DIRENV_WATCHES","DIRENV_LAYOUT_DIR","NIX_PATH","NIX_PROFILES","NIX_SSL_CERT_FILE","NIX_CC","NIX_STORE","NIX_BUILD_CORES","IN_NIX_SHELL","LOCALE_ARCHIVE","LD_LIBRARY_PATH","DYLD_LIBRARY_PATH","LIBRARY_PATH","C_INCLUDE_PATH","CPLUS_INCLUDE_PATH","PKG_CONFIG_PATH","CMAKE_PREFIX_PATH","GOPATH","GOROOT","CARGO_HOME","RUSTUP_HOME","ASDF_DIR","ASDF_DATA_DIR","MISE_DATA_DIR","VIRTUAL_ENV","CONDA_PREFIX","CONDA_DEFAULT_ENV","PYTHONPATH","GEM_HOME","GEM_PATH","BUNDLE_PATH","RBENV_ROOT","JAVA_HOME","SDKMAN_DIR"],o={PATH:process.env.PATH??(fr?"":"/usr/local/bin:/usr/bin:/bin"),HOME:r,TMPDIR:e,LANG:"en_US.UTF-8",PYTHONDONTWRITEBYTECODE:"1",PYTHONUNBUFFERED:"1",PYTHONUTF8:"1",NO_COLOR:"1"};if(fr){let s=["SYSTEMROOT","SystemRoot","COMSPEC","PATHEXT","USERPROFILE","APPDATA","LOCALAPPDATA","TEMP","TMP"];for(let c of s)process.env[c]&&(o[c]=process.env[c]);o.MSYS_NO_PATHCONV="1",o.MSYS2_ARG_CONV_EXCL="*";let i="C:\\Program Files\\Git\\usr\\bin",a="C:\\Program Files\\Git\\bin";o.PATH.includes(i)||(o.PATH=`${i};${a};${o.PATH}`)}for(let s of n)process.env[s]&&(o[s]=process.env[s]);if(!o.SSL_CERT_FILE){let s=fr?[]:["/etc/ssl/cert.pem","/etc/ssl/certs/ca-certificates.crt","/etc/pki/tls/certs/ca-bundle.crt","/etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem"];for(let i of s)if(gy(i)){o.SSL_CERT_FILE=i;break}}return o}#u(e,r,n){let o=JSON.stringify(e);switch(r){case"javascript":case"typescript":return`const FILE_CONTENT_PATH = ${o};
+[output capped at ${(this.#t/1024/1024).toFixed(0)}MB \u2014 process killed]`);let w=this.#e,R=Fo(v,w),ie=Fo(b,w);s({stdout:R,stderr:ie,exitCode:l?1:y??1,timedOut:l})}),u.on("error",y=>{clearTimeout(f),!d&&s({stdout:"",stderr:y.message,exitCode:1,timedOut:!1})})})}#c(e){let r=process.env.HOME??process.env.USERPROFILE??e,n=["GH_TOKEN","GITHUB_TOKEN","GH_HOST","AWS_ACCESS_KEY_ID","AWS_SECRET_ACCESS_KEY","AWS_SESSION_TOKEN","AWS_REGION","AWS_DEFAULT_REGION","AWS_PROFILE","GOOGLE_APPLICATION_CREDENTIALS","CLOUDSDK_CONFIG","DOCKER_HOST","KUBECONFIG","NPM_TOKEN","NODE_AUTH_TOKEN","npm_config_registry","HTTP_PROXY","HTTPS_PROXY","NO_PROXY","SSL_CERT_FILE","CURL_CA_BUNDLE","NODE_EXTRA_CA_CERTS","REQUESTS_CA_BUNDLE","XDG_CONFIG_HOME","XDG_DATA_HOME","SSH_AUTH_SOCK","SSH_AGENT_PID","DIRENV_DIR","DIRENV_FILE","DIRENV_DIFF","DIRENV_WATCHES","DIRENV_LAYOUT_DIR","NIX_PATH","NIX_PROFILES","NIX_SSL_CERT_FILE","NIX_CC","NIX_STORE","NIX_BUILD_CORES","IN_NIX_SHELL","LOCALE_ARCHIVE","LD_LIBRARY_PATH","DYLD_LIBRARY_PATH","LIBRARY_PATH","C_INCLUDE_PATH","CPLUS_INCLUDE_PATH","PKG_CONFIG_PATH","CMAKE_PREFIX_PATH","GOPATH","GOROOT","CARGO_HOME","RUSTUP_HOME","ASDF_DIR","ASDF_DATA_DIR","MISE_DATA_DIR","VIRTUAL_ENV","CONDA_PREFIX","CONDA_DEFAULT_ENV","PYTHONPATH","GEM_HOME","GEM_PATH","BUNDLE_PATH","RBENV_ROOT","JAVA_HOME","SDKMAN_DIR"],o={PATH:process.env.PATH??(fr?"":"/usr/local/bin:/usr/bin:/bin"),HOME:r,TMPDIR:e,LANG:"en_US.UTF-8",PYTHONDONTWRITEBYTECODE:"1",PYTHONUNBUFFERED:"1",PYTHONUTF8:"1",NO_COLOR:"1"};if(fr){let s=["SYSTEMROOT","SystemRoot","COMSPEC","PATHEXT","USERPROFILE","APPDATA","LOCALAPPDATA","TEMP","TMP"];for(let c of s)process.env[c]&&(o[c]=process.env[c]);o.MSYS_NO_PATHCONV="1",o.MSYS2_ARG_CONV_EXCL="*";let i="C:\\Program Files\\Git\\usr\\bin",a="C:\\Program Files\\Git\\bin";o.PATH.includes(i)||(o.PATH=`${i};${a};${o.PATH}`)}for(let s of n)process.env[s]&&(o[s]=process.env[s]);if(!o.SSL_CERT_FILE){let s=fr?[]:["/etc/ssl/cert.pem","/etc/ssl/certs/ca-certificates.crt","/etc/pki/tls/certs/ca-bundle.crt","/etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem"];for(let i of s)if(gy(i)){o.SSL_CERT_FILE=i;break}}return o}#u(e,r,n){let o=JSON.stringify(e);switch(r){case"javascript":case"typescript":return`const FILE_CONTENT_PATH = ${o};
 const FILE_CONTENT = require("fs").readFileSync(FILE_CONTENT_PATH, "utf-8");
 ${n}`;case"python":return`FILE_CONTENT_PATH = ${o}
 with open(FILE_CONTENT_PATH, "r", encoding="utf-8") as _f:
@@ -227,7 +227,7 @@ stdout:
 ${n}
 
 stderr:
-${o}`}}var lx="1.0.13";process.on("unhandledRejection",t=>{process.stderr.write(`[context-mode] unhandledRejection: ${t}
+${o}`}}var lx="1.0.15";process.on("unhandledRejection",t=>{process.stderr.write(`[context-mode] unhandledRejection: ${t}
 `)});process.on("uncaughtException",t=>{process.stderr.write(`[context-mode] uncaughtException: ${t?.message??t}
 `)});var hp=Ui(),uz=py(hp),Nt=new Zi({name:"context-mode",version:lx}),Wo=new Hi({runtimes:hp,projectRoot:process.env.CLAUDE_PROJECT_DIR}),Dn=null;function lz(t){try{let e=ra(ux(),".claude","context-mode","sessions");if(!cx(e))return;let r=oz(e).filter(n=>n.endsWith("-events.md"));for(let n of r){let o=ra(e,n);try{t.index({path:o,source:"session-events"}),nz(o)}catch{}}}catch{}}function Yo(){return Dn||(Dn=new Vi),lz(Dn),Dn}var qe={calls:{},bytesReturned:{},bytesIndexed:0,bytesSandboxed:0,sessionStart:Date.now()};function J(t,e){let r=e.content.reduce((n,o)=>n+Buffer.byteLength(o.text),0);return qe.calls[t]=(qe.calls[t]||0)+1,qe.bytesReturned[t]=(qe.bytesReturned[t]||0)+r,e}function gr(t){qe.bytesIndexed+=t}function gp(t,e){try{let r=Fd(process.env.CLAUDE_PROJECT_DIR),n=Hd(t,r);if(n.decision==="deny")return J(e,{content:[{type:"text",text:`Command blocked by security policy: matches deny pattern ${n.matchedPattern}`}],isError:!0})}catch{}return null}function dx(t,e,r){try{let n=Iy(t,e);if(n.length===0)return null;let o=Fd(process.env.CLAUDE_PROJECT_DIR);for(let s of n){let i=Hd(s,o);if(i.decision==="deny")return J(r,{content:[{type:"text",text:`Command blocked by security policy: embedded shell command "${s}" matches deny pattern ${i.matchedPattern}`}],isError:!0})}}catch{}return null}function dz(t,e){try{let r=zy("Read",process.env.CLAUDE_PROJECT_DIR),n=Oy(t,r);if(n.denied)return J(e,{content:[{type:"text",text:`File access blocked by security policy: path matches Read deny pattern ${n.matchedPattern}`}],isError:!0})}catch{}return null}var pz=uz.join(", "),fz=Zd()?" (Bun detected \u2014 JS/TS runs 3-5x faster)":"",mz="",hz="";function gz(t){let e=[],r=0,n=0;for(;n<t.length;)if(t[n]===mz){for(e.push(r),n++;n<t.length&&t[n]!==hz;)r++,n++;n<t.length&&n++}else r++,n++;return e}function px(t,e,r=1500,n){if(t.length<=r)return t;let o=[];if(n)for(let u of gz(n))o.push(u);if(o.length===0){let u=e.toLowerCase().split(/\s+/).filter(d=>d.length>2),l=t.toLowerCase();for(let d of u){let f=l.indexOf(d);for(;f!==-1;)o.push(f),f=l.indexOf(d,f+1)}}if(o.length===0)return t.slice(0,r)+`
 \u2026`;o.sort((u,l)=>u-l);let s=300,i=[];for(let u of o){let l=Math.max(0,u-s),d=Math.min(t.length,u+s);i.length>0&&l<=i[i.length-1][1]?i[i.length-1][1]=d:i.push([l,d])}let a=[],c=0;for(let[u,l]of i){if(c>=r)break;let d=t.slice(u,Math.min(l,u+(r-c)));a.push((u>0?"\u2026":"")+d+(l<t.length?"\u2026":"")),c+=d.length}return a.join(`

package/skills/context-mode/SKILL.md

@@ -2,21 +2,19 @@
 name: context-mode
 description: |
   Use context-mode tools (ctx_execute, ctx_execute_file) instead of Bash/cat when processing
-  large outputs. Trigger phrases: "analyze logs", "summarize output", "process data",
+  large outputs. Triggers: "analyze logs", "summarize output", "process data",
   "parse JSON", "filter results", "extract errors", "check build output",
   "analyze dependencies", "process API response", "large file analysis",
-  "extract elements", "page snapshot", "browser snapshot", "take a snapshot",
-  "DOM structure", "inspect page", "form fields", "element selectors",
-  "web page structure", "accessibility tree", "Playwright snapshot",
+  "page snapshot", "browser snapshot", "DOM structure", "inspect page",
+  "accessibility tree", "Playwright snapshot",
   "run tests", "test output", "coverage report", "git log", "recent commits",
   "diff between branches", "list containers", "pod status", "disk usage",
-  "fetch docs", "API reference", "index documentation", "hit endpoint",
-  "call API", "check response", "query results", "show tables",
+  "fetch docs", "API reference", "index documentation",
+  "call API", "check response", "query results",
   "find TODOs", "count lines", "codebase statistics", "security audit",
   "outdated packages", "dependency tree", "cloud resources", "CI/CD output".
-  Also triggers on ANY MCP tool output (Playwright, Context7, GitHub API) that
-  may exceed 20 lines, and any operation where output size is uncertain.
-  Subagent routing is handled automatically via PreToolUse hook — no manual tool names needed in prompts.
+  Also triggers on ANY MCP tool output that may exceed 20 lines.
+  Subagent routing is handled automatically via PreToolUse hook.
 ---
 
 # Context Mode: Default for All Large Output

package/skills/ctx-cloud-setup/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: ctx-cloud-setup
+description: |
+  Connect context-mode to Context Mode Cloud.
+  Guides through API URL, token, and org ID configuration.
+  Saves config to ~/.context-mode/sync.json and tests the connection.
+  Trigger: /context-mode:ctx-cloud-setup
+user-invocable: true
+---
+
+# Context Mode Cloud Setup
+
+Interactive onboarding flow to connect this plugin to Context Mode Cloud.
+
+## Instructions
+
+1. **Check existing config** — read `~/.context-mode/sync.json` using Bash:
+   ```
+   cat ~/.context-mode/sync.json 2>/dev/null || echo "NOT_FOUND"
+   ```
+   - If the file exists and contains a non-empty `api_token`, inform the user that cloud sync is **already configured** and show the current `api_url` and `organization_id` (never reveal the token — show only the last 4 characters masked as `ctx_****abcd`).
+   - Ask if they want to **reconfigure** or **keep the current settings**. If they want to keep, stop here.
+
+2. **Collect configuration** — ask the user for three values, one at a time:
+
+   **a) API URL**
+   - Default: `https://api.context-mode.com`
+   - Tell the user: *"Press Enter to use the default, or paste your self-hosted API URL."*
+   - If the user says "default", use `https://api.context-mode.com`.
+
+   **b) API Token**
+   - Tell the user: *"Paste your API token from the Context Mode dashboard: **Settings > API Tokens**."*
+   - This field is **required** — do not proceed without it.
+   - Validate format: token should start with `ctx_` and be at least 20 characters. If invalid, warn and ask again.
+
+   **c) Organization ID**
+   - Tell the user: *"Paste your Organization ID from the dashboard: **Settings > Team**."*
+   - This field is **required** — do not proceed without it.
+
+3. **Save config** — write the merged config to `~/.context-mode/sync.json` using Bash:
+   ```bash
+   mkdir -p ~/.context-mode
+   cat > ~/.context-mode/sync.json << 'JSONEOF'
+   {
+     "enabled": true,
+     "api_url": "<API_URL>",
+     "api_token": "<API_TOKEN>",
+     "organization_id": "<ORG_ID>",
+     "batch_size": 50,
+     "flush_interval_ms": 30000
+   }
+   JSONEOF
+   chmod 600 ~/.context-mode/sync.json
+   ```
+   Replace `<API_URL>`, `<API_TOKEN>`, and `<ORG_ID>` with the collected values.
+
+4. **Test the connection** — send a health check using Bash:
+   ```bash
+   curl -sf -o /dev/null -w "%{http_code}" \
+     -H "Authorization: Bearer <API_TOKEN>" \
+     "<API_URL>/api/health"
+   ```
+   - `200` = success
+   - Any other code or failure = connection error
+
+5. **Display results** as markdown directly in the conversation:
+
+   On **success**:
+   ```
+   ## context-mode cloud setup
+   - [x] Config saved to ~/.context-mode/sync.json
+   - [x] Connection test: PASS (200 OK)
+   - [x] Organization: <ORG_ID>
+
+   Cloud sync is now active. Events will be sent to the dashboard
+   on your next Claude Code session. Run `/ctx-cloud-status` to
+   check sync health at any time.
+   ```
+
+   On **failure**:
+   ```
+   ## context-mode cloud setup
+   - [x] Config saved to ~/.context-mode/sync.json
+   - [ ] Connection test: FAIL (<error details>)
+
+   Config was saved but the connection test failed. Check that:
+   1. Your API URL is reachable
+   2. Your API token is valid and not expired
+   3. Your network allows outbound HTTPS
+
+   Run `/ctx-cloud-setup` again to reconfigure.
+   ```
+
+## Security Notes
+
+- Never log or display the full API token. Always mask it.
+- Set file permissions to `600` (owner read/write only).
+- The token is sent only over HTTPS in the `Authorization` header.

package/skills/ctx-cloud-status/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: ctx-cloud-status
+description: |
+  Show current Context Mode Cloud sync status.
+  Displays connection health, sync config, and event statistics.
+  Trigger: /context-mode:ctx-cloud-status
+user-invocable: true
+---
+
+# Context Mode Cloud Status
+
+Display the current cloud sync configuration, connection health, and event statistics.
+
+## Instructions
+
+1. **Read sync config** using Bash:
+   ```
+   cat ~/.context-mode/sync.json 2>/dev/null || echo "NOT_CONFIGURED"
+   ```
+
+2. **If not configured** (file missing or empty), display:
+   ```
+   ## context-mode cloud status
+   - [ ] Cloud sync: NOT CONFIGURED
+
+   Run `/ctx-cloud-setup` to connect to Context Mode Cloud.
+   ```
+   Stop here.
+
+3. **If configured**, extract the config values. **Never display the full API token** — mask it as `ctx_****<last4>`.
+
+4. **Run health check** using Bash:
+   ```bash
+   curl -sf -o /dev/null -w "%{http_code}" \
+     -H "Authorization: Bearer <API_TOKEN>" \
+     "<API_URL>/api/health"
+   ```
+
+5. **Check sync stats** — read the stats file if it exists:
+   ```
+   cat ~/.context-mode/sync-stats.json 2>/dev/null || echo "NO_STATS"
+   ```
+   This file may contain: `events_sent`, `last_sync_at`, `errors_count`, `last_error`.
+
+6. **Display results** as markdown directly in the conversation:
+
+   ```
+   ## context-mode cloud status
+
+   ### Connection
+   - [x] Cloud sync: ENABLED
+   - [x] API URL: https://api.context-mode.com
+   - [x] API Token: ctx_****abcd
+   - [x] Organization: org_abc123
+   - [x] Health check: PASS (200 OK)
+
+   ### Sync Settings
+   - Batch size: 50
+   - Flush interval: 30s
+
+   ### Statistics
+   - Events sent: 1,247
+   - Last sync: 2 minutes ago
+   - Errors: 0
+   ```
+
+   Use `[x]` for healthy items, `[ ]` for issues, `[-]` for warnings.
+
+   **Variations:**
+
+   - If `enabled` is `false`:
+     ```
+     - [-] Cloud sync: DISABLED (config exists but sync is turned off)
+     ```
+
+   - If health check fails:
+     ```
+     - [ ] Health check: FAIL (<http_code> or connection error)
+     ```
+
+   - If no stats file exists:
+     ```
+     ### Statistics
+     - No sync data yet. Events will appear after the next Claude Code session.
+     ```
+
+   - If there are recent errors:
+     ```
+     - [-] Errors: 3 (last: "Sync failed: 401 Unauthorized")
+     ```
+
+7. **Actionable guidance** — after the status display, add context-specific advice:
+   - If everything is healthy: *"Cloud sync is working normally."*
+   - If health check fails: *"Run `/ctx-cloud-setup` to reconfigure your connection."*
+   - If sync is disabled: *"To re-enable, set `enabled: true` in `~/.context-mode/sync.json`."*
+   - If errors are present: *"Check your API token validity in the dashboard: **Settings > API Tokens**."*

package/skills/ctx-doctor/SKILL.md

@@ -4,7 +4,7 @@ description: |
   Run context-mode diagnostics. Checks runtimes, hooks, FTS5,
   plugin registration, npm and marketplace versions.
   Trigger: /context-mode:ctx-doctor
-user_invocable: true
+user-invocable: true
 ---
 
 # Context Mode Doctor

package/skills/ctx-stats/SKILL.md

@@ -4,7 +4,7 @@ description: |
   Show how much context window context-mode saved this session.
   Displays token consumption, context savings ratio, and per-tool breakdown.
   Trigger: /context-mode:ctx-stats
-user_invocable: true
+user-invocable: true
 ---
 
 # Context Mode Stats

package/skills/ctx-upgrade/SKILL.md

@@ -4,7 +4,7 @@ description: |
   Update context-mode from GitHub and fix hooks/settings.
   Pulls latest, builds, installs, updates npm global, configures hooks.
   Trigger: /context-mode:ctx-upgrade
-user_invocable: true
+user-invocable: true
 ---
 
 # Context Mode Upgrade