mrkeyoor.com_
Tue 01 Sept 17:40 UTC
LLM Toolsevaluationupdated 01 Sept 2026

open-knowledge review

OpenKnowledge is a desktop and local web editor that makes Markdown and MDX folders feel closer to Notion while keeping files in an ordinary project directory. It adds graph navigation, Git/GitHub sync, search, and side-by-side work with Claude, Codex, and other agents through MCP, CLI, and skills.

trackingstars / 7d
Verdict

Our OpenKnowledge run installed 1,934 packages and used 1,829 MB, then both build and test commands failed after 7 seconds in the native-config path. Trial the v0.67.2 desktop installer if you want a visual Markdown workspace with Claude Code and Codex access, since the lab failure covers the source checkout rather than the published installers. Wait or patch before adopting it as a remotely shared, role-based company wiki or as a contributor platform that must build cleanly in a fresh container.

We ran it

Lab card: what happened when we ran open-knowledgeScreenshot of open-knowledge (openknowledge.ai)
Install✓ · 78s1934 packages · 1829 MB
Build✗ · 7s
Tests✗ · 7sran, no count parsed
Repo5656 files~1,111,015 lines of source · 70.5 MB · 19 CI workflows

Answers from our run

Does open-knowledge build from source?

Dependencies installed in 78 seconds (1934 packages), and the build failed. We cloned commit 80817f2 into a clean Debian container with 3 CPUs and no project-specific setup.

Do open-knowledge's tests pass?

The test command failed in our container, and its output did not report a pass or fail count.

Who should not use open-knowledge?

Contributors who need a clean source checkout today: our install completed, but both build and test commands failed in the native-config package.

What are the alternatives to open-knowledge?

AppFlowy, Logseq, Zettlr. Our OpenKnowledge run installed 1,934 packages and used 1,829 MB, then both build and test commands failed after 7 seconds in the native-config path.

Setup2/5Install passed; source build and tests failed after 7 seconds
Docs4/5Clear installer, web, CLI, sync, and contribution paths
Community4/53,853 stars with a same-day release and issue activity
Maturity3/5v0.67.2 ships broadly, but source validation failed for us

Who it’s for

Developers who want a visual editor for specs and notes already stored as Markdown or MDX.
Claude Code and Codex users who want project knowledge exposed through MCP and agent skills.
Individuals who prefer local files and optional GitHub sync over a hosted document database.
Teams willing to test the official desktop installer separately from the failed source-build path we measured.

Who it’s NOT for

Contributors who need a clean source checkout today: our install completed, but both build and test commands failed in the native-config package.
Remote teams that need reader, editor, and administrator roles: open issue 1017 says every admitted browser or agent currently gets the same full read-write owner surface.
Gitea or Forgejo users expecting automatic sync: issue 1428 says auto-sync currently supports GitHub and fails with Gitea.
Writers who switch constantly between WYSIWYG and source mode and rely on undo: issue 1475 documents lost text and malformed table undo behavior.
Intel Mac users who require a desktop build: the README offers the macOS desktop app for Apple Silicon and directs other platforms to the web app.
Organizations unable to distribute or modify GPL-3.0-or-later software under that license's terms.

Setup reality

Our sandbox installed OpenKnowledge in 78 seconds, adding 1,934 packages and using 1,829 MB. The build failed with exit code 1 after 7 seconds. Its tail shows 0 of 2 Turbo tasks succeeded and names @inkeep/open-knowledge-native-config as the failed package, but it does not show the originating error.

The test command also failed with exit code 1 after 7 seconds. Its tail reports 0 of 4 tasks succeeded, with lifecycle failures in native-config and core. The source path requires Node.js 24, pnpm 10, Git, and native tooling. Desktop installers avoid that developer setup.

GitHub sync is optional but needs a GitHub login. Claude, Codex, and other agent integrations write MCP or skill configuration and may require project trust approval. The 5,656-file monorepo has 19 CI workflows, no Dockerfile, and no root tests directory.

OpenKnowledge 0.67.2 edits ordinary Markdown and MDX folders

OpenKnowledge 0.67.2 opens an existing folder of Markdown or MDX and adds a WYSIWYG editor, source view, file navigator, search, and a graph of wiki links. The files remain usable by Git and other editors. Desktop applications cover Apple Silicon macOS, Windows, Debian or Ubuntu, and Fedora or RHEL. A Node.js CLI serves the same editor in a browser, making servers and Intel Macs possible without a dedicated desktop package.

The breadth comes with a large source tree. Our measured checkout contained 5,656 files, about 1,111,015 lines of source, and 70.5 MB before dependency installation. Workspaces cover the app, server, core Markdown machinery, CLI, Electron desktop shell, documentation, and a Rust-backed native configuration package. Nineteen CI workflow files show substantial automation, while the repository has no Dockerfile or root tests directory. Tests live inside packages instead.

What happened when we ran it

Our sandbox installed 1,934 pnpm packages in 78 seconds and used 1,829 MB on disk. The build then failed with exit code 1 after 7 seconds in a fresh unprivileged container with 3 CPUs and 8 GB of RAM. Turbo reported 0 successful tasks out of 2. The tail named @inkeep/open-knowledge-native-config#build as failed and showed a core build lifecycle failure, followed by the top-level lifecycle exit.

The test command failed with exit code 1 after another 7 seconds. Its summary reported 0 successful tasks out of 4, with failures for the native-config test and core test lifecycle. The supplied tails do not contain the first diagnostic that caused native-config to exit, so they do not justify blaming Rust, pnpm, the container, or a missing system package. They establish a narrower fact: commit 80817f2 did not build or complete its test command in our stated environment.

Seven release installers avoid the failed source path

Release v0.67.2 publishes 7 installers: one Apple Silicon DMG, 2 Windows packages, 2 Debian or Ubuntu packages, and 2 Fedora or RHEL packages. The patch suppresses a false crash prompt after an Electron GPU process recovers. Those artifacts use a separate delivery path from our source checkout. A failed monorepo build is a reason to pause contribution work, but it does not show that any installer fails to launch.

Source development is materially heavier. Our successful dependency step pulled 1,934 packages and occupied 1,829 MB before the build stopped. The repository requires Node.js 24 or newer and pnpm 10, while native-config uses a Rust N-API build for format-preserving edits to agent configuration. The contributing guide says a fresh clone should build and test without environment variables. Our 7-second failures contradict that expectation for the measured Debian sandbox, even though the log tail is too short to identify the missing condition.

MCP and Claude Code integration writes project trust configuration

OpenKnowledge can help agents search and edit a project through MCP, CLI commands, and installed skills. The app detects Claude Code, Claude Desktop, Cursor, Codex, OpenCode, and OpenClaw, then offers to wire the project into their configuration. This is useful when a specification should remain readable Markdown while an agent searches it with more structure than a raw file scan. Git and GitHub provide optional sync and team sharing underneath the editor.

Issue 1477 shows version 0.66.2 marking Claude and Codex connections as installed while still displaying yellow approval guidance, leaving the reporter unsure whether another security step remained. The message does not prove MCP access failed, but it warrants checking the generated .mcp.json and .codex/config.toml, confirming the 1,829 MB local installation you intend to run, and approving only projects whose instructions and tools you trust.

Remote users share one owner-level permission surface

Open issue 1017 describes remote access as a trust-the-tunnel system. Cloudflare Access, Tailscale, or ngrok can decide who reaches the server, but every admitted browser or agent then receives the same read-write owner surface. There is no built-in reader, editor, or administrator role, no per-agent revocable project credential, and no application-level attribution for each remote person. That is acceptable for a personal project and a poor fit for a shared company service.

GitHub is the supported collaboration provider, while issue 1428 says Gitea auto-sync fails. The 19 CI workflows and million-line monorepo do not fill that product gap. Forgejo or Gitea users can manage the Markdown repository outside the app; they should not expect no-code sync until their provider is documented and tested. Outline is the more direct alternative when user roles and a central team wiki are mandatory.

Source and visual editing still have a shared undo bug

Open issue 1475 reports undo corruption in version 0.64.1 when switching between WYSIWYG and source views. One reproduction removes an earlier paragraph after edits cross between views. Another adds table columns when two fast edits fall into one 500-millisecond Yjs undo frame, then places redone text before the table. The issue remained open on September 1, 2026. Writers who alternate views should reproduce both cases on v0.67.2 before trusting a long session.

GitHub recorded 3,853 stars, 34 combined issues and pull requests, and a September 1, 2026 push. The v0.67.2 release landed the same day. Our 78-second install proves the dependency graph resolves in the lab, while the two 7-second failures show that resolution is not enough for source adoption. The desktop app deserves a contained trial with a copied Markdown folder. A team deployment should wait for role separation, verify its sync provider, and demand a clean build on its own supported image.

Alternatives

ProjectWhat it isPick it when
AppFlowy gh↗An open-source workspace with documents, databases, collaboration, and optional AI.pick this instead when Notion-style databases and team workspace features matter more than plain Markdown files.
Logseq gh↗A local knowledge graph centered on linked outlines and daily notes.pick this instead when block references, journaling, and an outliner are the main way you organize knowledge.
ZettlrA desktop Markdown writing environment aimed at research and publication work.pick this instead when citations, long-form writing, and plain Markdown editing matter more than agent integration.
Outline gh↗A self-hosted collaborative knowledge base with team-oriented permissions and live editing.pick this instead when a shared company wiki with user roles is more important than local folder ownership.

What people are saying

  1. [github-trending] inkeep/open-knowledge

Sources

  1. OpenKnowledge README
  2. OpenKnowledge v0.67.2 release
  3. Measured commit 80817f2
  4. Remote identity and authorization issue
  5. Gitea sync request
  6. WYSIWYG and source undo issue
  7. Project AI tools setup issue

More llm tools reviews

rig · graphiti · cve-mcp-server · minimind · SillyTavern · Hy4-preview · the whole board →