mrkeyoor.com_
Thu 17 Sept 09:11 UTC
AI Toolsevaluationupdated 01 Sept 2026

context-mode review

Context Mode is a local MCP server and coding-agent add-on that keeps bulky tool output out of the conversation window. It runs analysis in child processes, stores searchable material and session events in SQLite, then returns only selected output. Hook-capable clients can also restore working state after compaction.

+1,023stars / 7d
Verdict

Our 201-package Context Mode install built in 12 seconds, but the test command was still running at our 900-second cap, so installation is easier to trust than full verification. Use it when logs, web pages, and repeated file reads are consuming an agent's context and your client supports its hooks. Skip it for hookless editors, multi-session Windows workflows, hosted resale, or hosts where arbitrary code cannot inherit the agent's access.

We ran it

Lab card: what happened when we ran context-modeScreenshot of context-mode (context-mode.com)
Install✓ · 90s201 packages · 162 MB
Build✓ · 12s
Tests✗ timed out · 900sran, no count parsed
Repo599 files~145,227 lines of source · 12.4 MB · 5 CI workflows · tests dir

Answers from our run

Does context-mode build from source?

Dependencies installed in 90 seconds (201 packages), and the build succeeded in 12 seconds. We cloned commit b433086 into a clean Debian container with 3 CPUs and no project-specific setup.

Do context-mode's tests pass?

We could not finish them: the suite was still running after 15 minutes in our container.

Who should not use context-mode?

Linux users pinned below Node.js 22.5: the README says that runtime is unsupported and installation will stop with remediation instructions.

What are the alternatives to context-mode?

claude-mem, Context7, Mem0. Our 201-package Context Mode install built in 12 seconds, but the test command was still running at our 900-second cap, so installation is easier to trust than full verification.

Setup3/590-second install; tests exceeded the 900-second cap
Docs5/5Client setup, hooks, storage, security, and limits are specific
Community3/520,289 stars; 108 issues and 92 PRs were open
Maturity3/5Build passed; timeout and open runtime reports lower confidence

Discussed on

  1. hnMCP server that reduces Claude Code context consumption by 98%570 points
  2. hnShow HN: Context Mode – 315 KB of MCP output becomes 5.4 KB in Claude Code84 points

Who it’s for

Developers whose coding agents burn context on test logs, web pages, repository searches, or large API responses.
Claude Code users who want the project's simplest marketplace install and full hook coverage.
Teams using supported agent clients that want local session recovery without sending code or prompts to a Context Mode account.
Engineers willing to inspect routing rules, local storage, and process permissions before enabling agent-written code execution.

Who it’s NOT for

Linux users pinned below Node.js 22.5: the README says that runtime is unsupported and installation will stop with remediation instructions.
Zed or Antigravity IDE users expecting automatic routing and session recovery: the compatibility table says those clients have no hooks and need copied instruction files.
Teams that need billing-grade savings reports today: open issue 950 shows one chat exceeding the all-project total and a 100% claim when no sandbox execution tools were used.
Windows developers running several Claude Code sessions in one project: issue 985 reports shared SQLite contention causing CPU spin or an unresponsive server.
SaaS vendors planning to resell the server's substantial features: Elastic License 2.0 expressly forbids that hosted or managed use.
Locked-down environments where agent-written code must never inherit local files or CLI credentials: the README says the execution tools receive that host access.

Setup reality

Our sandbox installed commit b433086 in 90 seconds, adding 201 packages and using 162 MB. The build passed in 12 seconds. Tests did not finish within the 900-second limit. Their final visible lines showed several files completing successfully and one skipped executor case, but no error that explains the timeout.

Running Context Mode needs Bun or Node.js 22.5+, plus configuration for whichever coding agent will call its MCP server. Claude Code has a two-command marketplace path; other clients need a global install and configuration or plugin files. The core local path asks for no account or API credential, and SQLite data stays under the user's home directory.

Platform support is uneven: the README gives full continuity to some hook-capable clients, partial capture or routing to others, and no hooks to Zed or Antigravity IDE. On older glibc systems, better-sqlite3 may need a C++20 compiler. The execute tools inherit filesystem reach and CLI credentials from the host process, so production use needs the agent's own sandbox and permission policy.

Eleven tools move bulk output into local subprocesses

Context Mode v1.0.169 exposes 11 MCP tools in its Claude Code plugin: six execute, fetch, index, or search data, while five diagnose, report, upgrade, purge, or open its Insight view. The useful idea is that raw logs and responses stay in a child process. Only chosen stdout or retrieved snippets enter the model's conversation. Large output with an intent can be indexed first and searched locally instead of pasted into the prompt.

Our commit b433086 checkout contained 599 files and about 145,227 lines of source, so this is a sizable adapter and storage project rather than a thin command wrapper. It combines subprocess execution, SQLite FTS5 search, hook-based routing, and session-event capture. Developers who mostly lose context to one giant test log or a long GitHub response have a concrete reason to try it. A chat that is already concise will gain less.

Claude Code gets the shortest setup; hookless clients need manual routing

Claude Code v1.0.33 or newer gets the cleanest route: add the marketplace, install the plugin, restart, and run the supplied doctor command. That path registers the MCP server, lifecycle hooks, utility commands, and routing instructions. Gemini CLI, Copilot clients, Codex, Cursor, OpenCode, KiloCode, Kiro, Pi, OMP, and others each have separate instructions. The README is unusually explicit about which hook fires on which client.

The 90-second install in our Debian sandbox confirms that the dependency step can complete without secrets, but it does not make every client a two-command job. Most non-Claude paths require editing JSON or TOML, installing a plugin, or copying a routing file. Zed and Antigravity IDE lack hooks, so their instruction files can guide the model without intercepting a bad tool call. Codex and Cursor have their own partial-support caveats.

What happened when we ran it

Our sandbox installed 201 packages in 90 seconds and used 162 MB on disk. The build then completed in 12 seconds. Our measurement setup used commit b433086, 3 CPUs, 8 GB of RAM, and an unprivileged Node 22 container. The repository itself was 12.4 MB before dependencies. Those results make the basic checkout and compile path credible, with a moderate local footprint for a tool that bundles many client adapters.

The test command timed out at 900 seconds, so Context Mode did not produce a complete suite result on our box. The final log lines showed successful hook, session, adapter, policy, and core test files; one executor case was marked skipped. No assertion failure or timeout cause appeared in that tail. The checkout included a tests directory and 5 CI workflow files, while our scan found no Dockerfile. We cannot call the suite passing or assign a cause.

Local SQLite protects privacy; arbitrary execution still inherits host access

Context Mode keeps indexed content and session records in local SQLite databases, with a 24-hour default fetch cache and startup cleanup for content older than 14 days. The README says the core path has no account, cloud sync, or usage telemetry. Fresh sessions delete previous session data unless the user resumes, while indexed material can persist for search. Teams should still decide what local retention is acceptable before hooks record prompts and tool events.

The 12.4 MB checkout becomes 162 MB after our install, and the more important expansion is authority rather than disk. The README says authenticated command-line tools pass environment variables and config paths into execution subprocesses. It also warns that execute and batch-execute approve arbitrary code and retain the process's filesystem access. Project-boundary checks protect the file-processing tool, but they are not an operating-system sandbox. Keep the host agent's permissions and containment enabled.

Continuity works fully on some clients and not at all on two

Context Mode v1.0.169 documents full session continuity for Claude Code, Gemini CLI, VS Code Copilot, JetBrains Copilot, OpenCode, and KiloCode. Cursor and Codex have partial paths, while Zed and Antigravity IDE have no session hooks. The gap affects the main promise: without capture, compaction snapshots, and restore hooks, local search may still work while the agent cannot reconstruct its previous task state automatically.

Current issue reports add client-specific risk that our 900-second test run did not resolve. Issue 985 describes shared-project SQLite contention during concurrent Windows sessions, including CPU spin and hangs. Issue 1101 reports a Pi MCP process surviving session shutdown and growing its database. Issue 1085 traces HTTP 500 failures with a strict local Qwen template to extra system messages injected by the OpenCode adapter. These are scoped reports, not proof that every client fails.

The 200-item open queue and ELv2 narrow the buyers

GitHub listed 20,289 stars, 108 open issues, and 92 open pull requests when fetched on September 1, 2026. The repository's pushed date was also September 1, but the newest commits were automated install-stat updates. The latest release and most recent non-bot source change we found were v1.0.169 on June 29. Issue activity continued through September 1, so the project has current attention alongside a large review queue.

The 12.4 MB source tree uses Elastic License 2.0, which allows use, modification, and distribution but bars a hosted or managed service that exposes a substantial set of its features. That restriction rules out some vendors before technical testing. For permitted local use, Context Mode is most persuasive when an agent repeatedly swallows large tool output and the chosen client has full hooks. Choose claude-mem for memory first, Context7 for current docs, or Mem0 for application-level memory.

Alternatives

ProjectWhat it isPick it when
claude-mem gh↗Captures coding-agent sessions, compresses them with AI, and injects relevant history into later work.pick this instead when cross-session memory is the main job and tool-output sandboxing is secondary.
Context7 gh↗Supplies current library documentation to coding assistants through MCP.pick this instead when stale framework documentation is the problem and you do not need session capture or local code execution.
Mem0 gh↗Provides a general memory layer for agents and applications.pick this instead when you are building persistent memory into your own product rather than changing a coding agent's tool routing.

What people are saying

  1. [github-trending] mksglu/context-mode

Sources

  1. Context Mode README
  2. Context Mode repository activity and metadata
  3. Context Mode v1.0.169 release
  4. Elastic License 2.0 in Context Mode
  5. Issue 950: contradictory savings totals
  6. Issue 985: multi-session SQLite contention
  7. Issue 1101: Pi process survives session shutdown
  8. Issue 1085: OpenCode failure with strict Qwen templates

More ai tools reviews

yolov5 · eve · MemOS · LongCat-Video · Concat · DLSS5-Feeder · the whole board →