context-mode 1.0.169 → 2.0.0-next.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (382) hide show
  1. package/.claude-plugin/marketplace.json +4 -22
  2. package/.claude-plugin/plugin.json +9 -24
  3. package/.codex-plugin/hooks.json +18 -33
  4. package/.codex-plugin/mcp.json +5 -4
  5. package/.codex-plugin/plugin.json +8 -27
  6. package/SHA256SUMS +37 -0
  7. package/claude-code/skills/ctx-doctor/SKILL.md +6 -0
  8. package/claude-code/skills/ctx-stats/SKILL.md +6 -0
  9. package/claude-code/skills/ctx-upgrade/SKILL.md +6 -0
  10. package/cli.mjs +6859 -0
  11. package/codex/skills/ctx-doctor/SKILL.md +6 -0
  12. package/codex/skills/ctx-stats/SKILL.md +6 -0
  13. package/codex/skills/ctx-upgrade/SKILL.md +6 -0
  14. package/copilot/plugin.json +14 -0
  15. package/fixtures/hook-roundtrip.json +22 -0
  16. package/gemini-extension.json +14 -0
  17. package/hook.mjs +202 -0
  18. package/hooks/claude-code.json +50 -0
  19. package/hooks/codex.json +50 -0
  20. package/hooks/copilot-cli.json +33 -0
  21. package/hooks/hooks.json +16 -111
  22. package/hooks/kiro.json +69 -0
  23. package/hooks/qwen.json +50 -0
  24. package/hooks/vscode.json +40 -0
  25. package/hooks/zcode.json +53 -0
  26. package/opencode/plugin.js +22491 -0
  27. package/package.json +32 -114
  28. package/pi/index.js +50876 -0
  29. package/pi/skills/ctx-doctor/SKILL.md +6 -0
  30. package/pi/skills/ctx-stats/SKILL.md +6 -0
  31. package/pi/skills/ctx-upgrade/SKILL.md +6 -0
  32. package/qwen-extension.json +15 -0
  33. package/run.mjs +5639 -0
  34. package/search.mjs +5639 -0
  35. package/server.mjs +48214 -0
  36. package/skills/ctx-doctor/SKILL.md +3 -19
  37. package/skills/ctx-stats/SKILL.md +3 -23
  38. package/skills/ctx-upgrade/SKILL.md +3 -28
  39. package/.openclaw-plugin/index.ts +0 -12
  40. package/.openclaw-plugin/openclaw.plugin.json +0 -38
  41. package/.openclaw-plugin/package.json +0 -28
  42. package/LICENSE +0 -94
  43. package/README.md +0 -1619
  44. package/bin/statusline.mjs +0 -378
  45. package/build/adapters/antigravity/index.d.ts +0 -51
  46. package/build/adapters/antigravity/index.js +0 -169
  47. package/build/adapters/antigravity-cli/index.d.ts +0 -51
  48. package/build/adapters/antigravity-cli/index.js +0 -342
  49. package/build/adapters/base.d.ts +0 -92
  50. package/build/adapters/base.js +0 -135
  51. package/build/adapters/claude-code/config.d.ts +0 -8
  52. package/build/adapters/claude-code/config.js +0 -8
  53. package/build/adapters/claude-code/hooks.d.ts +0 -106
  54. package/build/adapters/claude-code/hooks.js +0 -183
  55. package/build/adapters/claude-code/index.d.ts +0 -80
  56. package/build/adapters/claude-code/index.js +0 -569
  57. package/build/adapters/claude-code-base.d.ts +0 -49
  58. package/build/adapters/claude-code-base.js +0 -113
  59. package/build/adapters/client-map.d.ts +0 -10
  60. package/build/adapters/client-map.js +0 -42
  61. package/build/adapters/codex/config.d.ts +0 -8
  62. package/build/adapters/codex/config.js +0 -8
  63. package/build/adapters/codex/hooks.d.ts +0 -55
  64. package/build/adapters/codex/hooks.js +0 -64
  65. package/build/adapters/codex/index.d.ts +0 -87
  66. package/build/adapters/codex/index.js +0 -992
  67. package/build/adapters/codex/paths.d.ts +0 -1
  68. package/build/adapters/codex/paths.js +0 -12
  69. package/build/adapters/codex/usage.d.ts +0 -107
  70. package/build/adapters/codex/usage.js +0 -227
  71. package/build/adapters/copilot-base.d.ts +0 -94
  72. package/build/adapters/copilot-base.js +0 -297
  73. package/build/adapters/copilot-cli/hooks.d.ts +0 -33
  74. package/build/adapters/copilot-cli/hooks.js +0 -64
  75. package/build/adapters/copilot-cli/index.d.ts +0 -48
  76. package/build/adapters/copilot-cli/index.js +0 -341
  77. package/build/adapters/cursor/config.d.ts +0 -4
  78. package/build/adapters/cursor/config.js +0 -4
  79. package/build/adapters/cursor/hooks.d.ts +0 -55
  80. package/build/adapters/cursor/hooks.js +0 -82
  81. package/build/adapters/cursor/index.d.ts +0 -64
  82. package/build/adapters/cursor/index.js +0 -517
  83. package/build/adapters/detect.d.ts +0 -136
  84. package/build/adapters/detect.js +0 -623
  85. package/build/adapters/gemini-cli/config.d.ts +0 -8
  86. package/build/adapters/gemini-cli/config.js +0 -8
  87. package/build/adapters/gemini-cli/hooks.d.ts +0 -83
  88. package/build/adapters/gemini-cli/hooks.js +0 -115
  89. package/build/adapters/gemini-cli/index.d.ts +0 -80
  90. package/build/adapters/gemini-cli/index.js +0 -483
  91. package/build/adapters/jetbrains-copilot/config.d.ts +0 -8
  92. package/build/adapters/jetbrains-copilot/config.js +0 -8
  93. package/build/adapters/jetbrains-copilot/hooks.d.ts +0 -59
  94. package/build/adapters/jetbrains-copilot/hooks.js +0 -87
  95. package/build/adapters/jetbrains-copilot/index.d.ts +0 -31
  96. package/build/adapters/jetbrains-copilot/index.js +0 -131
  97. package/build/adapters/kimi/config.d.ts +0 -8
  98. package/build/adapters/kimi/config.js +0 -8
  99. package/build/adapters/kimi/hooks.d.ts +0 -28
  100. package/build/adapters/kimi/hooks.js +0 -34
  101. package/build/adapters/kimi/index.d.ts +0 -66
  102. package/build/adapters/kimi/index.js +0 -537
  103. package/build/adapters/kimi/paths.d.ts +0 -21
  104. package/build/adapters/kimi/paths.js +0 -52
  105. package/build/adapters/kimi/usage.d.ts +0 -82
  106. package/build/adapters/kimi/usage.js +0 -217
  107. package/build/adapters/kiro/hooks.d.ts +0 -61
  108. package/build/adapters/kiro/hooks.js +0 -94
  109. package/build/adapters/kiro/index.d.ts +0 -61
  110. package/build/adapters/kiro/index.js +0 -301
  111. package/build/adapters/omp/index.d.ts +0 -65
  112. package/build/adapters/omp/index.js +0 -182
  113. package/build/adapters/omp/plugin.d.ts +0 -81
  114. package/build/adapters/omp/plugin.js +0 -331
  115. package/build/adapters/omp/usage.d.ts +0 -49
  116. package/build/adapters/omp/usage.js +0 -110
  117. package/build/adapters/openclaw/config.d.ts +0 -8
  118. package/build/adapters/openclaw/config.js +0 -8
  119. package/build/adapters/openclaw/hooks.d.ts +0 -50
  120. package/build/adapters/openclaw/hooks.js +0 -61
  121. package/build/adapters/openclaw/index.d.ts +0 -74
  122. package/build/adapters/openclaw/index.js +0 -439
  123. package/build/adapters/openclaw/mcp-tools.d.ts +0 -54
  124. package/build/adapters/openclaw/mcp-tools.js +0 -207
  125. package/build/adapters/openclaw/plugin.d.ts +0 -141
  126. package/build/adapters/openclaw/plugin.js +0 -818
  127. package/build/adapters/openclaw/session-db.d.ts +0 -55
  128. package/build/adapters/openclaw/session-db.js +0 -88
  129. package/build/adapters/openclaw/usage.d.ts +0 -34
  130. package/build/adapters/openclaw/usage.js +0 -52
  131. package/build/adapters/openclaw/workspace-router.d.ts +0 -29
  132. package/build/adapters/openclaw/workspace-router.js +0 -64
  133. package/build/adapters/opencode/config.d.ts +0 -8
  134. package/build/adapters/opencode/config.js +0 -8
  135. package/build/adapters/opencode/hooks.d.ts +0 -38
  136. package/build/adapters/opencode/hooks.js +0 -50
  137. package/build/adapters/opencode/index.d.ts +0 -67
  138. package/build/adapters/opencode/index.js +0 -463
  139. package/build/adapters/opencode/plugin.d.ts +0 -184
  140. package/build/adapters/opencode/plugin.js +0 -558
  141. package/build/adapters/opencode/zod3tov4.d.ts +0 -1
  142. package/build/adapters/opencode/zod3tov4.js +0 -132
  143. package/build/adapters/pi/extension.d.ts +0 -81
  144. package/build/adapters/pi/extension.js +0 -861
  145. package/build/adapters/pi/index.d.ts +0 -57
  146. package/build/adapters/pi/index.js +0 -173
  147. package/build/adapters/pi/mcp-bridge.d.ts +0 -268
  148. package/build/adapters/pi/mcp-bridge.js +0 -894
  149. package/build/adapters/qwen-code/hooks.d.ts +0 -26
  150. package/build/adapters/qwen-code/hooks.js +0 -29
  151. package/build/adapters/qwen-code/index.d.ts +0 -40
  152. package/build/adapters/qwen-code/index.js +0 -361
  153. package/build/adapters/qwen-code/usage.d.ts +0 -90
  154. package/build/adapters/qwen-code/usage.js +0 -222
  155. package/build/adapters/types.d.ts +0 -360
  156. package/build/adapters/types.js +0 -118
  157. package/build/adapters/vscode-copilot/config.d.ts +0 -8
  158. package/build/adapters/vscode-copilot/config.js +0 -8
  159. package/build/adapters/vscode-copilot/hooks.d.ts +0 -71
  160. package/build/adapters/vscode-copilot/hooks.js +0 -98
  161. package/build/adapters/vscode-copilot/index.d.ts +0 -32
  162. package/build/adapters/vscode-copilot/index.js +0 -222
  163. package/build/adapters/zed/index.d.ts +0 -40
  164. package/build/adapters/zed/index.js +0 -163
  165. package/build/cli.d.ts +0 -34
  166. package/build/cli.js +0 -1827
  167. package/build/db-base.d.ts +0 -179
  168. package/build/db-base.js +0 -569
  169. package/build/executor.d.ts +0 -72
  170. package/build/executor.js +0 -678
  171. package/build/exit-classify.d.ts +0 -19
  172. package/build/exit-classify.js +0 -12
  173. package/build/fetch-cache.d.ts +0 -13
  174. package/build/fetch-cache.js +0 -15
  175. package/build/lifecycle.d.ts +0 -124
  176. package/build/lifecycle.js +0 -278
  177. package/build/runPool.d.ts +0 -36
  178. package/build/runPool.js +0 -51
  179. package/build/runtime.d.ts +0 -71
  180. package/build/runtime.js +0 -659
  181. package/build/search/auto-memory.d.ts +0 -47
  182. package/build/search/auto-memory.js +0 -170
  183. package/build/search/ctx-search-schema.d.ts +0 -90
  184. package/build/search/ctx-search-schema.js +0 -135
  185. package/build/search/flood-guard.d.ts +0 -57
  186. package/build/search/flood-guard.js +0 -80
  187. package/build/search/unified.d.ts +0 -56
  188. package/build/search/unified.js +0 -104
  189. package/build/security.d.ts +0 -206
  190. package/build/security.js +0 -780
  191. package/build/server.d.ts +0 -184
  192. package/build/server.js +0 -4563
  193. package/build/session/analytics.d.ts +0 -773
  194. package/build/session/analytics.js +0 -2420
  195. package/build/session/db.d.ts +0 -468
  196. package/build/session/db.js +0 -1308
  197. package/build/session/error-classifier.d.ts +0 -87
  198. package/build/session/error-classifier.js +0 -303
  199. package/build/session/event-emit.d.ts +0 -48
  200. package/build/session/event-emit.js +0 -101
  201. package/build/session/extract.d.ts +0 -333
  202. package/build/session/extract.js +0 -2688
  203. package/build/session/model-prices.json +0 -429
  204. package/build/session/persist-tool-calls.d.ts +0 -54
  205. package/build/session/persist-tool-calls.js +0 -105
  206. package/build/session/pricing.d.ts +0 -64
  207. package/build/session/pricing.js +0 -151
  208. package/build/session/project-attribution.d.ts +0 -73
  209. package/build/session/project-attribution.js +0 -245
  210. package/build/session/purge.d.ts +0 -138
  211. package/build/session/purge.js +0 -240
  212. package/build/session/retrieval-marker.d.ts +0 -39
  213. package/build/session/retrieval-marker.js +0 -65
  214. package/build/session/snapshot.d.ts +0 -46
  215. package/build/session/snapshot.js +0 -532
  216. package/build/store-directory.d.ts +0 -56
  217. package/build/store-directory.js +0 -254
  218. package/build/store.d.ts +0 -147
  219. package/build/store.js +0 -1714
  220. package/build/truncate.d.ts +0 -57
  221. package/build/truncate.js +0 -142
  222. package/build/types.d.ts +0 -117
  223. package/build/types.js +0 -20
  224. package/build/util/claude-config.d.ts +0 -32
  225. package/build/util/claude-config.js +0 -84
  226. package/build/util/hook-config.d.ts +0 -27
  227. package/build/util/hook-config.js +0 -76
  228. package/build/util/jsonc.d.ts +0 -14
  229. package/build/util/jsonc.js +0 -104
  230. package/build/util/plugin-cache-integrity.d.ts +0 -51
  231. package/build/util/plugin-cache-integrity.js +0 -146
  232. package/build/util/project-dir.d.ts +0 -149
  233. package/build/util/project-dir.js +0 -340
  234. package/build/util/sibling-mcp.d.ts +0 -79
  235. package/build/util/sibling-mcp.js +0 -181
  236. package/cli.bundle.mjs +0 -1236
  237. package/configs/antigravity/GEMINI.md +0 -68
  238. package/configs/antigravity/mcp_config.json +0 -7
  239. package/configs/antigravity-cli/hooks/hooks.json +0 -37
  240. package/configs/antigravity-cli/hooks.json +0 -37
  241. package/configs/antigravity-cli/mcp_config.json +0 -10
  242. package/configs/antigravity-cli/plugin.json +0 -14
  243. package/configs/antigravity-cli/rules/context-mode.md +0 -77
  244. package/configs/antigravity-cli/skills/context-mode/SKILL.md +0 -77
  245. package/configs/claude-code/CLAUDE.md +0 -91
  246. package/configs/codex/AGENTS.md +0 -99
  247. package/configs/codex/config.toml +0 -8
  248. package/configs/codex/hooks.json +0 -47
  249. package/configs/copilot-cli/.github/plugin/plugin.json +0 -23
  250. package/configs/copilot-cli/.mcp.json +0 -12
  251. package/configs/copilot-cli/README.md +0 -47
  252. package/configs/copilot-cli/hooks.json +0 -41
  253. package/configs/copilot-cli/skills/context-mode/SKILL.md +0 -38
  254. package/configs/cursor/context-mode.mdc +0 -76
  255. package/configs/cursor/hooks.json +0 -21
  256. package/configs/cursor/mcp.json +0 -7
  257. package/configs/gemini-cli/GEMINI.md +0 -88
  258. package/configs/gemini-cli/mcp.json +0 -7
  259. package/configs/gemini-cli/settings.json +0 -60
  260. package/configs/jetbrains-copilot/copilot-instructions.md +0 -80
  261. package/configs/jetbrains-copilot/hooks.json +0 -16
  262. package/configs/jetbrains-copilot/mcp.json +0 -7
  263. package/configs/kilo/AGENTS.md +0 -84
  264. package/configs/kilo/kilo.json +0 -6
  265. package/configs/kimi/hooks.json +0 -54
  266. package/configs/kiro/KIRO.md +0 -84
  267. package/configs/kiro/agent.json +0 -18
  268. package/configs/kiro/mcp.json +0 -7
  269. package/configs/omp/SYSTEM.md +0 -85
  270. package/configs/omp/mcp.json +0 -7
  271. package/configs/openclaw/AGENTS.md +0 -87
  272. package/configs/openclaw/openclaw.json +0 -13
  273. package/configs/opencode/AGENTS.md +0 -84
  274. package/configs/opencode/opencode.json +0 -6
  275. package/configs/pi/AGENTS.md +0 -3
  276. package/configs/qwen-code/QWEN.md +0 -91
  277. package/configs/vscode-copilot/copilot-instructions.md +0 -80
  278. package/configs/vscode-copilot/hooks.json +0 -16
  279. package/configs/vscode-copilot/mcp.json +0 -7
  280. package/configs/zed/AGENTS.md +0 -68
  281. package/hooks/antigravity-cli/payload.mjs +0 -98
  282. package/hooks/antigravity-cli/posttooluse.mjs +0 -138
  283. package/hooks/antigravity-cli/pretooluse.mjs +0 -78
  284. package/hooks/antigravity-cli/stop.mjs +0 -58
  285. package/hooks/auto-injection.mjs +0 -102
  286. package/hooks/cache-heal-utils.mjs +0 -379
  287. package/hooks/codex/platform.mjs +0 -1
  288. package/hooks/codex/posttooluse.mjs +0 -66
  289. package/hooks/codex/precompact.mjs +0 -70
  290. package/hooks/codex/pretooluse.mjs +0 -42
  291. package/hooks/codex/sessionstart.mjs +0 -121
  292. package/hooks/codex/stop.mjs +0 -138
  293. package/hooks/codex/userpromptsubmit.mjs +0 -75
  294. package/hooks/copilot-cli/posttooluse.mjs +0 -79
  295. package/hooks/copilot-cli/precompact.mjs +0 -66
  296. package/hooks/copilot-cli/pretooluse.mjs +0 -41
  297. package/hooks/copilot-cli/sessionstart.mjs +0 -121
  298. package/hooks/copilot-cli/stop.mjs +0 -59
  299. package/hooks/copilot-cli/userpromptsubmit.mjs +0 -77
  300. package/hooks/core/codex-caps.mjs +0 -112
  301. package/hooks/core/formatters.mjs +0 -356
  302. package/hooks/core/mcp-ready.mjs +0 -109
  303. package/hooks/core/platform-detect.mjs +0 -49
  304. package/hooks/core/routing.mjs +0 -1017
  305. package/hooks/core/stdin.mjs +0 -90
  306. package/hooks/core/tool-naming.mjs +0 -57
  307. package/hooks/cursor/afteragentresponse.mjs +0 -74
  308. package/hooks/cursor/hooks.json +0 -31
  309. package/hooks/cursor/posttooluse.mjs +0 -72
  310. package/hooks/cursor/pretooluse.mjs +0 -26
  311. package/hooks/cursor/sessionstart.mjs +0 -97
  312. package/hooks/cursor/stop.mjs +0 -48
  313. package/hooks/ensure-deps.mjs +0 -254
  314. package/hooks/formatters/claude-code.mjs +0 -113
  315. package/hooks/formatters/cursor.mjs +0 -37
  316. package/hooks/formatters/gemini-cli.mjs +0 -55
  317. package/hooks/formatters/vscode-copilot.mjs +0 -55
  318. package/hooks/gemini-cli/aftermodel.mjs +0 -70
  319. package/hooks/gemini-cli/aftertool.mjs +0 -61
  320. package/hooks/gemini-cli/beforeagent.mjs +0 -99
  321. package/hooks/gemini-cli/beforetool.mjs +0 -27
  322. package/hooks/gemini-cli/precompress.mjs +0 -55
  323. package/hooks/gemini-cli/sessionstart.mjs +0 -137
  324. package/hooks/heal-partial-install.mjs +0 -712
  325. package/hooks/jetbrains-copilot/posttooluse.mjs +0 -61
  326. package/hooks/jetbrains-copilot/precompact.mjs +0 -55
  327. package/hooks/jetbrains-copilot/pretooluse.mjs +0 -27
  328. package/hooks/jetbrains-copilot/sessionstart.mjs +0 -124
  329. package/hooks/kimi/platform.mjs +0 -1
  330. package/hooks/kimi/posttooluse.mjs +0 -72
  331. package/hooks/kimi/precompact.mjs +0 -80
  332. package/hooks/kimi/pretooluse.mjs +0 -42
  333. package/hooks/kimi/sessionend.mjs +0 -61
  334. package/hooks/kimi/sessionstart.mjs +0 -113
  335. package/hooks/kimi/stop.mjs +0 -132
  336. package/hooks/kimi/userpromptsubmit.mjs +0 -90
  337. package/hooks/kiro/agentspawn.mjs +0 -97
  338. package/hooks/kiro/posttooluse.mjs +0 -51
  339. package/hooks/kiro/pretooluse.mjs +0 -64
  340. package/hooks/kiro/userpromptsubmit.mjs +0 -88
  341. package/hooks/normalize-hooks.mjs +0 -323
  342. package/hooks/platform-bridge.mjs +0 -340
  343. package/hooks/posttooluse.mjs +0 -225
  344. package/hooks/precompact.mjs +0 -100
  345. package/hooks/pretooluse.mjs +0 -227
  346. package/hooks/qwen-code/platform.mjs +0 -1
  347. package/hooks/qwen-code/stop.mjs +0 -168
  348. package/hooks/routing-block.mjs +0 -105
  349. package/hooks/run-hook.mjs +0 -95
  350. package/hooks/security.bundle.mjs +0 -2
  351. package/hooks/session-attribution.bundle.mjs +0 -1
  352. package/hooks/session-db.bundle.mjs +0 -144
  353. package/hooks/session-directive.mjs +0 -520
  354. package/hooks/session-extract.bundle.mjs +0 -3
  355. package/hooks/session-helpers.mjs +0 -428
  356. package/hooks/session-loaders.mjs +0 -448
  357. package/hooks/session-snapshot.bundle.mjs +0 -32
  358. package/hooks/sessionstart.mjs +0 -464
  359. package/hooks/stop.mjs +0 -82
  360. package/hooks/suppress-stderr.mjs +0 -25
  361. package/hooks/userpromptsubmit.mjs +0 -108
  362. package/hooks/vscode-copilot/posttooluse.mjs +0 -61
  363. package/hooks/vscode-copilot/precompact.mjs +0 -55
  364. package/hooks/vscode-copilot/pretooluse.mjs +0 -27
  365. package/hooks/vscode-copilot/sessionstart.mjs +0 -129
  366. package/openclaw.plugin.json +0 -38
  367. package/scripts/heal-better-sqlite3.mjs +0 -430
  368. package/scripts/heal-installed-plugins.mjs +0 -598
  369. package/scripts/plugin-cache-integrity.mjs +0 -248
  370. package/scripts/postinstall.mjs +0 -384
  371. package/server.bundle.mjs +0 -1162
  372. package/skills/.ignore +0 -7
  373. package/skills/context-mode/SKILL.md +0 -300
  374. package/skills/context-mode/references/anti-patterns.md +0 -283
  375. package/skills/context-mode/references/patterns-javascript.md +0 -298
  376. package/skills/context-mode/references/patterns-python.md +0 -304
  377. package/skills/context-mode/references/patterns-shell.md +0 -277
  378. package/skills/ctx-index/SKILL.md +0 -46
  379. package/skills/ctx-insight/SKILL.md +0 -24
  380. package/skills/ctx-purge/SKILL.md +0 -49
  381. package/skills/ctx-search/SKILL.md +0 -35
  382. package/start.mjs +0 -616
@@ -1,47 +0,0 @@
1
- # context-mode — GitHub Copilot CLI plugin
2
-
3
- One-command install of the context-mode MCP server (and routing skill) into
4
- GitHub Copilot CLI, with **no `context-mode upgrade` / agent call required**:
5
-
6
- ```sh
7
- copilot plugin install mksglu/context-mode:configs/copilot-cli
8
- ```
9
-
10
- This registers:
11
-
12
- - **MCP server** (`.mcp.json`) — exposes the `ctx_*` tools (`ctx_execute`,
13
- `ctx_batch_execute`, `ctx_search`, `ctx_fetch_and_index`, …). The server is
14
- launched with `CONTEXT_MODE_PLATFORM=copilot-cli`, so it self-identifies as
15
- Copilot regardless of any other CLI installed on the machine — `ctx_upgrade`
16
- and platform detection resolve `copilot-cli`, never a co-installed Claude Code.
17
- - **Routing skill** (`skills/context-mode/`) — the MANDATORY "Think in Code"
18
- rules that keep raw bytes out of the context window.
19
- - **Capture hooks** (`hooks.json`) — `preToolUse`, `postToolUse`,
20
- `sessionStart`, `userPromptSubmitted`, `agentStop`, `preCompact` (Copilot
21
- CLI's camelCase event names — verified against the `@github/copilot` 1.0.60
22
- binary; PascalCase keys are silently ignored and never fire), each dispatching
23
- `context-mode hook copilot-cli <event>`. Byte-equivalent to what
24
- `context-mode upgrade` writes to `~/.copilot/hooks/`, so the plugin registers
25
- them with no `upgrade` / agent call.
26
-
27
- ## Prerequisite
28
-
29
- The MCP server runs the global `context-mode` binary (it needs the native
30
- `better-sqlite3` dependency):
31
-
32
- ```sh
33
- npm install -g context-mode
34
- ```
35
-
36
- ## Alternative (no plugin)
37
-
38
- ```sh
39
- copilot mcp add context-mode --env CONTEXT_MODE_PLATFORM=copilot-cli -- context-mode
40
- ```
41
-
42
- Then, to also install the capture hooks, run the upgrade **from inside Copilot**
43
- (so it detects `copilot-cli` via the live MCP client) rather than standalone:
44
-
45
- ```sh
46
- copilot -p "Use the context-mode ctx_upgrade tool to install context-mode's hooks." --allow-all
47
- ```
@@ -1,41 +0,0 @@
1
- {
2
- "version": 1,
3
- "hooks": {
4
- "preToolUse": [
5
- {
6
- "type": "command",
7
- "command": "context-mode hook copilot-cli pretooluse"
8
- }
9
- ],
10
- "postToolUse": [
11
- {
12
- "type": "command",
13
- "command": "context-mode hook copilot-cli posttooluse"
14
- }
15
- ],
16
- "sessionStart": [
17
- {
18
- "type": "command",
19
- "command": "context-mode hook copilot-cli sessionstart"
20
- }
21
- ],
22
- "userPromptSubmitted": [
23
- {
24
- "type": "command",
25
- "command": "context-mode hook copilot-cli userpromptsubmit"
26
- }
27
- ],
28
- "agentStop": [
29
- {
30
- "type": "command",
31
- "command": "context-mode hook copilot-cli stop"
32
- }
33
- ],
34
- "preCompact": [
35
- {
36
- "type": "command",
37
- "command": "context-mode hook copilot-cli precompact"
38
- }
39
- ]
40
- }
41
- }
@@ -1,38 +0,0 @@
1
- ---
2
- name: context-mode
3
- 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.
4
- ---
5
-
6
- # context-mode — MANDATORY routing rules
7
-
8
- context-mode MCP tools are available in GitHub Copilot CLI. These rules protect
9
- the context window from flooding — one unrouted command can dump tens of KB into
10
- the conversation. Follow them strictly.
11
-
12
- ## Think in Code — MANDATORY
13
-
14
- Analyze / count / filter / compare / search / parse / transform data: **write
15
- code** via `ctx_execute(language, code)` and `console.log()` only the answer. Do
16
- NOT read raw data into context. PROGRAM the analysis, do not COMPUTE it by
17
- reading. One script replaces ten tool calls.
18
-
19
- ## BLOCKED — do NOT use
20
-
21
- - **curl / wget** — dumps raw HTTP into context. Use
22
- `ctx_fetch_and_index(url, source)` then `ctx_search(queries)`.
23
- - **Inline HTTP** (`node -e "fetch(...)"`, `python -c "requests.get(...)"`) — use
24
- `ctx_execute(language, code)`; only stdout enters context.
25
- - **Reading large files to analyze** — use
26
- `ctx_execute_file(path, language, code)`.
27
-
28
- ## Tool selection
29
-
30
- 1. **GATHER**: `ctx_batch_execute(commands, queries)` — runs all commands,
31
- auto-indexes, returns search. One call replaces dozens.
32
- 2. **PROCESS**: `ctx_execute` / `ctx_execute_file` — sandbox; only stdout enters
33
- context.
34
- 3. **WEB**: `ctx_fetch_and_index(url, source)` then `ctx_search(queries)` — raw
35
- HTML never enters context.
36
- 4. **SEARCH**: `ctx_search(queries: [...])` — all questions in one call.
37
-
38
- Write artifacts to FILES; return a path + one-line description, not inline dumps.
@@ -1,76 +0,0 @@
1
- ---
2
- description: context-mode routing rules for context window protection
3
- alwaysApply: true
4
- ---
5
-
6
- # context-mode
7
-
8
- Raw tool output floods context window. Use context-mode MCP tools to keep raw data in sandbox.
9
-
10
- ## Think in Code — MANDATORY
11
-
12
- Analyze/count/filter/compare/search/parse/transform data: **write code** via `ctx_execute(language, code)`, `console.log()` only the answer. Do NOT read raw data into context. PROGRAM the analysis, not COMPUTE it. Pure JavaScript — Node.js built-ins only (`fs`, `path`, `child_process`). `try/catch`, handle `null`/`undefined`. One script replaces ten tool calls.
13
-
14
- ## Tool Selection
15
-
16
- 0. **MEMORY**: `ctx_search(sort: "timeline")` — after resume, check prior context before asking user.
17
- 1. **GATHER**: `ctx_batch_execute(commands, queries)` — runs all commands, auto-indexes, searches. ONE call replaces many steps.
18
- 2. **FOLLOW-UP**: `ctx_search(queries: ["q1", "q2", ...])` — all follow-up questions, ONE call (default relevance mode).
19
- 3. **PROCESSING**: `ctx_execute(language, code)` | `ctx_execute_file(path, language, code)` — sandbox, only stdout enters context.
20
- 4. **WEB**: `ctx_fetch_and_index(url)` then `ctx_search(queries)` — never dump raw HTML.
21
- 5. **INDEX**: `ctx_index(content, source)` — store in FTS5 for later search.
22
-
23
- ## Parallel I/O batches
24
-
25
- For multi-URL fetches or multi-API calls, **always** include `concurrency: N` (1-8):
26
-
27
- - `ctx_batch_execute(commands: [3+ network commands], concurrency: 5)` — gh, curl, dig, docker inspect, multi-region cloud queries
28
- - `ctx_fetch_and_index(requests: [{url, source}, ...], concurrency: 5)` — multi-URL batch fetch
29
-
30
- **Use concurrency 4-8** for I/O-bound work (network calls, API queries). **Keep concurrency 1** for CPU-bound (npm test, build, lint) or commands sharing state (ports, lock files, same-repo writes).
31
-
32
- GitHub API rate-limit: cap at 4 for `gh` calls.
33
-
34
- ## Forbidden Actions
35
-
36
- - DO NOT use Bash for >20 lines output — use `ctx_execute` or `ctx_batch_execute`.
37
- - DO NOT use Read for analysis — use `ctx_execute_file`. Read IS correct for Edit.
38
- - DO NOT use WebFetch — use `ctx_fetch_and_index`.
39
- - DO NOT use curl/wget in terminal — use `ctx_fetch_and_index`.
40
- - Bash ONLY for git, mkdir, rm, mv, navigation, short commands.
41
- - DO NOT use `ctx_execute`/`ctx_execute_file` to create/modify files. ctx_execute is for analysis and computation only.
42
-
43
- ## File Writing Policy
44
-
45
- ALWAYS use native file editing tools to create/modify files. NEVER use `ctx_execute`, `ctx_execute_file`, or Bash to write file content.
46
-
47
- ## Output
48
-
49
- Write artifacts to FILES — never inline. Return: file path + 1-line description.
50
-
51
- ## Session Continuity
52
-
53
- Skills, roles, and decisions persist for the entire session. Do not abandon them as the conversation grows.
54
-
55
- ## Memory
56
-
57
- Session history is persistent and searchable. On resume, search BEFORE asking the user:
58
-
59
- | Need | Command |
60
- |------|---------|
61
- | What did we decide? | `ctx_search(queries: ["decision"], source: "decision", sort: "timeline")` |
62
- | What constraints exist? | `ctx_search(queries: ["constraint"], source: "constraint")` |
63
-
64
- DO NOT ask "what were we working on?" — SEARCH FIRST.
65
- If search returns 0 results, proceed as a fresh session.
66
-
67
- ## ctx Commands
68
-
69
- | Command | Action |
70
- |---------|--------|
71
- | `ctx stats` | Call ctx_stats MCP tool, display full output verbatim. |
72
- | `ctx doctor` | Call ctx_doctor MCP tool, run returned shell command, display as checklist. |
73
- | `ctx upgrade` | Call ctx_upgrade MCP tool, run returned shell command, display as checklist. |
74
- | `ctx purge` | Call ctx_purge MCP tool with confirm: true. Warn user this is irreversible. |
75
-
76
- After /clear or /compact: knowledge base and session stats preserved. Use `ctx purge` to start fresh.
@@ -1,21 +0,0 @@
1
- {
2
- "version": 1,
3
- "hooks": {
4
- "preToolUse": [
5
- {
6
- "command": "context-mode hook cursor pretooluse",
7
- "matcher": "Shell|Read|Grep|WebFetch|mcp_web_fetch|mcp_fetch_tool|Task|MCP:ctx_execute|MCP:ctx_execute_file|MCP:ctx_batch_execute|MCP:(?!ctx_)"
8
- }
9
- ],
10
- "postToolUse": [
11
- {
12
- "command": "context-mode hook cursor posttooluse"
13
- }
14
- ],
15
- "stop": [
16
- {
17
- "command": "context-mode hook cursor stop"
18
- }
19
- ]
20
- }
21
- }
@@ -1,7 +0,0 @@
1
- {
2
- "mcpServers": {
3
- "context-mode": {
4
- "command": "context-mode"
5
- }
6
- }
7
- }
@@ -1,88 +0,0 @@
1
- # context-mode — MANDATORY routing rules
2
-
3
- context-mode MCP tools available. Rules protect context window from flooding. One unrouted command dumps 56 KB into context.
4
-
5
- ## Think in Code — MANDATORY
6
-
7
- Analyze/count/filter/compare/search/parse/transform data: **write code** via `mcp__context-mode__ctx_execute(language, code)`, `console.log()` only the answer. Do NOT read raw data into context. PROGRAM the analysis, not COMPUTE it. Pure JavaScript — Node.js built-ins only (`fs`, `path`, `child_process`). `try/catch`, handle `null`/`undefined`. One script replaces ten tool calls.
8
-
9
- ## BLOCKED — do NOT attempt
10
-
11
- ### curl / wget — BLOCKED
12
- Shell `curl`/`wget` intercepted and blocked. Do NOT retry.
13
- Use: `mcp__context-mode__ctx_fetch_and_index(url, source)` or `mcp__context-mode__ctx_execute(language: "javascript", code: "const r = await fetch(...)")`
14
-
15
- ### Inline HTTP — BLOCKED
16
- `fetch('http`, `requests.get(`, `requests.post(`, `http.get(`, `http.request(` — intercepted. Do NOT retry.
17
- Use: `mcp__context-mode__ctx_execute(language, code)` — only stdout enters context
18
-
19
- ### WebFetch / web browsing — BLOCKED
20
- Use: `mcp__context-mode__ctx_fetch_and_index(url, source)` then `mcp__context-mode__ctx_search(queries)`
21
-
22
- ## REDIRECTED — use sandbox
23
-
24
- ### Shell (>20 lines output)
25
- Shell ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`.
26
- 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.
27
-
28
- ### read_file (for analysis)
29
- Reading to **edit** → read_file correct. Reading to **analyze/explore/summarize** → `mcp__context-mode__ctx_execute_file(path, language, code)`.
30
-
31
- ### grep / search (large results)
32
- Use `mcp__context-mode__ctx_execute(language: "javascript", code: "...")` in sandbox for portable filtering/counting.
33
-
34
- ## Tool selection
35
-
36
- 0. **MEMORY**: `mcp__context-mode__ctx_search(sort: "timeline")` — after resume, check prior context before asking user.
37
- 1. **GATHER**: `mcp__context-mode__ctx_batch_execute(commands, queries)` — runs all commands, auto-indexes, returns search. ONE call replaces 30+. Each command: `{label: "header", command: "..."}`.
38
- 2. **FOLLOW-UP**: `mcp__context-mode__ctx_search(queries: ["q1", "q2", ...])` — all questions as array, ONE call (default relevance mode).
39
- 3. **PROCESSING**: `mcp__context-mode__ctx_execute(language, code)` | `mcp__context-mode__ctx_execute_file(path, language, code)` — sandbox, only stdout enters context.
40
- 4. **WEB**: `mcp__context-mode__ctx_fetch_and_index(url, source)` then `mcp__context-mode__ctx_search(queries)` — raw HTML never enters context.
41
- 5. **INDEX**: `mcp__context-mode__ctx_index(content, source)` — store in FTS5 for later search.
42
-
43
- ## Parallel I/O batches
44
-
45
- For multi-URL fetches or multi-API calls, **always** include `concurrency: N` (1-8):
46
-
47
- - `mcp__context-mode__ctx_batch_execute(commands: [3+ network commands], concurrency: 5)` — gh, curl, dig, docker inspect, multi-region cloud queries
48
- - `mcp__context-mode__ctx_fetch_and_index(requests: [{url, source}, ...], concurrency: 5)` — multi-URL batch fetch
49
-
50
- **Use concurrency 4-8** for I/O-bound work (network calls, API queries). **Keep concurrency 1** for CPU-bound (npm test, build, lint) or commands sharing state (ports, lock files, same-repo writes).
51
-
52
- GitHub API rate-limit: cap at 4 for `gh` calls.
53
-
54
- ## Output
55
-
56
- Write artifacts to FILES — never inline. Return: file path + 1-line description.
57
- Descriptive source labels for `search(source: "label")`.
58
-
59
- ## Session Continuity
60
-
61
- Skills, roles, and decisions persist for the entire session. Do not abandon them as the conversation grows.
62
-
63
- ## Memory
64
-
65
- Session history is persistent and searchable. On resume, search BEFORE asking the user:
66
-
67
- | Need | Command |
68
- |------|---------|
69
- | What were we working on? | `mcp__context-mode__ctx_search(queries: ["summary"], source: "compaction", sort: "timeline")` |
70
- | What did we decide? | `mcp__context-mode__ctx_search(queries: ["decision"], source: "decision", sort: "timeline")` |
71
- | What NOT to repeat? | `mcp__context-mode__ctx_search(queries: ["rejected"], source: "rejected-approach")` |
72
- | What constraints exist? | `mcp__context-mode__ctx_search(queries: ["constraint"], source: "constraint")` |
73
-
74
- Note: user-prompt history not available.
75
-
76
- DO NOT ask "what were we working on?" — SEARCH FIRST.
77
- If search returns 0 results, proceed as a fresh session.
78
-
79
- ## ctx commands
80
-
81
- | Command | Action |
82
- |---------|--------|
83
- | `ctx stats` | Call `stats` MCP tool, display full output verbatim |
84
- | `ctx doctor` | Call `doctor` MCP tool, run returned shell command, display as checklist |
85
- | `ctx upgrade` | Call `upgrade` MCP tool, run returned shell command, display as checklist |
86
- | `ctx purge` | Call `purge` MCP tool with confirm: true. Warns before wiping knowledge base. |
87
-
88
- After /clear or /compact: knowledge base and session stats preserved. Use `ctx purge` to start fresh.
@@ -1,7 +0,0 @@
1
- {
2
- "mcpServers": {
3
- "context-mode": {
4
- "command": "context-mode"
5
- }
6
- }
7
- }
@@ -1,60 +0,0 @@
1
- {
2
- "$schema": "https://raw.githubusercontent.com/google-gemini/gemini-cli/main/packages/core/src/schema/settings-schema.json",
3
- "hooks": {
4
- "BeforeTool": [
5
- {
6
- "matcher": "run_shell_command|read_file|read_many_files|grep_search|search_file_content|web_fetch|activate_skill|mcp__plugin_context-mode",
7
- "hooks": [
8
- {
9
- "type": "command",
10
- "command": "context-mode hook gemini-cli beforetool"
11
- }
12
- ]
13
- }
14
- ],
15
- "AfterTool": [
16
- {
17
- "matcher": "",
18
- "hooks": [
19
- {
20
- "type": "command",
21
- "command": "context-mode hook gemini-cli aftertool"
22
- }
23
- ]
24
- }
25
- ],
26
- "AfterModel": [
27
- {
28
- "matcher": "",
29
- "hooks": [
30
- {
31
- "type": "command",
32
- "command": "context-mode hook gemini-cli aftermodel"
33
- }
34
- ]
35
- }
36
- ],
37
- "PreCompress": [
38
- {
39
- "matcher": "",
40
- "hooks": [
41
- {
42
- "type": "command",
43
- "command": "context-mode hook gemini-cli precompress"
44
- }
45
- ]
46
- }
47
- ],
48
- "SessionStart": [
49
- {
50
- "matcher": "",
51
- "hooks": [
52
- {
53
- "type": "command",
54
- "command": "context-mode hook gemini-cli sessionstart"
55
- }
56
- ]
57
- }
58
- ]
59
- }
60
- }
@@ -1,80 +0,0 @@
1
- # context-mode — MANDATORY routing rules
2
-
3
- context-mode MCP tools available. Rules protect context window from flooding. One unrouted command dumps 56 KB into context.
4
-
5
- ## Think in Code — MANDATORY
6
-
7
- Analyze/count/filter/compare/search/parse/transform data: **write code** via `ctx_execute(language, code)`, `console.log()` only the answer. Do NOT read raw data into context. PROGRAM the analysis, not COMPUTE it. Pure JavaScript — Node.js built-ins only (`fs`, `path`, `child_process`). `try/catch`, handle `null`/`undefined`. One script replaces ten tool calls.
8
-
9
- ## BLOCKED — do NOT attempt
10
-
11
- ### curl / wget — BLOCKED
12
- Terminal `curl`/`wget` intercepted and blocked. Do NOT retry.
13
- Use: `ctx_fetch_and_index(url, source)` or `ctx_execute(language: "javascript", code: "const r = await fetch(...)")`
14
-
15
- ### Inline HTTP — BLOCKED
16
- `fetch('http`, `requests.get(`, `requests.post(`, `http.get(`, `http.request(` — intercepted. Do NOT retry.
17
- Use: `ctx_execute(language, code)` — only stdout enters context
18
-
19
- ### WebFetch / fetch — BLOCKED
20
- Use: `ctx_fetch_and_index(url, source)` then `ctx_search(queries)`
21
-
22
- ## REDIRECTED — use sandbox
23
-
24
- ### Terminal / run_in_terminal (>20 lines output)
25
- Terminal ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`.
26
- Otherwise: `ctx_batch_execute(commands, queries)` or `ctx_execute(language: "javascript", code: "...")`. Use `language: "shell"` only when code matches the host shell.
27
-
28
- ### read_file (for analysis)
29
- Reading to **edit** → read_file correct. Reading to **analyze/explore/summarize** → `ctx_execute_file(path, language, code)`.
30
-
31
- ### grep / search (large results)
32
- Use `ctx_execute(language: "javascript", code: "...")` in sandbox for portable filtering/counting.
33
-
34
- ## Tool selection
35
-
36
- 0. **MEMORY**: `ctx_search(sort: "timeline")` — after resume, check prior context before asking user.
37
- 1. **GATHER**: `ctx_batch_execute(commands, queries)` — runs all commands, auto-indexes, returns search. ONE call replaces 30+. Each command: `{label: "header", command: "..."}`.
38
- 2. **FOLLOW-UP**: `ctx_search(queries: ["q1", "q2", ...])` — all questions as array, ONE call (default relevance mode).
39
- 3. **PROCESSING**: `ctx_execute(language, code)` | `ctx_execute_file(path, language, code)` — sandbox, only stdout enters context.
40
- 4. **WEB**: `ctx_fetch_and_index(url, source)` then `ctx_search(queries)` — raw HTML never enters context.
41
- 5. **INDEX**: `ctx_index(content, source)` — store in FTS5 for later search.
42
-
43
- ### Parallel I/O batches
44
- Pass `concurrency: 4-8` to `ctx_batch_execute` and `ctx_fetch_and_index` for network/API batches. Keep `concurrency: 1` for CPU-bound work (test, build, lint). GitHub gh: cap at 4.
45
-
46
- ## Output
47
-
48
- Write artifacts to FILES — never inline. Return: file path + 1-line description.
49
- Descriptive source labels for `ctx_search(source: "label")`.
50
-
51
- ## Session Continuity
52
-
53
- Skills, roles, and decisions persist for the entire session. Do not abandon them as the conversation grows.
54
-
55
- ## Memory
56
-
57
- Session history is persistent and searchable. On resume, search BEFORE asking the user:
58
-
59
- | Need | Command |
60
- |------|---------|
61
- | What were we working on? | `ctx_search(queries: ["summary"], source: "compaction", sort: "timeline")` |
62
- | What did we decide? | `ctx_search(queries: ["decision"], source: "decision", sort: "timeline")` |
63
- | What NOT to repeat? | `ctx_search(queries: ["rejected"], source: "rejected-approach")` |
64
- | What constraints exist? | `ctx_search(queries: ["constraint"], source: "constraint")` |
65
-
66
- Note: user-prompt history not available.
67
-
68
- DO NOT ask "what were we working on?" — SEARCH FIRST.
69
- If search returns 0 results, proceed as a fresh session.
70
-
71
- ## ctx commands
72
-
73
- | Command | Action |
74
- |---------|--------|
75
- | `ctx stats` | Call `ctx_stats` MCP tool, display full output verbatim |
76
- | `ctx doctor` | Call `ctx_doctor` MCP tool, run returned shell command, display as checklist |
77
- | `ctx upgrade` | Call `ctx_upgrade` MCP tool, run returned shell command, display as checklist |
78
- | `ctx purge` | Call `ctx_purge` MCP tool with confirm: true. Warns before wiping knowledge base. |
79
-
80
- After /clear or /compact: knowledge base and session stats preserved. Use `ctx purge` to start fresh.
@@ -1,16 +0,0 @@
1
- {
2
- "hooks": {
3
- "PreToolUse": [
4
- { "type": "command", "command": "context-mode hook jetbrains-copilot pretooluse" }
5
- ],
6
- "PostToolUse": [
7
- { "type": "command", "command": "context-mode hook jetbrains-copilot posttooluse" }
8
- ],
9
- "PreCompact": [
10
- { "type": "command", "command": "context-mode hook jetbrains-copilot precompact" }
11
- ],
12
- "SessionStart": [
13
- { "type": "command", "command": "context-mode hook jetbrains-copilot sessionstart" }
14
- ]
15
- }
16
- }
@@ -1,7 +0,0 @@
1
- {
2
- "servers": {
3
- "context-mode": {
4
- "command": "context-mode"
5
- }
6
- }
7
- }
@@ -1,84 +0,0 @@
1
- # context-mode — MANDATORY routing rules
2
-
3
- context-mode MCP tools available. Rules protect context window from flooding. One unrouted command dumps 56 KB into context.
4
-
5
- ## Think in Code — MANDATORY
6
-
7
- Analyze/count/filter/compare/search/parse/transform data: **write code** via `context-mode_ctx_execute(language, code)`, `console.log()` only the answer. Do NOT read raw data into context. PROGRAM the analysis, not COMPUTE it. Pure JavaScript — Node.js built-ins only (`fs`, `path`, `child_process`). `try/catch`, handle `null`/`undefined`. One script replaces ten tool calls.
8
-
9
- ## BLOCKED — do NOT attempt
10
-
11
- ### curl / wget — BLOCKED
12
- Shell `curl`/`wget` intercepted and blocked. Do NOT retry.
13
- Use: `context-mode_ctx_fetch_and_index(url, source)` or `context-mode_ctx_execute(language: "javascript", code: "const r = await fetch(...)")`
14
-
15
- ### Inline HTTP — BLOCKED
16
- `fetch('http`, `requests.get(`, `requests.post(`, `http.get(`, `http.request(` — intercepted. Do NOT retry.
17
- Use: `context-mode_ctx_execute(language, code)` — only stdout enters context
18
-
19
- ### Direct web fetching — BLOCKED
20
- Use: `context-mode_ctx_fetch_and_index(url, source)` then `context-mode_ctx_search(queries)`
21
-
22
- ## REDIRECTED — use sandbox
23
-
24
- ### Shell (>20 lines output)
25
- Shell ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`.
26
- 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.
27
-
28
- ### File reading (for analysis)
29
- Reading to **edit** → reading correct. Reading to **analyze/explore/summarize** → `context-mode_ctx_execute_file(path, language, code)`.
30
-
31
- ### grep / search (large results)
32
- Use `context-mode_ctx_execute(language: "javascript", code: "...")` in sandbox for portable filtering/counting.
33
-
34
- ## Tool selection
35
-
36
- 0. **MEMORY**: `context-mode_ctx_search(sort: "timeline")` — after resume, check prior context before asking user.
37
- 1. **GATHER**: `context-mode_ctx_batch_execute(commands, queries)` — runs all commands, auto-indexes, returns search. ONE call replaces 30+. Each command: `{label: "header", command: "..."}`.
38
- 2. **FOLLOW-UP**: `context-mode_ctx_search(queries: ["q1", "q2", ...])` — all questions as array, ONE call (default relevance mode).
39
- 3. **PROCESSING**: `context-mode_ctx_execute(language, code)` | `context-mode_ctx_execute_file(path, language, code)` — sandbox, only stdout enters context.
40
- 4. **WEB**: `context-mode_ctx_fetch_and_index(url, source)` then `context-mode_ctx_search(queries)` — raw HTML never enters context.
41
- 5. **INDEX**: `context-mode_ctx_index(content, source)` — store in FTS5 for later search.
42
-
43
- ## Parallel I/O batches
44
-
45
- For multi-URL fetches or multi-API calls, **always** include `concurrency: N` (1-8):
46
-
47
- - `context-mode_ctx_batch_execute(commands: [3+ network commands], concurrency: 5)` — gh, curl, dig, docker inspect, multi-region cloud queries
48
- - `context-mode_ctx_fetch_and_index(requests: [{url, source}, ...], concurrency: 5)` — multi-URL batch fetch
49
-
50
- **Use concurrency 4-8** for I/O-bound work (network calls, API queries). **Keep concurrency 1** for CPU-bound (npm test, build, lint) or commands sharing state (ports, lock files, same-repo writes).
51
-
52
- GitHub API rate-limit: cap at 4 for `gh` calls.
53
-
54
- ## Output
55
-
56
- Write artifacts to FILES — never inline. Return: file path + 1-line description.
57
- Descriptive source labels for `context-mode_ctx_search(source: "label")`.
58
-
59
- ## Session Continuity
60
-
61
- Skills, roles, and decisions persist for the entire session. Do not abandon them as the conversation grows.
62
-
63
- ## Memory
64
-
65
- Session history is persistent and searchable. On resume, search BEFORE asking the user:
66
-
67
- | Need | Command |
68
- |------|---------|
69
- | What did we decide? | `context-mode_ctx_search(queries: ["decision"], source: "decision", sort: "timeline")` |
70
- | What constraints exist? | `context-mode_ctx_search(queries: ["constraint"], source: "constraint")` |
71
-
72
- DO NOT ask "what were we working on?" — SEARCH FIRST.
73
- If search returns 0 results, proceed as a fresh session.
74
-
75
- ## ctx commands
76
-
77
- | Command | Action |
78
- |---------|--------|
79
- | `ctx stats` | Call `stats` MCP tool, display full output verbatim |
80
- | `ctx doctor` | Call `doctor` MCP tool, run returned shell command, display as checklist |
81
- | `ctx upgrade` | Call `upgrade` MCP tool, run returned shell command, display as checklist |
82
- | `ctx purge` | Call `purge` MCP tool with confirm: true. Warns before wiping knowledge base. |
83
-
84
- After /clear or /compact: knowledge base and session stats preserved. Use `ctx purge` to start fresh.
@@ -1,6 +0,0 @@
1
- {
2
- "$schema": "https://app.kilo.ai/config.json",
3
- "plugin": [
4
- "context-mode"
5
- ]
6
- }
@@ -1,54 +0,0 @@
1
- {
2
- "hooks": {
3
- "PreToolUse": [
4
- {
5
- "matcher": "Bash|Shell|Read|Edit|Write|WebFetch|Agent|ctx_execute|ctx_execute_file|ctx_batch_execute|ctx_fetch_and_index|ctx_search|ctx_index|mcp__",
6
- "hooks": [
7
- { "type": "command", "command": "context-mode hook kimi pretooluse" }
8
- ]
9
- }
10
- ],
11
- "PostToolUse": [
12
- {
13
- "hooks": [
14
- { "type": "command", "command": "context-mode hook kimi posttooluse" }
15
- ]
16
- }
17
- ],
18
- "SessionStart": [
19
- {
20
- "hooks": [
21
- { "type": "command", "command": "context-mode hook kimi sessionstart" }
22
- ]
23
- }
24
- ],
25
- "SessionEnd": [
26
- {
27
- "hooks": [
28
- { "type": "command", "command": "context-mode hook kimi sessionend" }
29
- ]
30
- }
31
- ],
32
- "PreCompact": [
33
- {
34
- "hooks": [
35
- { "type": "command", "command": "context-mode hook kimi precompact" }
36
- ]
37
- }
38
- ],
39
- "UserPromptSubmit": [
40
- {
41
- "hooks": [
42
- { "type": "command", "command": "context-mode hook kimi userpromptsubmit" }
43
- ]
44
- }
45
- ],
46
- "Stop": [
47
- {
48
- "hooks": [
49
- { "type": "command", "command": "context-mode hook kimi stop" }
50
- ]
51
- }
52
- ]
53
- }
54
- }