context-mode 1.0.168 → 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 (395) 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/cache-heal.d.ts +0 -48
  163. package/build/cache-heal.js +0 -150
  164. package/build/cli.d.ts +0 -34
  165. package/build/cli.js +0 -1827
  166. package/build/concurrency/runPool.d.ts +0 -36
  167. package/build/concurrency/runPool.js +0 -51
  168. package/build/db-base.d.ts +0 -179
  169. package/build/db-base.js +0 -569
  170. package/build/executor.d.ts +0 -72
  171. package/build/executor.js +0 -678
  172. package/build/exit-classify.d.ts +0 -19
  173. package/build/exit-classify.js +0 -12
  174. package/build/fetch-cache.d.ts +0 -13
  175. package/build/fetch-cache.js +0 -15
  176. package/build/lifecycle.d.ts +0 -124
  177. package/build/lifecycle.js +0 -278
  178. package/build/openclaw/mcp-tools.d.ts +0 -54
  179. package/build/openclaw/mcp-tools.js +0 -198
  180. package/build/openclaw/workspace-router.d.ts +0 -29
  181. package/build/openclaw/workspace-router.js +0 -64
  182. package/build/openclaw-plugin.d.ts +0 -130
  183. package/build/openclaw-plugin.js +0 -626
  184. package/build/opencode-plugin.d.ts +0 -122
  185. package/build/opencode-plugin.js +0 -375
  186. package/build/pi-extension.d.ts +0 -14
  187. package/build/pi-extension.js +0 -451
  188. package/build/routing-block.d.ts +0 -8
  189. package/build/routing-block.js +0 -86
  190. package/build/runPool.d.ts +0 -36
  191. package/build/runPool.js +0 -51
  192. package/build/runtime.d.ts +0 -71
  193. package/build/runtime.js +0 -659
  194. package/build/search/auto-memory.d.ts +0 -47
  195. package/build/search/auto-memory.js +0 -170
  196. package/build/search/ctx-search-schema.d.ts +0 -90
  197. package/build/search/ctx-search-schema.js +0 -135
  198. package/build/search/flood-guard.d.ts +0 -57
  199. package/build/search/flood-guard.js +0 -80
  200. package/build/search/unified.d.ts +0 -56
  201. package/build/search/unified.js +0 -104
  202. package/build/security.d.ts +0 -206
  203. package/build/security.js +0 -780
  204. package/build/server.d.ts +0 -184
  205. package/build/server.js +0 -4542
  206. package/build/session/analytics.d.ts +0 -745
  207. package/build/session/analytics.js +0 -2369
  208. package/build/session/db.d.ts +0 -468
  209. package/build/session/db.js +0 -1308
  210. package/build/session/error-classifier.d.ts +0 -87
  211. package/build/session/error-classifier.js +0 -303
  212. package/build/session/event-emit.d.ts +0 -48
  213. package/build/session/event-emit.js +0 -101
  214. package/build/session/extract.d.ts +0 -333
  215. package/build/session/extract.js +0 -2688
  216. package/build/session/model-prices.json +0 -429
  217. package/build/session/persist-tool-calls.d.ts +0 -54
  218. package/build/session/persist-tool-calls.js +0 -105
  219. package/build/session/pricing.d.ts +0 -64
  220. package/build/session/pricing.js +0 -151
  221. package/build/session/project-attribution.d.ts +0 -73
  222. package/build/session/project-attribution.js +0 -245
  223. package/build/session/purge.d.ts +0 -138
  224. package/build/session/purge.js +0 -240
  225. package/build/session/snapshot.d.ts +0 -46
  226. package/build/session/snapshot.js +0 -532
  227. package/build/store-directory.d.ts +0 -56
  228. package/build/store-directory.js +0 -254
  229. package/build/store.d.ts +0 -147
  230. package/build/store.js +0 -1714
  231. package/build/tool-naming.d.ts +0 -4
  232. package/build/tool-naming.js +0 -24
  233. package/build/truncate.d.ts +0 -57
  234. package/build/truncate.js +0 -142
  235. package/build/types.d.ts +0 -117
  236. package/build/types.js +0 -20
  237. package/build/util/claude-config.d.ts +0 -32
  238. package/build/util/claude-config.js +0 -84
  239. package/build/util/hook-config.d.ts +0 -27
  240. package/build/util/hook-config.js +0 -76
  241. package/build/util/jsonc.d.ts +0 -14
  242. package/build/util/jsonc.js +0 -104
  243. package/build/util/plugin-cache-integrity.d.ts +0 -51
  244. package/build/util/plugin-cache-integrity.js +0 -146
  245. package/build/util/project-dir.d.ts +0 -149
  246. package/build/util/project-dir.js +0 -340
  247. package/build/util/sibling-mcp.d.ts +0 -79
  248. package/build/util/sibling-mcp.js +0 -181
  249. package/cli.bundle.mjs +0 -1235
  250. package/configs/antigravity/GEMINI.md +0 -68
  251. package/configs/antigravity/mcp_config.json +0 -7
  252. package/configs/antigravity-cli/hooks/hooks.json +0 -37
  253. package/configs/antigravity-cli/hooks.json +0 -37
  254. package/configs/antigravity-cli/mcp_config.json +0 -10
  255. package/configs/antigravity-cli/plugin.json +0 -14
  256. package/configs/antigravity-cli/rules/context-mode.md +0 -77
  257. package/configs/antigravity-cli/skills/context-mode/SKILL.md +0 -77
  258. package/configs/claude-code/CLAUDE.md +0 -91
  259. package/configs/codex/AGENTS.md +0 -99
  260. package/configs/codex/config.toml +0 -8
  261. package/configs/codex/hooks.json +0 -47
  262. package/configs/copilot-cli/.github/plugin/plugin.json +0 -23
  263. package/configs/copilot-cli/.mcp.json +0 -12
  264. package/configs/copilot-cli/README.md +0 -47
  265. package/configs/copilot-cli/hooks.json +0 -41
  266. package/configs/copilot-cli/skills/context-mode/SKILL.md +0 -38
  267. package/configs/cursor/context-mode.mdc +0 -76
  268. package/configs/cursor/hooks.json +0 -21
  269. package/configs/cursor/mcp.json +0 -7
  270. package/configs/gemini-cli/GEMINI.md +0 -88
  271. package/configs/gemini-cli/mcp.json +0 -7
  272. package/configs/gemini-cli/settings.json +0 -60
  273. package/configs/jetbrains-copilot/copilot-instructions.md +0 -80
  274. package/configs/jetbrains-copilot/hooks.json +0 -16
  275. package/configs/jetbrains-copilot/mcp.json +0 -7
  276. package/configs/kilo/AGENTS.md +0 -84
  277. package/configs/kilo/kilo.json +0 -6
  278. package/configs/kimi/hooks.json +0 -54
  279. package/configs/kiro/KIRO.md +0 -84
  280. package/configs/kiro/agent.json +0 -18
  281. package/configs/kiro/mcp.json +0 -7
  282. package/configs/omp/SYSTEM.md +0 -85
  283. package/configs/omp/mcp.json +0 -7
  284. package/configs/openclaw/AGENTS.md +0 -87
  285. package/configs/openclaw/openclaw.json +0 -13
  286. package/configs/opencode/AGENTS.md +0 -84
  287. package/configs/opencode/opencode.json +0 -6
  288. package/configs/pi/AGENTS.md +0 -3
  289. package/configs/qwen-code/QWEN.md +0 -91
  290. package/configs/vscode-copilot/copilot-instructions.md +0 -80
  291. package/configs/vscode-copilot/hooks.json +0 -16
  292. package/configs/vscode-copilot/mcp.json +0 -7
  293. package/configs/zed/AGENTS.md +0 -68
  294. package/hooks/antigravity-cli/payload.mjs +0 -98
  295. package/hooks/antigravity-cli/posttooluse.mjs +0 -138
  296. package/hooks/antigravity-cli/pretooluse.mjs +0 -78
  297. package/hooks/antigravity-cli/stop.mjs +0 -58
  298. package/hooks/auto-injection.mjs +0 -102
  299. package/hooks/cache-heal-utils.mjs +0 -379
  300. package/hooks/codex/platform.mjs +0 -1
  301. package/hooks/codex/posttooluse.mjs +0 -66
  302. package/hooks/codex/precompact.mjs +0 -70
  303. package/hooks/codex/pretooluse.mjs +0 -42
  304. package/hooks/codex/sessionstart.mjs +0 -121
  305. package/hooks/codex/stop.mjs +0 -138
  306. package/hooks/codex/userpromptsubmit.mjs +0 -75
  307. package/hooks/copilot-cli/posttooluse.mjs +0 -79
  308. package/hooks/copilot-cli/precompact.mjs +0 -66
  309. package/hooks/copilot-cli/pretooluse.mjs +0 -41
  310. package/hooks/copilot-cli/sessionstart.mjs +0 -121
  311. package/hooks/copilot-cli/stop.mjs +0 -59
  312. package/hooks/copilot-cli/userpromptsubmit.mjs +0 -77
  313. package/hooks/core/codex-caps.mjs +0 -112
  314. package/hooks/core/formatters.mjs +0 -356
  315. package/hooks/core/mcp-ready.mjs +0 -109
  316. package/hooks/core/platform-detect.mjs +0 -49
  317. package/hooks/core/routing.mjs +0 -1017
  318. package/hooks/core/stdin.mjs +0 -90
  319. package/hooks/core/tool-naming.mjs +0 -57
  320. package/hooks/cursor/afteragentresponse.mjs +0 -74
  321. package/hooks/cursor/hooks.json +0 -31
  322. package/hooks/cursor/posttooluse.mjs +0 -72
  323. package/hooks/cursor/pretooluse.mjs +0 -26
  324. package/hooks/cursor/sessionstart.mjs +0 -97
  325. package/hooks/cursor/stop.mjs +0 -48
  326. package/hooks/ensure-deps.mjs +0 -254
  327. package/hooks/formatters/claude-code.mjs +0 -113
  328. package/hooks/formatters/cursor.mjs +0 -37
  329. package/hooks/formatters/gemini-cli.mjs +0 -55
  330. package/hooks/formatters/vscode-copilot.mjs +0 -55
  331. package/hooks/gemini-cli/aftermodel.mjs +0 -70
  332. package/hooks/gemini-cli/aftertool.mjs +0 -61
  333. package/hooks/gemini-cli/beforeagent.mjs +0 -99
  334. package/hooks/gemini-cli/beforetool.mjs +0 -27
  335. package/hooks/gemini-cli/precompress.mjs +0 -55
  336. package/hooks/gemini-cli/sessionstart.mjs +0 -137
  337. package/hooks/heal-partial-install.mjs +0 -712
  338. package/hooks/jetbrains-copilot/posttooluse.mjs +0 -61
  339. package/hooks/jetbrains-copilot/precompact.mjs +0 -55
  340. package/hooks/jetbrains-copilot/pretooluse.mjs +0 -27
  341. package/hooks/jetbrains-copilot/sessionstart.mjs +0 -124
  342. package/hooks/kimi/platform.mjs +0 -1
  343. package/hooks/kimi/posttooluse.mjs +0 -72
  344. package/hooks/kimi/precompact.mjs +0 -80
  345. package/hooks/kimi/pretooluse.mjs +0 -42
  346. package/hooks/kimi/sessionend.mjs +0 -61
  347. package/hooks/kimi/sessionstart.mjs +0 -113
  348. package/hooks/kimi/stop.mjs +0 -132
  349. package/hooks/kimi/userpromptsubmit.mjs +0 -90
  350. package/hooks/kiro/agentspawn.mjs +0 -97
  351. package/hooks/kiro/posttooluse.mjs +0 -51
  352. package/hooks/kiro/pretooluse.mjs +0 -64
  353. package/hooks/kiro/userpromptsubmit.mjs +0 -88
  354. package/hooks/normalize-hooks.mjs +0 -323
  355. package/hooks/platform-bridge.mjs +0 -340
  356. package/hooks/posttooluse.mjs +0 -187
  357. package/hooks/precompact.mjs +0 -100
  358. package/hooks/pretooluse.mjs +0 -227
  359. package/hooks/qwen-code/platform.mjs +0 -1
  360. package/hooks/qwen-code/stop.mjs +0 -168
  361. package/hooks/routing-block.mjs +0 -105
  362. package/hooks/run-hook.mjs +0 -95
  363. package/hooks/security.bundle.mjs +0 -2
  364. package/hooks/session-attribution.bundle.mjs +0 -1
  365. package/hooks/session-db.bundle.mjs +0 -144
  366. package/hooks/session-directive.mjs +0 -520
  367. package/hooks/session-extract.bundle.mjs +0 -3
  368. package/hooks/session-helpers.mjs +0 -428
  369. package/hooks/session-loaders.mjs +0 -448
  370. package/hooks/session-snapshot.bundle.mjs +0 -32
  371. package/hooks/sessionstart.mjs +0 -464
  372. package/hooks/stop.mjs +0 -82
  373. package/hooks/suppress-stderr.mjs +0 -25
  374. package/hooks/userpromptsubmit.mjs +0 -108
  375. package/hooks/vscode-copilot/posttooluse.mjs +0 -61
  376. package/hooks/vscode-copilot/precompact.mjs +0 -55
  377. package/hooks/vscode-copilot/pretooluse.mjs +0 -27
  378. package/hooks/vscode-copilot/sessionstart.mjs +0 -129
  379. package/openclaw.plugin.json +0 -38
  380. package/scripts/heal-better-sqlite3.mjs +0 -430
  381. package/scripts/heal-installed-plugins.mjs +0 -598
  382. package/scripts/plugin-cache-integrity.mjs +0 -248
  383. package/scripts/postinstall.mjs +0 -384
  384. package/server.bundle.mjs +0 -1161
  385. package/skills/.ignore +0 -7
  386. package/skills/context-mode/SKILL.md +0 -300
  387. package/skills/context-mode/references/anti-patterns.md +0 -283
  388. package/skills/context-mode/references/patterns-javascript.md +0 -298
  389. package/skills/context-mode/references/patterns-python.md +0 -304
  390. package/skills/context-mode/references/patterns-shell.md +0 -277
  391. package/skills/ctx-index/SKILL.md +0 -46
  392. package/skills/ctx-insight/SKILL.md +0 -24
  393. package/skills/ctx-purge/SKILL.md +0 -49
  394. package/skills/ctx-search/SKILL.md +0 -35
  395. 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
- }