context-mode 1.0.169 → 2.0.0-next.5

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 (379) hide show
  1. package/.claude-plugin/marketplace.json +4 -22
  2. package/.claude-plugin/plugin.json +9 -24
  3. package/SHA256SUMS +31 -0
  4. package/claude-code/skills/ctx-doctor/SKILL.md +6 -0
  5. package/claude-code/skills/ctx-stats/SKILL.md +6 -0
  6. package/claude-code/skills/ctx-upgrade/SKILL.md +6 -0
  7. package/cli.mjs +6744 -0
  8. package/copilot/plugin.json +14 -0
  9. package/fixtures/hook-roundtrip.json +22 -0
  10. package/gemini-extension.json +14 -0
  11. package/hook.mjs +202 -0
  12. package/hooks/claude-code.json +50 -0
  13. package/hooks/codex.json +50 -0
  14. package/hooks/copilot-cli.json +33 -0
  15. package/hooks/hooks.json +16 -111
  16. package/hooks/kiro.json +69 -0
  17. package/hooks/qwen.json +50 -0
  18. package/hooks/vscode.json +40 -0
  19. package/hooks/zcode.json +53 -0
  20. package/opencode/plugin.js +22456 -0
  21. package/package.json +29 -114
  22. package/pi/index.js +50841 -0
  23. package/pi/skills/ctx-doctor/SKILL.md +6 -0
  24. package/pi/skills/ctx-stats/SKILL.md +6 -0
  25. package/pi/skills/ctx-upgrade/SKILL.md +6 -0
  26. package/qwen-extension.json +15 -0
  27. package/run.mjs +5633 -0
  28. package/search.mjs +5633 -0
  29. package/server.mjs +48198 -0
  30. package/skills/ctx-doctor/SKILL.md +3 -19
  31. package/skills/ctx-stats/SKILL.md +3 -23
  32. package/skills/ctx-upgrade/SKILL.md +3 -28
  33. package/.codex-plugin/hooks.json +0 -65
  34. package/.codex-plugin/mcp.json +0 -13
  35. package/.codex-plugin/plugin.json +0 -31
  36. package/.openclaw-plugin/index.ts +0 -12
  37. package/.openclaw-plugin/openclaw.plugin.json +0 -38
  38. package/.openclaw-plugin/package.json +0 -28
  39. package/LICENSE +0 -94
  40. package/README.md +0 -1619
  41. package/bin/statusline.mjs +0 -378
  42. package/build/adapters/antigravity/index.d.ts +0 -51
  43. package/build/adapters/antigravity/index.js +0 -169
  44. package/build/adapters/antigravity-cli/index.d.ts +0 -51
  45. package/build/adapters/antigravity-cli/index.js +0 -342
  46. package/build/adapters/base.d.ts +0 -92
  47. package/build/adapters/base.js +0 -135
  48. package/build/adapters/claude-code/config.d.ts +0 -8
  49. package/build/adapters/claude-code/config.js +0 -8
  50. package/build/adapters/claude-code/hooks.d.ts +0 -106
  51. package/build/adapters/claude-code/hooks.js +0 -183
  52. package/build/adapters/claude-code/index.d.ts +0 -80
  53. package/build/adapters/claude-code/index.js +0 -569
  54. package/build/adapters/claude-code-base.d.ts +0 -49
  55. package/build/adapters/claude-code-base.js +0 -113
  56. package/build/adapters/client-map.d.ts +0 -10
  57. package/build/adapters/client-map.js +0 -42
  58. package/build/adapters/codex/config.d.ts +0 -8
  59. package/build/adapters/codex/config.js +0 -8
  60. package/build/adapters/codex/hooks.d.ts +0 -55
  61. package/build/adapters/codex/hooks.js +0 -64
  62. package/build/adapters/codex/index.d.ts +0 -87
  63. package/build/adapters/codex/index.js +0 -992
  64. package/build/adapters/codex/paths.d.ts +0 -1
  65. package/build/adapters/codex/paths.js +0 -12
  66. package/build/adapters/codex/usage.d.ts +0 -107
  67. package/build/adapters/codex/usage.js +0 -227
  68. package/build/adapters/copilot-base.d.ts +0 -94
  69. package/build/adapters/copilot-base.js +0 -297
  70. package/build/adapters/copilot-cli/hooks.d.ts +0 -33
  71. package/build/adapters/copilot-cli/hooks.js +0 -64
  72. package/build/adapters/copilot-cli/index.d.ts +0 -48
  73. package/build/adapters/copilot-cli/index.js +0 -341
  74. package/build/adapters/cursor/config.d.ts +0 -4
  75. package/build/adapters/cursor/config.js +0 -4
  76. package/build/adapters/cursor/hooks.d.ts +0 -55
  77. package/build/adapters/cursor/hooks.js +0 -82
  78. package/build/adapters/cursor/index.d.ts +0 -64
  79. package/build/adapters/cursor/index.js +0 -517
  80. package/build/adapters/detect.d.ts +0 -136
  81. package/build/adapters/detect.js +0 -623
  82. package/build/adapters/gemini-cli/config.d.ts +0 -8
  83. package/build/adapters/gemini-cli/config.js +0 -8
  84. package/build/adapters/gemini-cli/hooks.d.ts +0 -83
  85. package/build/adapters/gemini-cli/hooks.js +0 -115
  86. package/build/adapters/gemini-cli/index.d.ts +0 -80
  87. package/build/adapters/gemini-cli/index.js +0 -483
  88. package/build/adapters/jetbrains-copilot/config.d.ts +0 -8
  89. package/build/adapters/jetbrains-copilot/config.js +0 -8
  90. package/build/adapters/jetbrains-copilot/hooks.d.ts +0 -59
  91. package/build/adapters/jetbrains-copilot/hooks.js +0 -87
  92. package/build/adapters/jetbrains-copilot/index.d.ts +0 -31
  93. package/build/adapters/jetbrains-copilot/index.js +0 -131
  94. package/build/adapters/kimi/config.d.ts +0 -8
  95. package/build/adapters/kimi/config.js +0 -8
  96. package/build/adapters/kimi/hooks.d.ts +0 -28
  97. package/build/adapters/kimi/hooks.js +0 -34
  98. package/build/adapters/kimi/index.d.ts +0 -66
  99. package/build/adapters/kimi/index.js +0 -537
  100. package/build/adapters/kimi/paths.d.ts +0 -21
  101. package/build/adapters/kimi/paths.js +0 -52
  102. package/build/adapters/kimi/usage.d.ts +0 -82
  103. package/build/adapters/kimi/usage.js +0 -217
  104. package/build/adapters/kiro/hooks.d.ts +0 -61
  105. package/build/adapters/kiro/hooks.js +0 -94
  106. package/build/adapters/kiro/index.d.ts +0 -61
  107. package/build/adapters/kiro/index.js +0 -301
  108. package/build/adapters/omp/index.d.ts +0 -65
  109. package/build/adapters/omp/index.js +0 -182
  110. package/build/adapters/omp/plugin.d.ts +0 -81
  111. package/build/adapters/omp/plugin.js +0 -331
  112. package/build/adapters/omp/usage.d.ts +0 -49
  113. package/build/adapters/omp/usage.js +0 -110
  114. package/build/adapters/openclaw/config.d.ts +0 -8
  115. package/build/adapters/openclaw/config.js +0 -8
  116. package/build/adapters/openclaw/hooks.d.ts +0 -50
  117. package/build/adapters/openclaw/hooks.js +0 -61
  118. package/build/adapters/openclaw/index.d.ts +0 -74
  119. package/build/adapters/openclaw/index.js +0 -439
  120. package/build/adapters/openclaw/mcp-tools.d.ts +0 -54
  121. package/build/adapters/openclaw/mcp-tools.js +0 -207
  122. package/build/adapters/openclaw/plugin.d.ts +0 -141
  123. package/build/adapters/openclaw/plugin.js +0 -818
  124. package/build/adapters/openclaw/session-db.d.ts +0 -55
  125. package/build/adapters/openclaw/session-db.js +0 -88
  126. package/build/adapters/openclaw/usage.d.ts +0 -34
  127. package/build/adapters/openclaw/usage.js +0 -52
  128. package/build/adapters/openclaw/workspace-router.d.ts +0 -29
  129. package/build/adapters/openclaw/workspace-router.js +0 -64
  130. package/build/adapters/opencode/config.d.ts +0 -8
  131. package/build/adapters/opencode/config.js +0 -8
  132. package/build/adapters/opencode/hooks.d.ts +0 -38
  133. package/build/adapters/opencode/hooks.js +0 -50
  134. package/build/adapters/opencode/index.d.ts +0 -67
  135. package/build/adapters/opencode/index.js +0 -463
  136. package/build/adapters/opencode/plugin.d.ts +0 -184
  137. package/build/adapters/opencode/plugin.js +0 -558
  138. package/build/adapters/opencode/zod3tov4.d.ts +0 -1
  139. package/build/adapters/opencode/zod3tov4.js +0 -132
  140. package/build/adapters/pi/extension.d.ts +0 -81
  141. package/build/adapters/pi/extension.js +0 -861
  142. package/build/adapters/pi/index.d.ts +0 -57
  143. package/build/adapters/pi/index.js +0 -173
  144. package/build/adapters/pi/mcp-bridge.d.ts +0 -268
  145. package/build/adapters/pi/mcp-bridge.js +0 -894
  146. package/build/adapters/qwen-code/hooks.d.ts +0 -26
  147. package/build/adapters/qwen-code/hooks.js +0 -29
  148. package/build/adapters/qwen-code/index.d.ts +0 -40
  149. package/build/adapters/qwen-code/index.js +0 -361
  150. package/build/adapters/qwen-code/usage.d.ts +0 -90
  151. package/build/adapters/qwen-code/usage.js +0 -222
  152. package/build/adapters/types.d.ts +0 -360
  153. package/build/adapters/types.js +0 -118
  154. package/build/adapters/vscode-copilot/config.d.ts +0 -8
  155. package/build/adapters/vscode-copilot/config.js +0 -8
  156. package/build/adapters/vscode-copilot/hooks.d.ts +0 -71
  157. package/build/adapters/vscode-copilot/hooks.js +0 -98
  158. package/build/adapters/vscode-copilot/index.d.ts +0 -32
  159. package/build/adapters/vscode-copilot/index.js +0 -222
  160. package/build/adapters/zed/index.d.ts +0 -40
  161. package/build/adapters/zed/index.js +0 -163
  162. package/build/cli.d.ts +0 -34
  163. package/build/cli.js +0 -1827
  164. package/build/db-base.d.ts +0 -179
  165. package/build/db-base.js +0 -569
  166. package/build/executor.d.ts +0 -72
  167. package/build/executor.js +0 -678
  168. package/build/exit-classify.d.ts +0 -19
  169. package/build/exit-classify.js +0 -12
  170. package/build/fetch-cache.d.ts +0 -13
  171. package/build/fetch-cache.js +0 -15
  172. package/build/lifecycle.d.ts +0 -124
  173. package/build/lifecycle.js +0 -278
  174. package/build/runPool.d.ts +0 -36
  175. package/build/runPool.js +0 -51
  176. package/build/runtime.d.ts +0 -71
  177. package/build/runtime.js +0 -659
  178. package/build/search/auto-memory.d.ts +0 -47
  179. package/build/search/auto-memory.js +0 -170
  180. package/build/search/ctx-search-schema.d.ts +0 -90
  181. package/build/search/ctx-search-schema.js +0 -135
  182. package/build/search/flood-guard.d.ts +0 -57
  183. package/build/search/flood-guard.js +0 -80
  184. package/build/search/unified.d.ts +0 -56
  185. package/build/search/unified.js +0 -104
  186. package/build/security.d.ts +0 -206
  187. package/build/security.js +0 -780
  188. package/build/server.d.ts +0 -184
  189. package/build/server.js +0 -4563
  190. package/build/session/analytics.d.ts +0 -773
  191. package/build/session/analytics.js +0 -2420
  192. package/build/session/db.d.ts +0 -468
  193. package/build/session/db.js +0 -1308
  194. package/build/session/error-classifier.d.ts +0 -87
  195. package/build/session/error-classifier.js +0 -303
  196. package/build/session/event-emit.d.ts +0 -48
  197. package/build/session/event-emit.js +0 -101
  198. package/build/session/extract.d.ts +0 -333
  199. package/build/session/extract.js +0 -2688
  200. package/build/session/model-prices.json +0 -429
  201. package/build/session/persist-tool-calls.d.ts +0 -54
  202. package/build/session/persist-tool-calls.js +0 -105
  203. package/build/session/pricing.d.ts +0 -64
  204. package/build/session/pricing.js +0 -151
  205. package/build/session/project-attribution.d.ts +0 -73
  206. package/build/session/project-attribution.js +0 -245
  207. package/build/session/purge.d.ts +0 -138
  208. package/build/session/purge.js +0 -240
  209. package/build/session/retrieval-marker.d.ts +0 -39
  210. package/build/session/retrieval-marker.js +0 -65
  211. package/build/session/snapshot.d.ts +0 -46
  212. package/build/session/snapshot.js +0 -532
  213. package/build/store-directory.d.ts +0 -56
  214. package/build/store-directory.js +0 -254
  215. package/build/store.d.ts +0 -147
  216. package/build/store.js +0 -1714
  217. package/build/truncate.d.ts +0 -57
  218. package/build/truncate.js +0 -142
  219. package/build/types.d.ts +0 -117
  220. package/build/types.js +0 -20
  221. package/build/util/claude-config.d.ts +0 -32
  222. package/build/util/claude-config.js +0 -84
  223. package/build/util/hook-config.d.ts +0 -27
  224. package/build/util/hook-config.js +0 -76
  225. package/build/util/jsonc.d.ts +0 -14
  226. package/build/util/jsonc.js +0 -104
  227. package/build/util/plugin-cache-integrity.d.ts +0 -51
  228. package/build/util/plugin-cache-integrity.js +0 -146
  229. package/build/util/project-dir.d.ts +0 -149
  230. package/build/util/project-dir.js +0 -340
  231. package/build/util/sibling-mcp.d.ts +0 -79
  232. package/build/util/sibling-mcp.js +0 -181
  233. package/cli.bundle.mjs +0 -1236
  234. package/configs/antigravity/GEMINI.md +0 -68
  235. package/configs/antigravity/mcp_config.json +0 -7
  236. package/configs/antigravity-cli/hooks/hooks.json +0 -37
  237. package/configs/antigravity-cli/hooks.json +0 -37
  238. package/configs/antigravity-cli/mcp_config.json +0 -10
  239. package/configs/antigravity-cli/plugin.json +0 -14
  240. package/configs/antigravity-cli/rules/context-mode.md +0 -77
  241. package/configs/antigravity-cli/skills/context-mode/SKILL.md +0 -77
  242. package/configs/claude-code/CLAUDE.md +0 -91
  243. package/configs/codex/AGENTS.md +0 -99
  244. package/configs/codex/config.toml +0 -8
  245. package/configs/codex/hooks.json +0 -47
  246. package/configs/copilot-cli/.github/plugin/plugin.json +0 -23
  247. package/configs/copilot-cli/.mcp.json +0 -12
  248. package/configs/copilot-cli/README.md +0 -47
  249. package/configs/copilot-cli/hooks.json +0 -41
  250. package/configs/copilot-cli/skills/context-mode/SKILL.md +0 -38
  251. package/configs/cursor/context-mode.mdc +0 -76
  252. package/configs/cursor/hooks.json +0 -21
  253. package/configs/cursor/mcp.json +0 -7
  254. package/configs/gemini-cli/GEMINI.md +0 -88
  255. package/configs/gemini-cli/mcp.json +0 -7
  256. package/configs/gemini-cli/settings.json +0 -60
  257. package/configs/jetbrains-copilot/copilot-instructions.md +0 -80
  258. package/configs/jetbrains-copilot/hooks.json +0 -16
  259. package/configs/jetbrains-copilot/mcp.json +0 -7
  260. package/configs/kilo/AGENTS.md +0 -84
  261. package/configs/kilo/kilo.json +0 -6
  262. package/configs/kimi/hooks.json +0 -54
  263. package/configs/kiro/KIRO.md +0 -84
  264. package/configs/kiro/agent.json +0 -18
  265. package/configs/kiro/mcp.json +0 -7
  266. package/configs/omp/SYSTEM.md +0 -85
  267. package/configs/omp/mcp.json +0 -7
  268. package/configs/openclaw/AGENTS.md +0 -87
  269. package/configs/openclaw/openclaw.json +0 -13
  270. package/configs/opencode/AGENTS.md +0 -84
  271. package/configs/opencode/opencode.json +0 -6
  272. package/configs/pi/AGENTS.md +0 -3
  273. package/configs/qwen-code/QWEN.md +0 -91
  274. package/configs/vscode-copilot/copilot-instructions.md +0 -80
  275. package/configs/vscode-copilot/hooks.json +0 -16
  276. package/configs/vscode-copilot/mcp.json +0 -7
  277. package/configs/zed/AGENTS.md +0 -68
  278. package/hooks/antigravity-cli/payload.mjs +0 -98
  279. package/hooks/antigravity-cli/posttooluse.mjs +0 -138
  280. package/hooks/antigravity-cli/pretooluse.mjs +0 -78
  281. package/hooks/antigravity-cli/stop.mjs +0 -58
  282. package/hooks/auto-injection.mjs +0 -102
  283. package/hooks/cache-heal-utils.mjs +0 -379
  284. package/hooks/codex/platform.mjs +0 -1
  285. package/hooks/codex/posttooluse.mjs +0 -66
  286. package/hooks/codex/precompact.mjs +0 -70
  287. package/hooks/codex/pretooluse.mjs +0 -42
  288. package/hooks/codex/sessionstart.mjs +0 -121
  289. package/hooks/codex/stop.mjs +0 -138
  290. package/hooks/codex/userpromptsubmit.mjs +0 -75
  291. package/hooks/copilot-cli/posttooluse.mjs +0 -79
  292. package/hooks/copilot-cli/precompact.mjs +0 -66
  293. package/hooks/copilot-cli/pretooluse.mjs +0 -41
  294. package/hooks/copilot-cli/sessionstart.mjs +0 -121
  295. package/hooks/copilot-cli/stop.mjs +0 -59
  296. package/hooks/copilot-cli/userpromptsubmit.mjs +0 -77
  297. package/hooks/core/codex-caps.mjs +0 -112
  298. package/hooks/core/formatters.mjs +0 -356
  299. package/hooks/core/mcp-ready.mjs +0 -109
  300. package/hooks/core/platform-detect.mjs +0 -49
  301. package/hooks/core/routing.mjs +0 -1017
  302. package/hooks/core/stdin.mjs +0 -90
  303. package/hooks/core/tool-naming.mjs +0 -57
  304. package/hooks/cursor/afteragentresponse.mjs +0 -74
  305. package/hooks/cursor/hooks.json +0 -31
  306. package/hooks/cursor/posttooluse.mjs +0 -72
  307. package/hooks/cursor/pretooluse.mjs +0 -26
  308. package/hooks/cursor/sessionstart.mjs +0 -97
  309. package/hooks/cursor/stop.mjs +0 -48
  310. package/hooks/ensure-deps.mjs +0 -254
  311. package/hooks/formatters/claude-code.mjs +0 -113
  312. package/hooks/formatters/cursor.mjs +0 -37
  313. package/hooks/formatters/gemini-cli.mjs +0 -55
  314. package/hooks/formatters/vscode-copilot.mjs +0 -55
  315. package/hooks/gemini-cli/aftermodel.mjs +0 -70
  316. package/hooks/gemini-cli/aftertool.mjs +0 -61
  317. package/hooks/gemini-cli/beforeagent.mjs +0 -99
  318. package/hooks/gemini-cli/beforetool.mjs +0 -27
  319. package/hooks/gemini-cli/precompress.mjs +0 -55
  320. package/hooks/gemini-cli/sessionstart.mjs +0 -137
  321. package/hooks/heal-partial-install.mjs +0 -712
  322. package/hooks/jetbrains-copilot/posttooluse.mjs +0 -61
  323. package/hooks/jetbrains-copilot/precompact.mjs +0 -55
  324. package/hooks/jetbrains-copilot/pretooluse.mjs +0 -27
  325. package/hooks/jetbrains-copilot/sessionstart.mjs +0 -124
  326. package/hooks/kimi/platform.mjs +0 -1
  327. package/hooks/kimi/posttooluse.mjs +0 -72
  328. package/hooks/kimi/precompact.mjs +0 -80
  329. package/hooks/kimi/pretooluse.mjs +0 -42
  330. package/hooks/kimi/sessionend.mjs +0 -61
  331. package/hooks/kimi/sessionstart.mjs +0 -113
  332. package/hooks/kimi/stop.mjs +0 -132
  333. package/hooks/kimi/userpromptsubmit.mjs +0 -90
  334. package/hooks/kiro/agentspawn.mjs +0 -97
  335. package/hooks/kiro/posttooluse.mjs +0 -51
  336. package/hooks/kiro/pretooluse.mjs +0 -64
  337. package/hooks/kiro/userpromptsubmit.mjs +0 -88
  338. package/hooks/normalize-hooks.mjs +0 -323
  339. package/hooks/platform-bridge.mjs +0 -340
  340. package/hooks/posttooluse.mjs +0 -225
  341. package/hooks/precompact.mjs +0 -100
  342. package/hooks/pretooluse.mjs +0 -227
  343. package/hooks/qwen-code/platform.mjs +0 -1
  344. package/hooks/qwen-code/stop.mjs +0 -168
  345. package/hooks/routing-block.mjs +0 -105
  346. package/hooks/run-hook.mjs +0 -95
  347. package/hooks/security.bundle.mjs +0 -2
  348. package/hooks/session-attribution.bundle.mjs +0 -1
  349. package/hooks/session-db.bundle.mjs +0 -144
  350. package/hooks/session-directive.mjs +0 -520
  351. package/hooks/session-extract.bundle.mjs +0 -3
  352. package/hooks/session-helpers.mjs +0 -428
  353. package/hooks/session-loaders.mjs +0 -448
  354. package/hooks/session-snapshot.bundle.mjs +0 -32
  355. package/hooks/sessionstart.mjs +0 -464
  356. package/hooks/stop.mjs +0 -82
  357. package/hooks/suppress-stderr.mjs +0 -25
  358. package/hooks/userpromptsubmit.mjs +0 -108
  359. package/hooks/vscode-copilot/posttooluse.mjs +0 -61
  360. package/hooks/vscode-copilot/precompact.mjs +0 -55
  361. package/hooks/vscode-copilot/pretooluse.mjs +0 -27
  362. package/hooks/vscode-copilot/sessionstart.mjs +0 -129
  363. package/openclaw.plugin.json +0 -38
  364. package/scripts/heal-better-sqlite3.mjs +0 -430
  365. package/scripts/heal-installed-plugins.mjs +0 -598
  366. package/scripts/plugin-cache-integrity.mjs +0 -248
  367. package/scripts/postinstall.mjs +0 -384
  368. package/server.bundle.mjs +0 -1162
  369. package/skills/.ignore +0 -7
  370. package/skills/context-mode/SKILL.md +0 -300
  371. package/skills/context-mode/references/anti-patterns.md +0 -283
  372. package/skills/context-mode/references/patterns-javascript.md +0 -298
  373. package/skills/context-mode/references/patterns-python.md +0 -304
  374. package/skills/context-mode/references/patterns-shell.md +0 -277
  375. package/skills/ctx-index/SKILL.md +0 -46
  376. package/skills/ctx-insight/SKILL.md +0 -24
  377. package/skills/ctx-purge/SKILL.md +0 -49
  378. package/skills/ctx-search/SKILL.md +0 -35
  379. 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
- }