mrkeyoor.com_
Fri 11 Sept 16:00 UTC
LLM Toolsevaluationupdated 11 Sept 2026

OpenContext review

OpenContext keeps project notes and decisions in a local library so coding assistants can reuse them across sessions and repositories. Its command-line tool, desktop interface, and Model Context Protocol server let Cursor, Claude Code, and Codex find or update that material without replacing the coding agent you already use.

Verdict

Our OpenContext install pulled 1,041 packages and 821 MB, while npm audit reported 37 known vulnerabilities including 1 critical, so the dependency tree needs review before this belongs on a sensitive workstation. The local Markdown model and 10 MCP tools are a sensible fit for one developer who wants portable context across coding agents. Wait if you use Linux ARM64, depend on the v0.2.7 AppImage under Wayland, or need a mature team knowledge service.

We ran it

Lab card: what happened when we ran OpenContextScreenshot of OpenContext (0xranx.github.io/OpenContext)
Install✓ · 133s1041 packages · 821 MB
Buildn/ano build script
Tests✓ · 23s7 passed · 0 failed of 7 (node:test)
Known vulns371 critical · 22 high · 11 moderate · 3 low (npm audit)
Repo242 files~40,558 lines of source · 16.2 MB · 5 CI workflows · tests dir

Answers from our run

Does OpenContext build from source?

Dependencies installed in 133 seconds (1041 packages), and the project has no separate build step. We cloned commit 0649e71 into a clean Debian container with 3 CPUs and no project-specific setup.

Do OpenContext's tests pass?

Yes: 7 of 7 passed when we ran the project's own test command (node:test). Some failures need services or credentials a bare container does not have.

Does OpenContext have known vulnerabilities in its dependencies?

npm audit flagged 37 known advisories in the dependency tree, including 1 critical at the time of our run.

Who should not use OpenContext?

Security-sensitive workstations that cannot accept the measured dependency state: npm audit reported 37 known vulnerabilities, including 1 critical and 22 high.

What are the alternatives to OpenContext?

Mem0, Supermemory, Qdrant MCP Server. Our OpenContext install pulled 1,041 packages and 821 MB, while npm audit reported 37 known vulnerabilities including 1 critical, so the dependency tree needs review before this belongs on a sensitive workstation.

Setup3/5Quick CLI start, but native bindings and agent dotfiles add friction
Docs4/5README covers CLI, MCP, desktop, paths, and agent setup
Community3/51,059 stars and recent issue activity, with only 8 open items
Maturity2/5v0.2.7 has platform reports and 37 audited advisories

Who it’s for

Developers who repeatedly explain the same architecture and decisions to Cursor, Claude Code, or Codex.
MCP users who prefer inspectable Markdown files and a local database over a hosted memory service.
Individuals willing to curate folders, descriptions, and manifests so retrieved context stays useful.
Tauri or Node contributors who want a desktop UI and command-line workflow in one project.

Who it’s NOT for

Security-sensitive workstations that cannot accept the measured dependency state: npm audit reported 37 known vulnerabilities, including 1 critical and 22 high.
Linux ARM64 users expecting the published CLI to work without repair: issue 31 reports missing native-binding packages for that platform.
Wayland users who need a dependable AppImage on newer Intel Mesa stacks: issue 37 reports a blank v0.2.7 window and an EGL error.
Teams that prohibit setup tools from editing user-level agent configuration: oc init writes MCP, skill, and command files under Cursor, Claude Code, and Codex directories.
Organizations that require consistent license metadata before adoption: the repository LICENSE and README say MIT, while the measured commit's package metadata says Apache-2.0.

Setup reality

Our sandbox installed 1,041 npm packages in 133 seconds and used 821 MB. There was no build script or target, so we skipped that step. The Node test run succeeded in 23 seconds with 7 passed and 0 failed. Npm audit reported 37 known vulnerabilities: 1 critical, 22 high, 11 moderate, and 3 low.

Basic document storage needs Node 18 or newer and no hosted credential. Semantic indexing uses an embedding service and can require an API key; the bundled AI view has separate provider, base URL, model, and credential settings. Your existing coding-agent CLI remains a separate dependency.

The local store defaults to ~/.opencontext, with Markdown contexts, SQLite metadata, and a LanceDB index. oc init also changes user-level MCP and skill configuration. Linux ARM64 native bindings and one v0.2.7 AppImage setup have open platform-specific reports.

Ten MCP tools turn a local folder into agent memory

At commit 0649e71, OpenContext's MCP server registered 10 tools for listing folders, creating documents, searching, building manifests, resolving stable IDs, and checking the index. The underlying material remains Markdown under ~/.opencontext/contexts, with metadata in a local SQLite file. That is a good choice for personal knowledge because a failed UI does not trap the writing inside a remote service. You can inspect, back up, diff, or move the documents with ordinary file tools.

The product's definition of memory is refreshingly literal. You decide what belongs in the library, give folders and documents descriptions, and ask an agent to load a manifest or search before working. Stable oc://doc/ links survive renames by resolving an ID to the current path. OpenContext does not claim that every conversation becomes useful memory automatically. The quality of later retrieval still depends on what you saved and how clearly you described it.

One command edits configuration for three coding tools

oc init targets 3 clients: Cursor, Claude Code, and Codex. It creates user-level skills for all three, slash commands for the first two, and MCP configuration that launches oc mcp over standard input and output. This saves manual wiring, but it also means initialization writes outside the current repository. Read the generated instructions and existing JSON before using it on a carefully managed workstation.

OpenCode occupies an awkward middle ground. The README repeatedly names it as a supported coding-agent CLI, while the documented oc init selection and source code cover Cursor, Claude Code, and Codex. Issue 30, still open after a June 3, 2026 update, asks for OpenCode support. Treat OpenCode compatibility as something to verify in your exact workflow instead of assuming the same installation path exists.

What happened when we ran it

Our sandbox installed 1,041 npm packages in 133 seconds, leaving 821 MB on disk. The checkout was 16.2 MB and contained 242 files with about 40,558 lines of source. There was no build script or target available to the lab, so that step was skipped. The repository does document separate UI and Tauri build commands, but we cannot turn an absent top-level build target into a successful measured build.

The Node test run completed in 23 seconds: 7 tests passed and 0 failed. Our scan found 5 CI workflow files, a tests directory, and no Dockerfile. Npm audit reported 37 known vulnerabilities, split into 1 critical, 22 high, 11 moderate, and 3 low. The audit count does not tell us which flaws are reachable in the CLI or desktop app. It does make dependency review a required adoption task rather than routine cleanup.

Semantic search introduces an external embedding bill

Keyword-oriented folders and manifests can stay local, while vector indexing is a different path. The measured commit defaults to the text-embedding-3-small model and an OpenAI-compatible API base. It accepts embedding credentials and endpoint overrides through environment variables or ~/.opencontext/config.json. The repository instructions warn that an index build can incur external embedding cost. Confidential notes may leave the machine when you choose that provider-backed indexing mode.

OpenContext also has separate AI chat settings, including provider, API base, model, and API key. The default provider is OpenAI, with Ollama named as another option in the configuration source. This flexibility is useful, though it creates two decisions: where embeddings go and where chat prompts go. Teams should inspect both paths before importing internal architecture notes. A local document store alone does not guarantee that every feature processes data locally.

Native packages are the main platform risk in v0.2.7

The store requires Rust-backed native bindings when the CLI loads. Issue 31 reports that @aicontextlab/cli@0.2.2 on Linux ARM64 could not find the expected platform package, causing both oc folder ls and oc mcp to fail. The reporter built the binding from source as a workaround. That may suit a Rust developer, but it defeats the README's two-command setup for ARM servers and small single-board machines.

Desktop users have a separate concern. Issue 37 reports that the v0.2.7 AppImage opened a gray window on Wayland with Mesa 26.0.3 and Intel graphics. The supplied log repeatedly showed EGL_BAD_PARAMETER in bundled WebKitGTK. One report cannot establish general Linux compatibility, yet it is specific enough to test before moving a working document library into the desktop app. The CLI and local web UI remain possible routes if the AppImage fails.

June code activity and July reports show a young project

GitHub recorded 1,059 stars, 8 combined issues and pull requests, and a last push on June 16, 2026. The newest release, desktop-v0.2.7, arrived on January 30, 2026 with indexing, native-package, embedding-length, and editor fixes. Issue 37 was opened on July 3, so user activity continued after the last code push. The 3-month gap to this review is noticeable, though it is too short to call the project abandoned.

OpenContext suits one careful developer better than a team

OpenContext makes the most sense when 1 developer wants the same curated notes available to several coding agents. Markdown storage, MCP access, stable links, and a graphical editor form a coherent personal workflow. The 7 passing tests are encouraging for the narrow path our lab exercised, while 37 audit findings and native platform reports keep this out of the low-maintenance category. Back up ~/.opencontext, review generated agent files, and start with non-sensitive notes.

Mem0 or Supermemory is a better comparison for application-level user memory, while Qdrant's MCP server fits an existing vector database. OpenContext wins when human-readable documents and coding-agent setup matter most. It loses when you need shared access controls, hosted synchronization, ARM binaries that install cleanly, or evidence from a broader test suite. The project is useful today, but the measured dependency state makes a contained trial much easier to recommend than organization-wide adoption.

Alternatives

ProjectWhat it isPick it when
Mem0 gh↗A memory layer designed for agents and applications through APIs and SDKs.pick this instead when application-managed user memory matters more than a local Markdown library for coding tools.
Supermemory gh↗A memory and context engine with an app, API, and local deployment path.pick this instead when you need ingestion and memory APIs across several applications rather than agent dotfile integration.
Qdrant MCP ServerAn official MCP server that stores and retrieves memories through Qdrant.pick this instead when you already run Qdrant and want a narrower semantic-memory tool without OpenContext's desktop editor.

What people are saying

  1. [github-trending] 0xranx/OpenContext

Sources

  1. OpenContext README
  2. OpenContext package metadata at commit 0649e71
  3. OpenContext MCP server at commit 0649e71
  4. OpenContext Desktop v0.2.7 release
  5. Linux ARM64 native binding issue
  6. Wayland AppImage rendering issue
  7. OpenCode support issue

More llm tools reviews

hyperresearch · prompt-optimizer · agent-router · llm-for-zotero · webcodex · codegraph · the whole board →