context-mode 1.0.161 → 1.0.163

package/configs/antigravity/GEMINI.md

@@ -24,13 +24,13 @@ Use: `mcp__context-mode__ctx_fetch_and_index(url, source)` then `mcp__context-mo
 
 ### Shell (>20 lines output)
 `run_command` ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`.
-Otherwise: `mcp__context-mode__ctx_batch_execute(commands, queries)` or `mcp__context-mode__ctx_execute(language: "shell", code: "...")`
+Otherwise: `mcp__context-mode__ctx_batch_execute(commands, queries)` or `mcp__context-mode__ctx_execute(language: "javascript", code: "...")`. Use `language: "shell"` only when code matches the host shell.
 
 ### File reading (for analysis)
 Reading to **edit** → `view_file`/`replace_file_content` correct. Reading to **analyze/explore/summarize** → `mcp__context-mode__ctx_execute_file(path, language, code)`.
 
 ### Search (large results)
-Use `mcp__context-mode__ctx_execute(language: "shell", code: "grep ...")` in sandbox.
+Use `mcp__context-mode__ctx_execute(language: "javascript", code: "...")` in sandbox for portable filtering/counting.
 
 ## Tool selection
 

package/configs/antigravity-cli/hooks/hooks.json

@@ -0,0 +1,37 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "run_command|view_file|grep_search|web_fetch|read_url_content",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "context-mode hook antigravity-cli pretooluse"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "context-mode hook antigravity-cli posttooluse"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "context-mode hook antigravity-cli stop"
+          }
+        ]
+      }
+    ]
+  }
+}

package/configs/antigravity-cli/hooks.json

@@ -0,0 +1,37 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "run_command|view_file|grep_search|web_fetch|read_url_content",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "context-mode hook antigravity-cli pretooluse"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "context-mode hook antigravity-cli posttooluse"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "context-mode hook antigravity-cli stop"
+          }
+        ]
+      }
+    ]
+  }
+}

package/configs/antigravity-cli/mcp_config.json

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "context-mode": {
+      "command": "context-mode",
+      "env": {
+        "CONTEXT_MODE_PLATFORM": "antigravity-cli"
+      }
+    }
+  }
+}

package/configs/antigravity-cli/plugin.json

@@ -0,0 +1,14 @@
+{
+  "name": "context-mode",
+  "version": "1.0.163",
+  "description": "context-mode for Antigravity CLI (agy): sandboxed code execution, FTS5 knowledge base, and session capture. Saves your context window by keeping raw bytes out of the conversation.",
+  "author": {
+    "name": "Mert Koseoğlu",
+    "url": "https://github.com/mksglu"
+  },
+  "homepage": "https://github.com/mksglu/context-mode#readme",
+  "license": "Elastic-2.0",
+  "skills": [
+    "./skills/context-mode"
+  ]
+}

package/configs/antigravity-cli/rules/context-mode.md

@@ -0,0 +1,77 @@
+# context-mode routing for Antigravity CLI
+
+context-mode MCP tools are installed for this agy session. Use them when the
+task analyzes, counts, filters, compares, searches, parses, transforms, fetches,
+or otherwise processes data. Raw bytes should stay in the sandbox; only the
+derived answer should enter the conversation.
+
+## Do not dump — derive (most common mistake)
+
+Do NOT use `context-mode/ctx_execute_file` or `ctx_execute` to print a whole file
+or a full method/config (e.g. `print(FILE_CONTENT)`, `cat config.yaml`, dumping a
+281-line file). That defeats the purpose: on agy the tool's stdout is saved to a
+step file that you then read back, so a full dump costs your context window TWICE
+(once in the result, once on the follow-up read). Print only the specific value,
+matches, count, or known line-range you need:
+
+- WRONG: `ctx_execute_file(path:"config.yaml", language:"python", code:"print(FILE_CONTENT)")`
+- RIGHT (value): `code:"import yaml; d=yaml.safe_load(FILE_CONTENT); print(d['active_strategy'])"`
+- RIGHT (matches): `code:"import re;[print(i+1,l) for i,l in enumerate(FILE_CONTENT.splitlines()) if 'active_strategies' in l]"`
+- RIGHT (known slice): `code:"print(chr(10).join(FILE_CONTENT.splitlines()[190:230]))"`
+
+If you truly need to read a small, exact byte range to edit it, native `Read` /
+`view_file` on that range is fine — but never dump an entire file through a hook.
+
+## Tool call surface
+
+Antigravity CLI exposes context-mode tools as `context-mode/<tool>` calls. If
+the host uses the generic MCP wrapper, call `call_mcp_tool` with:
+
+- `ServerName`: `"context-mode"`
+- `ToolName`: `"ctx_execute"`, `"ctx_execute_file"`, `"ctx_batch_execute"`,
+  `"ctx_fetch_and_index"`, `"ctx_search"`, or `"ctx_index"`
+- `Arguments`: a JSON object for that tool
+
+Do not read `~/.gemini/antigravity-cli/mcp/context-mode/*.json` to discover
+schemas. Those files are agy's cached tool schemas and reading them spends
+context. Use these argument shapes instead:
+
+- `context-mode/ctx_execute`: `{"language":"python","code":"..."}`
+- `context-mode/ctx_execute_file`:
+  `{"path":"path/to/file","language":"python","code":"..."}`
+- `context-mode/ctx_batch_execute`:
+  `{"commands":[{"label":"...","command":"..."}],"queries":["..."]}`
+- `context-mode/ctx_fetch_and_index`: `{"url":"https://...","source":"..."}`
+- `context-mode/ctx_search`: `{"queries":["q1","q2"]}`
+- `context-mode/ctx_index`: `{"path":"path/to/file-or-dir","source":"..."}`
+  or `{"content":"...","source":"..."}`
+
+## Mandatory routing
+
+- Think in code. For analyze/count/filter/compare/search/parse/transform tasks,
+  write code with `context-mode/ctx_execute` and print only the final answer.
+  Program the analysis; do not read raw data and compute mentally.
+- File read for analysis: there is no separate `ctx_read` tool.
+  `context-mode/ctx_execute_file` is the context-mode file-read surface. It
+  loads the file into `FILE_CONTENT` inside the sandbox. Print only selected
+  lines, counts, matches, summaries, or structured results. Never print
+  `FILE_CONTENT` wholesale unless the user explicitly asks for a full file dump.
+- Native `Read` / `view_file` is correct when editing requires exact bytes, or
+  when a small known range is needed. For analysis, exploration, summarization,
+  counting, filtering, or searching inside a file, use
+  `context-mode/ctx_execute_file`.
+- Use one `context-mode/ctx_batch_execute` call for multi-command repository
+  reconnaissance. One batch should replace many shell/list/search calls.
+- Use `context-mode/ctx_execute` for shell commands whose output may exceed a
+  short fixed answer. Native Bash is only for git, mkdir, rm, mv, navigation,
+  installs, or short observable output.
+- Use `context-mode/ctx_fetch_and_index` for web content, then
+  `context-mode/ctx_search` to query it. Do not dump raw HTML into the
+  conversation.
+- Use `context-mode/ctx_index` only when content should be stored and searched
+  later. For a one-off file question, prefer `context-mode/ctx_execute_file`;
+  for follow-up retrieval, index with a descriptive `source` and query with
+  `context-mode/ctx_search`.
+- Return only derived answers, concise summaries, selected snippets, or file
+  paths to written artifacts. Do not paste raw command dumps, full files, large
+  search results, cached schemas, or raw HTML into the conversation.

package/configs/antigravity-cli/skills/context-mode/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: context-mode
+description: Mandatory routing rules for Antigravity CLI. Invoke when exploring a codebase, reading files for analysis, listing context-mode tools, searching, parsing, counting, comparing, summarizing, fetching web content, or running data-heavy commands.
+---
+
+# context-mode for Antigravity CLI
+
+context-mode MCP tools are available in agy as `context-mode/<tool>`.
+Use these tools directly. Do not inspect cached schema files under
+`~/.gemini/antigravity-cli/mcp/context-mode/*.json`, and do not run
+`ctx_execute` just to discover tool names or schemas.
+
+If agy uses the generic MCP wrapper, call `call_mcp_tool` with:
+
+- `ServerName`: `"context-mode"`
+- `ToolName`: one of the tool names below
+- `Arguments`: the JSON arguments for that tool
+
+## Tool List
+
+- `context-mode/ctx_execute`: run JavaScript, TypeScript, Python, shell, or
+  other code in a sandbox. Print only the final answer.
+- `context-mode/ctx_execute_file`: read one file into `FILE_CONTENT` inside the
+  sandbox and run code over it. This is the context-mode file-read surface.
+- `context-mode/ctx_batch_execute`: run multiple repository commands in one
+  batch, index large output, and answer follow-up queries.
+- `context-mode/ctx_index`: store a file, directory, or content in the local
+  FTS5 knowledge base for later search.
+- `context-mode/ctx_search`: search indexed content and captured session
+  memory. Batch related questions in `queries`.
+- `context-mode/ctx_fetch_and_index`: fetch web content, store it, then query
+  with `ctx_search`.
+- `context-mode/ctx_stats`: show context savings and current-session stats.
+- `context-mode/ctx_doctor`: diagnose context-mode runtime and hook health.
+- `context-mode/ctx_upgrade`: provide upgrade or repair guidance.
+- `context-mode/ctx_purge`: purge stored context-mode knowledge after
+  confirmation.
+- `context-mode/ctx_insight`: launch or report the Insight analytics app.
+
+When the user asks "what context-mode tools are available", answer from this
+list. Do not list `~/.gemini/antigravity-cli/mcp/context-mode` and do not read
+the JSON schema files.
+
+## File Reading
+
+There is no separate `ctx_read` tool. Use `context-mode/ctx_execute_file` for
+file reads that analyze, summarize, extract, count, filter, or compare.
+
+Native `Read` / `view_file` is only right when editing needs exact bytes in the
+conversation, or when the user explicitly asks to view a small known range.
+
+Use JavaScript by default for lightweight file analysis:
+
+```json
+{
+  "path": "README.md",
+  "language": "javascript",
+  "code": "const lines = FILE_CONTENT.split(/\\r?\\n/); console.log(lines.slice(0, 20).join('\\n'));"
+}
+```
+
+Never print `FILE_CONTENT` wholesale unless the user explicitly asks for a full
+file dump. Print selected lines, counts, matches, summaries, or structured
+results.
+
+## Codebase Exploration
+
+For repository exploration, prefer one `context-mode/ctx_batch_execute` call
+instead of many native `ListDir`, `Read`, `Grep`, or shell calls.
+
+For one-off computed answers, use `context-mode/ctx_execute`.
+For one-file analysis, use `context-mode/ctx_execute_file`.
+For durable recall across follow-up questions, use `context-mode/ctx_index`
+with a descriptive `source`, then `context-mode/ctx_search`.
+
+Return concise derived answers. Do not paste raw command dumps, full files,
+large search results, cached schemas, or raw HTML into the conversation.

package/configs/claude-code/CLAUDE.md

@@ -23,13 +23,13 @@ Use: `ctx_fetch_and_index(url, source)` then `ctx_search(queries)`
 
 ### Bash (>20 lines output)
 Bash ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`.
-Otherwise: `ctx_batch_execute(commands, queries)` or `ctx_execute(language: "shell", code: "...")`
+Otherwise: `ctx_batch_execute(commands, queries)` or `ctx_execute(language: "javascript", code: "...")`. Use `language: "shell"` only when code matches the host shell.
 
 ### Read (for analysis)
 Reading to **Edit** → Read correct. Reading to **analyze/explore/summarize** → `ctx_execute_file(path, language, code)`.
 
 ### Grep — may flood context
-Use `ctx_execute(language: "shell", code: "grep ...")` in sandbox.
+Use `ctx_execute(language: "javascript", code: "...")` in sandbox for portable filtering/counting.
 
 ## Tool selection
 

package/configs/codex/AGENTS.md

@@ -24,13 +24,13 @@ Use: `ctx_fetch_and_index(url, source)` then `ctx_search(queries)`
 
 ### Shell (>20 lines output)
 Shell ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`.
-Otherwise: `ctx_batch_execute(commands, queries)` or `ctx_execute(language: "shell", code: "...")`
+Otherwise: `ctx_batch_execute(commands, queries)` or `ctx_execute(language: "javascript", code: "...")`. Use `language: "shell"` only when code matches the host shell.
 
 ### File reading (for analysis)
 Reading to **edit** → reading correct. Reading to **analyze/explore/summarize** → `ctx_execute_file(path, language, code)`.
 
 ### grep / search (large results)
-Use `ctx_execute(language: "shell", code: "grep ...")` in sandbox.
+Use `ctx_execute(language: "javascript", code: "...")` in sandbox for portable filtering/counting.
 
 ## Tool selection
 

package/configs/copilot-cli/.github/plugin/plugin.json

@@ -0,0 +1,23 @@
+{
+  "name": "context-mode",
+  "description": "context-mode for GitHub Copilot CLI: sandboxed code execution in 11 languages, an FTS5 knowledge base with BM25 ranking, and session capture. Saves your context window by keeping raw bytes out of the conversation.",
+  "version": "1.0.163",
+  "keywords": [
+    "mcp",
+    "context-window",
+    "sandbox",
+    "code-execution",
+    "fts5",
+    "bm25"
+  ],
+  "author": {
+    "name": "Mert Koseoğlu",
+    "url": "https://github.com/mksglu"
+  },
+  "homepage": "https://github.com/mksglu/context-mode#readme",
+  "repository": "https://github.com/mksglu/context-mode",
+  "license": "Elastic-2.0",
+  "skills": [
+    "./skills/context-mode"
+  ]
+}

package/configs/copilot-cli/.mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "context-mode": {
+      "command": "context-mode",
+      "args": [],
+      "env": {
+        "CONTEXT_MODE_PLATFORM": "copilot-cli",
+        "CONTEXT_MODE_COPILOT_PLUGIN": "1"
+      }
+    }
+  }
+}

package/configs/copilot-cli/README.md

@@ -0,0 +1,47 @@
+# context-mode — GitHub Copilot CLI plugin
+
+One-command install of the context-mode MCP server (and routing skill) into
+GitHub Copilot CLI, with **no `context-mode upgrade` / agent call required**:
+
+```sh
+copilot plugin install mksglu/context-mode:configs/copilot-cli
+```
+
+This registers:
+
+- **MCP server** (`.mcp.json`) — exposes the `ctx_*` tools (`ctx_execute`,
+  `ctx_batch_execute`, `ctx_search`, `ctx_fetch_and_index`, …). The server is
+  launched with `CONTEXT_MODE_PLATFORM=copilot-cli`, so it self-identifies as
+  Copilot regardless of any other CLI installed on the machine — `ctx_upgrade`
+  and platform detection resolve `copilot-cli`, never a co-installed Claude Code.
+- **Routing skill** (`skills/context-mode/`) — the MANDATORY "Think in Code"
+  rules that keep raw bytes out of the context window.
+- **Capture hooks** (`hooks.json`) — `preToolUse`, `postToolUse`,
+  `sessionStart`, `userPromptSubmitted`, `agentStop`, `preCompact` (Copilot
+  CLI's camelCase event names — verified against the `@github/copilot` 1.0.60
+  binary; PascalCase keys are silently ignored and never fire), each dispatching
+  `context-mode hook copilot-cli <event>`. Byte-equivalent to what
+  `context-mode upgrade` writes to `~/.copilot/hooks/`, so the plugin registers
+  them with no `upgrade` / agent call.
+
+## Prerequisite
+
+The MCP server runs the global `context-mode` binary (it needs the native
+`better-sqlite3` dependency):
+
+```sh
+npm install -g context-mode
+```
+
+## Alternative (no plugin)
+
+```sh
+copilot mcp add context-mode --env CONTEXT_MODE_PLATFORM=copilot-cli -- context-mode
+```
+
+Then, to also install the capture hooks, run the upgrade **from inside Copilot**
+(so it detects `copilot-cli` via the live MCP client) rather than standalone:
+
+```sh
+copilot -p "Use the context-mode ctx_upgrade tool to install context-mode's hooks." --allow-all
+```

package/configs/copilot-cli/hooks.json

@@ -0,0 +1,41 @@
+{
+  "version": 1,
+  "hooks": {
+    "preToolUse": [
+      {
+        "type": "command",
+        "command": "context-mode hook copilot-cli pretooluse"
+      }
+    ],
+    "postToolUse": [
+      {
+        "type": "command",
+        "command": "context-mode hook copilot-cli posttooluse"
+      }
+    ],
+    "sessionStart": [
+      {
+        "type": "command",
+        "command": "context-mode hook copilot-cli sessionstart"
+      }
+    ],
+    "userPromptSubmitted": [
+      {
+        "type": "command",
+        "command": "context-mode hook copilot-cli userpromptsubmit"
+      }
+    ],
+    "agentStop": [
+      {
+        "type": "command",
+        "command": "context-mode hook copilot-cli stop"
+      }
+    ],
+    "preCompact": [
+      {
+        "type": "command",
+        "command": "context-mode hook copilot-cli precompact"
+      }
+    ]
+  }
+}

package/configs/copilot-cli/skills/context-mode/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: context-mode
+description: MANDATORY routing rules for context-mode. Invoke whenever you analyze, count, filter, compare, search, parse, or transform data; fetch a URL; or run a data-heavy command — so raw bytes stay out of the context window.
+---
+
+# context-mode — MANDATORY routing rules
+
+context-mode MCP tools are available in GitHub Copilot CLI. These rules protect
+the context window from flooding — one unrouted command can dump tens of KB into
+the conversation. Follow them strictly.
+
+## Think in Code — MANDATORY
+
+Analyze / count / filter / compare / search / parse / transform data: **write
+code** via `ctx_execute(language, code)` and `console.log()` only the answer. Do
+NOT read raw data into context. PROGRAM the analysis, do not COMPUTE it by
+reading. One script replaces ten tool calls.
+
+## BLOCKED — do NOT use
+
+- **curl / wget** — dumps raw HTTP into context. Use
+  `ctx_fetch_and_index(url, source)` then `ctx_search(queries)`.
+- **Inline HTTP** (`node -e "fetch(...)"`, `python -c "requests.get(...)"`) — use
+  `ctx_execute(language, code)`; only stdout enters context.
+- **Reading large files to analyze** — use
+  `ctx_execute_file(path, language, code)`.
+
+## Tool selection
+
+1. **GATHER**: `ctx_batch_execute(commands, queries)` — runs all commands,
+   auto-indexes, returns search. One call replaces dozens.
+2. **PROCESS**: `ctx_execute` / `ctx_execute_file` — sandbox; only stdout enters
+   context.
+3. **WEB**: `ctx_fetch_and_index(url, source)` then `ctx_search(queries)` — raw
+   HTML never enters context.
+4. **SEARCH**: `ctx_search(queries: [...])` — all questions in one call.
+
+Write artifacts to FILES; return a path + one-line description, not inline dumps.

package/configs/gemini-cli/GEMINI.md

@@ -23,13 +23,13 @@ Use: `mcp__context-mode__ctx_fetch_and_index(url, source)` then `mcp__context-mo
 
 ### Shell (>20 lines output)
 Shell ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`.
-Otherwise: `mcp__context-mode__ctx_batch_execute(commands, queries)` or `mcp__context-mode__ctx_execute(language: "shell", code: "...")`
+Otherwise: `mcp__context-mode__ctx_batch_execute(commands, queries)` or `mcp__context-mode__ctx_execute(language: "javascript", code: "...")`. Use `language: "shell"` only when code matches the host shell.
 
 ### read_file (for analysis)
 Reading to **edit** → read_file correct. Reading to **analyze/explore/summarize** → `mcp__context-mode__ctx_execute_file(path, language, code)`.
 
 ### grep / search (large results)
-Use `mcp__context-mode__ctx_execute(language: "shell", code: "grep ...")` in sandbox.
+Use `mcp__context-mode__ctx_execute(language: "javascript", code: "...")` in sandbox for portable filtering/counting.
 
 ## Tool selection
 

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

@@ -23,13 +23,13 @@ Use: `ctx_fetch_and_index(url, source)` then `ctx_search(queries)`
 
 ### Terminal / run_in_terminal (>20 lines output)
 Terminal ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`.
-Otherwise: `ctx_batch_execute(commands, queries)` or `ctx_execute(language: "shell", code: "...")`
+Otherwise: `ctx_batch_execute(commands, queries)` or `ctx_execute(language: "javascript", code: "...")`. Use `language: "shell"` only when code matches the host shell.
 
 ### read_file (for analysis)
 Reading to **edit** → read_file correct. Reading to **analyze/explore/summarize** → `ctx_execute_file(path, language, code)`.
 
 ### grep / search (large results)
-Use `ctx_execute(language: "shell", code: "grep ...")` in sandbox.
+Use `ctx_execute(language: "javascript", code: "...")` in sandbox for portable filtering/counting.
 
 ## Tool selection
 

package/configs/kilo/AGENTS.md

@@ -23,13 +23,13 @@ Use: `context-mode_ctx_fetch_and_index(url, source)` then `context-mode_ctx_sear
 
 ### Shell (>20 lines output)
 Shell ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`.
-Otherwise: `context-mode_ctx_batch_execute(commands, queries)` or `context-mode_ctx_execute(language: "shell", code: "...")`
+Otherwise: `context-mode_ctx_batch_execute(commands, queries)` or `context-mode_ctx_execute(language: "javascript", code: "...")`. Use `language: "shell"` only when code matches the host shell.
 
 ### File reading (for analysis)
 Reading to **edit** → reading correct. Reading to **analyze/explore/summarize** → `context-mode_ctx_execute_file(path, language, code)`.
 
 ### grep / search (large results)
-Use `context-mode_ctx_execute(language: "shell", code: "grep ...")` in sandbox.
+Use `context-mode_ctx_execute(language: "javascript", code: "...")` in sandbox for portable filtering/counting.
 
 ## Tool selection
 

package/configs/kiro/KIRO.md

@@ -23,13 +23,13 @@ Use: `@context-mode/ctx_fetch_and_index(url, source)` then `@context-mode/ctx_se
 
 ### Shell (>20 lines output)
 Shell ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`.
-Otherwise: `@context-mode/ctx_batch_execute(commands, queries)` or `@context-mode/ctx_execute(language: "shell", code: "...")`
+Otherwise: `@context-mode/ctx_batch_execute(commands, queries)` or `@context-mode/ctx_execute(language: "javascript", code: "...")`. Use `language: "shell"` only when code matches the host shell.
 
 ### fs_read / read (for analysis)
 Reading to **edit** → fs_read correct. Reading to **analyze/explore/summarize** → `@context-mode/ctx_execute_file(path, language, code)`.
 
 ### grep / search (large results)
-Use `@context-mode/ctx_execute(language: "shell", code: "grep ...")` in sandbox.
+Use `@context-mode/ctx_execute(language: "javascript", code: "...")` in sandbox for portable filtering/counting.
 
 ## Tool selection
 

package/configs/omp/SYSTEM.md

@@ -24,13 +24,13 @@ Use: `ctx_fetch_and_index(url, source)` then `ctx_search(queries)`
 
 ### shell (>20 lines output)
 `shell` ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`.
-Otherwise: `ctx_batch_execute(commands, queries)` or `ctx_execute(language: "shell", code: "...")`
+Otherwise: `ctx_batch_execute(commands, queries)` or `ctx_execute(language: "javascript", code: "...")`. Use `language: "shell"` only when code matches the host shell.
 
 ### read (for analysis)
 Reading to **edit** → `read` correct. Reading to **analyze/explore/summarize** → `ctx_execute_file(path, language, code)`.
 
 ### grep / find (large results)
-Use `ctx_execute(language: "shell", code: "grep ...")` in sandbox.
+Use `ctx_execute(language: "javascript", code: "...")` in sandbox for portable filtering/counting.
 
 ## Tool selection
 

package/configs/openclaw/AGENTS.md

@@ -23,13 +23,13 @@ Use: `context-mode__ctx_fetch_and_index(url, source)` then `context-mode__ctx_se
 
 ### Shell (>20 lines output)
 Shell ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`.
-Otherwise: `context-mode__ctx_batch_execute(commands, queries)` or `context-mode__ctx_execute(language: "shell", code: "...")`
+Otherwise: `context-mode__ctx_batch_execute(commands, queries)` or `context-mode__ctx_execute(language: "javascript", code: "...")`. Use `language: "shell"` only when code matches the host shell.
 
 ### File reading (for analysis)
 Reading to **edit** → reading correct. Reading to **analyze/explore/summarize** → `context-mode__ctx_execute_file(path, language, code)`.
 
 ### grep / search (large results)
-Use `context-mode__ctx_execute(language: "shell", code: "grep ...")` in sandbox.
+Use `context-mode__ctx_execute(language: "javascript", code: "...")` in sandbox for portable filtering/counting.
 
 ## Tool selection
 

package/configs/opencode/AGENTS.md

@@ -23,13 +23,13 @@ Use: `context-mode_ctx_fetch_and_index(url, source)` then `context-mode_ctx_sear
 
 ### Shell (>20 lines output)
 Shell ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`.
-Otherwise: `context-mode_ctx_batch_execute(commands, queries)` or `context-mode_ctx_execute(language: "shell", code: "...")`
+Otherwise: `context-mode_ctx_batch_execute(commands, queries)` or `context-mode_ctx_execute(language: "javascript", code: "...")`. Use `language: "shell"` only when code matches the host shell.
 
 ### File reading (for analysis)
 Reading to **edit** → reading correct. Reading to **analyze/explore/summarize** → `context-mode_ctx_execute_file(path, language, code)`.
 
 ### grep / search (large results)
-Use `context-mode_ctx_execute(language: "shell", code: "grep ...")` in sandbox.
+Use `context-mode_ctx_execute(language: "javascript", code: "...")` in sandbox for portable filtering/counting.
 
 ## Tool selection
 

package/configs/qwen-code/QWEN.md

@@ -23,13 +23,13 @@ Use: `mcp__context-mode__ctx_fetch_and_index(url, source)` then `mcp__context-mo
 
 ### Bash (>20 lines output)
 Bash ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`.
-Otherwise: `mcp__context-mode__ctx_batch_execute(commands, queries)` or `mcp__context-mode__ctx_execute(language: "shell", code: "...")`
+Otherwise: `mcp__context-mode__ctx_batch_execute(commands, queries)` or `mcp__context-mode__ctx_execute(language: "javascript", code: "...")`. Use `language: "shell"` only when code matches the host shell.
 
 ### Read (for analysis)
 Reading to **Edit** → Read correct. Reading to **analyze/explore/summarize** → `mcp__context-mode__ctx_execute_file(path, language, code)`.
 
 ### Grep — may flood context
-Use `mcp__context-mode__ctx_execute(language: "shell", code: "grep ...")` in sandbox.
+Use `mcp__context-mode__ctx_execute(language: "javascript", code: "...")` in sandbox for portable filtering/counting.
 
 ## Tool selection
 

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

@@ -23,13 +23,13 @@ Use: `ctx_fetch_and_index(url, source)` then `ctx_search(queries)`
 
 ### Terminal / run_in_terminal (>20 lines output)
 Terminal ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`.
-Otherwise: `ctx_batch_execute(commands, queries)` or `ctx_execute(language: "shell", code: "...")`
+Otherwise: `ctx_batch_execute(commands, queries)` or `ctx_execute(language: "javascript", code: "...")`. Use `language: "shell"` only when code matches the host shell.
 
 ### read_file (for analysis)
 Reading to **edit** → read_file correct. Reading to **analyze/explore/summarize** → `ctx_execute_file(path, language, code)`.
 
 ### grep / search (large results)
-Use `ctx_execute(language: "shell", code: "grep ...")` in sandbox.
+Use `ctx_execute(language: "javascript", code: "...")` in sandbox for portable filtering/counting.
 
 ## Tool selection
 

package/configs/zed/AGENTS.md

@@ -24,13 +24,13 @@ Use: `mcp:context-mode:ctx_fetch_and_index(url, source)` then `mcp:context-mode:
 
 ### Shell (>20 lines output)
 Shell ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`.
-Otherwise: `mcp:context-mode:ctx_batch_execute(commands, queries)` or `mcp:context-mode:ctx_execute(language: "shell", code: "...")`
+Otherwise: `mcp:context-mode:ctx_batch_execute(commands, queries)` or `mcp:context-mode:ctx_execute(language: "javascript", code: "...")`. Use `language: "shell"` only when code matches the host shell.
 
 ### File reading (for analysis)
 Reading to **edit** → reading correct. Reading to **analyze/explore/summarize** → `mcp:context-mode:ctx_execute_file(path, language, code)`.
 
 ### grep / search (large results)
-Use `mcp:context-mode:ctx_execute(language: "shell", code: "grep ...")` in sandbox.
+Use `mcp:context-mode:ctx_execute(language: "javascript", code: "...")` in sandbox for portable filtering/counting.
 
 ## Tool selection