• Node 24.15.0 or later. 1.x needed Node 22.5. 2.0 uses node:sqlite, and 24.15.0 is the first version with it unflagged. Bun and better-sqlite3 are gone.
• Data store. Each project has one context.db under ~/.context-mode. 2.0 starts a new index and does not copy 1.x data. ctx_doctor shows where the 1.x data is and its size, and nothing gets deleted without asking you.
• Setup. The CLI has three commands: context-mode setup, context-mode doctor and context-mode upgrade. Setup shows a plan, saves your config, then applies the plan; it also replaces 1.x entries. The 1.x hook forms (context-mode hook <platform> <event> and mcp) still run, and doctor asks you to run setup to rewrite them.
• Tools. Nine tools: ctx_execute, ctx_batch, ctx_index, ctx_search, ctx_resume, ctx_stats, ctx_doctor, ctx_upgrade, ctx_purge.
  • ctx_execute_file is now ctx_execute with a file field.
  • ctx_batch_execute is now ctx_batch.
  • ctx_fetch_and_index is now ctx_index with a url field.
  • ctx_insight and context-mode insight are gone.
• Removed in 2.0: statusline, HTTP daemon mode, the CLI index and search commands, routing files in your project (CLAUDE.md, AGENTS.md templates). The routing now lives in the tool descriptions, so setup never writes your instruction files.
• Agents. 2.0 supports 10 agents. Cursor, JetBrains Copilot, Kimi, Codex Desktop, OpenClaw, OMP (Oh My Pi), Antigravity (agy) and Zed are not in 2.0. To keep one of them, stay on 1.0.169.
• Your settings stay. Setup and /ctx-upgrade keep your own hooks, hook timeouts, permissions.deny and MCP entries.

The step to move: run your agent's command from the table above, restart the agent, run /ctx-upgrade, then /ctx-doctor. If you installed 1.x with npm, remove the old global package only after that: npm uninstall -g context-mode comes last, because 1.x hooks call the global command until /ctx-upgrade replaces them.

• ctx_search ranks every agent's memory files together with indexed content, and a source filter that names a memory file searches that file. 4415e2f 5ef0a2a
• Search ranks in layers: stopwords, chunks that match every term first, then an OR fallback when hits are few. ba1b9b7 60e1b62
• Search uses porter stemming and a chunk title column. c1fd04f
• Search adds a trigram table, RRF fusion and typo correction from the index vocabulary. f8f7850
• Markdown chunks split on headings and keep the title path; code fences never split, and inline content with a heading or fence chunks as markdown. 697b13a 7a26490
• Fetched HTML turns into readable markdown before chunking. 7b47de8
• Snippets are verbatim, fence-aware and chosen by score; a snippet takes a whole neighbour fence, and typo words place it by prefix. 62ac32c de09a61
• A relevance reply holds 5 hits, and More: pages the rest with one line per cursor. c312684 c028484
• Replies are lean when the top hit holds every query word, and smaller on small sources with no empty query blocks. c028484 0841fda
• A search over a JSON source returns whole BM25-ranked rows. 30c84f3
• A source query with no matching words lists that source's chunks by position. ce89bfc
• A stored label wins over a handle; a long label shows as handle, size and preview. a621d67
• A NUL in a query splits words and gives a normal result. eb52358
• Chunks keep a line over the small cap whole, so search returns the whole line. 6fefd96
• Search typo correction, scoped ranking and prepared statements run faster (perf). d36b505 e52388a 36ebb21

• The hook never errors: all 10 hosts share one fallback decision. 6de9825
• The shell-dump deny checks every command in a chain, follows cd and unwraps zsh -c. 9fba2c5
• The policy scans command substitutions inside $(( )). 8e7edda
• Unbounded PowerShell file dumps (Get-Content, gc, type, [IO.File]::ReadAllText) get the same deny as cat. 765be33
• The Windows deny glob uses forward slashes and a drive-less // anchor. 872216b
• The Read deny is one line with the exact ctx_execute call for the file. 6c9f8a3
• The main agent runs the tool, then the hook replaces large output with the best chunks. 3f4a4d0 16df63b
• The replace ranks chunks by the call's intent or the last user prompt words; with no description, intent comes from the command, path, pattern or URL. 8db7170 ae0a316
• The replace shapes output by content type, reads the whole stored Bash output, and the digest header carries counts only. 85c34f0 41eb547 ed0108c
• Non-ctx MCP results and Grep content results get the same replace; one-off categorical rows count as rare units. 90e3dce 37cc74b
• JSON output gets a digest header with the schema and numeric extremes for a named key, inside its own 256 B budget. 9433273 2ebdf84
• The replacement names the stored source by short id, size and the search call to run. 4bf03c9 c98b71a cccb08c 5e4a973 d5c1302
• The handle line adds the prompt words the output holds as a second query. 7e4d397
• Replace output stays clean at an empty body and the selection budget stops at 0. 0a4a77d fef7843
• Hook texts name tools with each host's own tool prefix on all 10 hosts. 054eb84
• The hook reads stdin as a stream in its entry. 693403b

• ctx_doctor shows an environment line, docs links and a ready agent issue report; .github/AGENT_ISSUE.md is in the repo. 2f807ae baaa314
• The report names the exact context-mode command to run. e37a961 4471e08
• The report fits 80 columns, with one docs link under the table and a wrapped gh command. 88972ba
• ctx_doctor heals an orphan WAL and always returns its report; the report is stored whole and long echoes are named by id. 14e488e 42750b1
• The version check starts git directly, names the exact cause, and compares in the bundle's channel: npm dist-tag first, git tags as fallback. 1eaec71 a65cd5a b542a67
• New checks: hook registered, hook runs, hook seen and skills. 780424c
• The hook-runs check confirms the saving effect on each host. 2e1fe50
• Doctor and setup fail when a host would run none of the installed hooks: Claude Code, Codex, Gemini CLI, Qwen Code, Pi, OpenCode, Copilot CLI, Kiro, VS Code and ZCode. 2250118 a66617d 6cd19e8 56f7284 6cba095 2600dbf 238e9c3 da5120d 807ae9a 5ef1f18
• The hook cost check covers all 10 agents, measures over bare node and runs 3 to 9 pairs, more only while over the bound. b542a67 7b68b5b 37a4804
• The hook cost check uses recorded native payloads and labels old hook errors as past. ea4179f
• The config check matches setup for Codex and MCP hosts and names setup for a missing MCP entry. 9dd4414 b542a67
• The config check accepts the quoted absolute-path hook command that setup writes. 3d8c491
• Report-only 1.x findings do not fail an agent that is set up. 9bce0b5
• Doctor verifies a native Codex plugin install and native Gemini CLI and Qwen Code extension installs; a disabled extension names the enable command. 9781e1c 518f406
• The report path prints with forward slashes on Windows. 6598e09

• New setup, doctor and upgrade commands with prompts, a report, typo hints, progress and rollback on abort. 966af39 b1d4f91 0483b1c ef8c727
• Each command has its own --help; help <command> opens it, and output falls back to 80 columns when a terminal reports 0. 02cb17a d3638ec
• setup --print <agent> prints the manual step for that agent and writes nothing. 68e87b8
• Setup writes the hook and skill channel for every agent. a90f47d c3eb44c
• Install docs lead with each agent's native install command, then the update, check and next steps, in short plain commands. 2e64a6b 3c0656a
• CLI help, setup and doctor output use 2.0 wording. 4b1a762
• --yes works with no terminal. e86bddc
• Agent CLI install steps get 120 s, so a first run can unpack its package. feb8de1
• The hook gate takes the best of 3 rounds, so host noise does not roll back a good install. 0c9613a
• Setup finds its own hook entries by hook.mjs --agent <id> and rewrites 1.x hook commands in flat hook files. b9b1a58 87a44c9
• Home-dir skills render from the bare-name skill dir with no doubled tool prefix. a7e3807
• The CLI, server and hook run on Node 22 and on Node below 22.3; setup reaches its report even on an EPIPE. 257a519 7b0df43 80fabdb 249f03b

Claude Code

• The PowerShell tool routes like Bash in PreToolUse, PostToolUse and hook matchers (#1212). f65e531
• Setup enables a disabled plugin; doctor fails on disableAllHooks. 2250118
• Setup, doctor and plugin root honour CLAUDE_CONFIG_DIR. 01e0654
• The project comes from CLAUDE_PROJECT_DIR, then payload cwd, then process.cwd(). 71ae2bc
• The decoder names missing required fields and defaults the rest. 78de5ab
• Doctor fails on a stale plugin copy; setup and upgrade run claude plugin update and keep the dist-tag. 1aa584d
• Setup and doctor find the real claude past a PATH shim and print the binary used. 37fd45c
• Doctor judges the install this project uses (scope, projectPath, enabledPlugins, CLAUDE_PLUGIN_ROOT) and reads the plugin root from installed_plugins.json. b353268 4653f73
• Claude Code gets its own rendered skills dir. 02e28bc
• The npm package carries .claude-plugin/marketplace.json with the owner object. 1d0c754 5c41eb6
• Uninstall deletes a marketplace root only inside the plugin cache. 58d6b74
• Claude Code never runs the Gemini hooks file under /bin/sh. 96e3672

Codex

• Setup trusts its own plugin hooks after a native install and after hooks/list; doctor fails on untrusted hooks with one shared check. a66617d 9508005 b93adce
• The trust key handles Codex 0.166 composite hashes, an empty app-server reply, a symlinked HOME and the codexHome spelling Codex reports. bbd7cef 4fb62aa 2f3bc32
• Setup waits up to 5 s for Codex to close after hooks/list and ends the whole process tree. 7c72685 16a4bcc
• Config, hooks, skills and doctor follow CODEX_HOME and the home the running plugin sits in. 952e2fc da6f91e 9e08df0
• The native plugin MCP resolves the host workspace, not the plugin cache dir. c988ff4
• The MCP entry sets omit_tools_from = ["deferred"] and default_tools_approval_mode = approve, so ctx tools are direct. 056ef92 efdedf4
• Setup reads and edits any valid TOML 1.0 config. bf51198
• On Windows the hook command starts with bare node, since Codex 0.166 runs hooks in PowerShell. 135120e 31bb89d
• Plugin skills use Codex tool names; the marketplace on main points at the built plugin. d6f964f c961fda

Gemini CLI

• The row lists native tool ids, so shell and read rules reach BeforeTool. ecbe91f
• BeforeTool denies a one-file shell dump over the cap before it runs. 5aaf456
• A resume hint shows on the first BeforeAgent of a session. 831368b
• The extension carries the extensionPath server path and hooks/hooks.json; setup links it and never waits on stdin. 8d11ff6 8b6e4b6
• Skills render with Gemini tool names; doctor reads the extension hook file with the ${/} separator. 46a5892 8a36930
• Setup accepts the Windows exit-time crash of gemini extensions link when the extension is listed. c303961

Qwen Code

• The extension carries the extensionPath server path and hooks key; docs show the native extension install. 8feb0c4 c507e00
• The skills channel is the package skills/ dir with Qwen tool names. b20637f

Pi

• Pi gets the same system prompt every turn, so the prompt cache holds. e1b9821
• The out tree has a Pi-only package.json; skills use Pi tool names. ffd762d 46a5892
• An empty PI_CODING_AGENT_DIR counts as unset. f98750f

OpenCode

• The OpenCode 2 native install is opencode plugin add context-mode@next. 591197c
• The plugin loads on OpenCode 2 and on the 1.19.4 loader. 2600c92 78af6be ad0e8a2 861d607
• One working plugin entry; doctor fails on a double or stale entry. 2600dbf
• The bash tool routes through the hook. 2e1fe50
• Setup lists with --pure, follows OPENCODE_CONFIG_DIR and XDG_CONFIG_HOME, and reads opencode.json as JSONC. 09465cc 7ce8d4d 14710eb

Copilot CLI

• The decoder reads the documented payload with no hookEventName. ff999dd
• The own MCP tool prefix is context-mode-; skills and deny texts name the real tool, and shared skills serve both Copilot CLI and VS Code. dcc576e 850821b b195b99
• Setup checks hooks are enabled and cleans disabledHooks. 238e9c3
• Hooks, skills and detection follow COPILOT_HOME. 5094c63
• Hook entries get an explicit powershell field, also on VS Code. 7aaaf89

Kiro

• The decoder reads camelCase tool events and the UserPromptSubmit trigger; shell matcher names follow Kiro docs. 397cc04 c507e00 1830135
• Kiro registers the shell tool execute_bash next to @mcp; deny text goes to stderr with exit 2. d13980c
• Hooks, MCP entry, skills and detection follow KIRO_HOME. 663aa66

VS Code

• The decoder reads the camelCase hook payload and maps every documented terminal, read and fetch tool. 16fa82b a531951
• The project comes from --workspace-folder ${workspaceFolder} and the payload cwd; run_in_terminal is the shell. 51fd189
• The MCP entry goes to the user-profile mcp.json; doctor reads the user hook file setup writes. 38c191e db09aee
• Skills move to ~/.agents/skills. b195b99

ZCode

• Setup writes matcher groups and mcp.servers/features.mcp; uninstall drops the nested entry. 6be8e76

• Home is USERPROFILE first on Windows and HOME first elsewhere, from one helper; doctor names USERPROFILE when no home is found. 7b54a2e d6a0648 8c9d87a
• File writes retry a busy rename (EPERM, EBUSY, EACCES), name the held file and clean their tmp file. d788697 31c21f7 567970c 3874f2c 49db049 ee95ebb
• Setup finds agent CLIs via PATHEXT and runs .cmd shims through cmd.exe with /v:off. 6fcc311 76029ea 37db76f
• The shim line refuses only a %NAME% that cmd.exe would expand, so file URLs with %7E or %20 pass. 2c1b166 c38d4a2
• Double quotes in PATH entries are cut. 0ba3728 cf1abd1
• Every child process starts hidden. bb4045e
• Host config files with a BOM and CRLF read correctly and keep their layout and line ends on write. cf6a343 b3a3256
• The sandbox shell is Git Bash from the installed Git. 46cb4ca
• The current upgrade link is a junction on Windows. 941ea21
• Kiro, Copilot CLI, VS Code and Codex fixes for Windows homes and paths are in Per agent. 663aa66 5094c63 38c191e 135120e
• Store labels for path sources use forward slashes on every OS. bbee5c2
• Doctor prints the report path with forward slashes. 6598e09
• Hook start loads node:fs through getBuiltinModule, cutting Windows hook overhead (perf). 12a51f7

• Releases run from main in one click: plan, npm publish, release commit and tag in one push, and a GitHub release; rollback is a forward commit. 4aab995 b3db26c 2d6ab77
• The main tree holds plugins/claude-code, both marketplaces and root Gemini CLI and Qwen Code manifests from the packed package. a3642a3 ace68ce c961fda
• Smoke tests cover the main layout, a Qwen Code leg and the native Codex commands. ebd0a74 c961fda
• A pushed release tag sets the version, prerelease versions build, and a prerelease GitHub release is not marked latest. 21d8e43 e2bee53 7894f2d 630a61c 7d37721
• The GitHub release runs after npm publish. 6136a9c c3a1ae2
• One config file lists the npm names a release publishes. 3f78ebd
• The package carries repository.url for npm provenance. 496670b
• The npm package ships README.md and LICENSE with absolute links, and a cli.mjs bin. 84f719f 68e0af5 207ba63
• Plugin manifests carry the 2.0 version and description; package.json is the source of release fields with no unused deps. 322aadc 1e2f68f
• Codex plugin manifests and the OpenCode package main ship in the npm package. 861d607
• The generated tool file is rewritten only when changed, through temp and rename. adc4420
• The README shows an agent table, daily npm download charts, a working star chart and daily adoption history from GitHub and npm. fef7750 d0aee2d 33775e3 45caf2e e19d949 a74baad 9f20042