Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
main reset: post-stable v0.34.0 (#2709)
inkeep-internal-ci[bot]d1ad0d91ad46
diff --git a/.changeset/bug-report-server-exit-reason.md b/.changeset/bug-report-server-exit-reason.mddeleted file mode 100644index b03891ac2..000000000--- a/.changeset/bug-report-server-exit-reason.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": patch------Report a bug now records why the server last exited. When the background server process goes away, the desktop app writes the exit code and the reason it left (a clean shutdown, a crash, or an out-of-memory / OS kill) to `state/last-server-exit.json` in the report bundle, next to `server.lock`. Until now a bundle could only show that the server's port was "unreachable", which looks identical whether the server crashed or was shut down cleanly, so a "my app crashed" report could not be told apart from a routine stop. The new record captures the death even when the server was killed and had no chance to log anything itself. It holds only the exit code, the reason, the pid, and a timestamp, so it carries no document content or paths.diff --git a/.changeset/git-helper-path-resolution.md b/.changeset/git-helper-path-resolution.mddeleted file mode 100644index 2118da1b8..000000000--- a/.changeset/git-helper-path-resolution.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": patch------Opening a shared branch in a worktree (and other git operations) no longer fails with a generic error when the repository uses git-lfs installed via Homebrew. The desktop app and its server now append well-known tool directories (Homebrew, MacPorts, `~/.local/bin`, asdf/mise shims) to the PATH used for git commands, so helpers git spawns mid-operation — LFS filters, credential helpers, hooks — resolve even though macOS launches apps with a minimal PATH. When a required helper still can't be found, the error now names it ("Git needs git-lfs…") instead of a retry-blind generic message, and the underlying git error is recorded in the desktop log.diff --git a/.changeset/link-previews-on-by-default.md b/.changeset/link-previews-on-by-default.mddeleted file mode 100644index 0131192c5..000000000--- a/.changeset/link-previews-on-by-default.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": minor------External link hover previews are now on by default. Previously they shipped off by default (opt-in). Hovering an external link in the editor now shows a preview card — site name, page title, description, favicon — fetched by your local server, which sends that link's URL to the destination site (one request per previewed link). Turn it off per machine in Settings → Link previews, which sets `linkPreviews.enabled: false` in project-local config. Unchanged: the SSRF guard still refuses to fetch private or internal hosts, no cookies or credentials are attached, results are cached locally, and any fetch failure falls back silently to the plain URL pill. Internal document-to-document previews were already always on and read entirely from the local index with no network request. Note: external previews are not yet available in the packaged desktop app; this default applies to the browser and `ok ui` surfaces.diff --git a/.changeset/mermaid-wysiwyg-canvas.md b/.changeset/mermaid-wysiwyg-canvas.mddeleted file mode 100644index 12ec6d0e1..000000000--- a/.changeset/mermaid-wysiwyg-canvas.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": minor------Mermaid diagrams are now fully visually editable. The diagram renderer is powered by mermaid-wysiwyg: click any node, edge, participant, or message to select it and get an action popover right on the diagram (change node shape, edge type, colors, message arrows, participant types, duplicate, delete, and more), double-click any label to edit its text in place, drag between nodes to connect them, and drag sequence messages to reorder. Every gesture becomes a minimal edit to the underlying Mermaid source, so the code fence (or standalone .mmd doc) stays the source of truth and collaborative editing keeps working. Diagram styling, theming, and the pan/zoom controls are unchanged.diff --git a/.changeset/pre.json b/.changeset/pre.jsonindex c3902f2f2..3df08f794 100644--- a/.changeset/pre.json+++ b/.changeset/pre.json@@ -2,15 +2,15 @@"mode": "pre","tag": "beta","initialVersions": {- "@inkeep/open-knowledge-docs": "0.0.22",- "@inkeep/open-knowledge-app": "0.33.0",- "@inkeep/open-knowledge": "0.33.0",- "@inkeep/open-knowledge-core": "0.33.0",- "@inkeep/open-knowledge-desktop": "0.33.0",- "@inkeep/md-conformance": "0.0.30",+ "@inkeep/open-knowledge-docs": "0.0.23",+ "@inkeep/open-knowledge-app": "0.34.0",+ "@inkeep/open-knowledge": "0.34.0",+ "@inkeep/open-knowledge-core": "0.34.0",+ "@inkeep/open-knowledge-desktop": "0.34.0",+ "@inkeep/md-conformance": "0.0.31","@inkeep/open-knowledge-native-config": "0.0.0","@inkeep/open-knowledge-plugin": "0.3.1",- "@inkeep/open-knowledge-server": "0.33.0"+ "@inkeep/open-knowledge-server": "0.34.0"},"changesets": []}diff --git a/.changeset/remove-bun-toolchain-migration.md b/.changeset/remove-bun-toolchain-migration.mddeleted file mode 100644index cdc1f2c63..000000000--- a/.changeset/remove-bun-toolchain-migration.md+++ /dev/null@@ -1,32 +0,0 @@-----"@inkeep/open-knowledge": patch------Migrate the build, test, and CI toolchain from Bun to pnpm 10 and Vitest 4.--This is an internal toolchain migration with no runtime behavior change for the-published CLI: it still runs on Node (`engines.node >= 24`, shebang-`#!/usr/bin/env node`). The workspace is now a standard pnpm workspace-(`pnpm-workspace.yaml` + `pnpm-lock.yaml`), all five test tiers run under Vitest-via a `bun:test` compatibility shim and a `Bun.*` facade, and every TypeScript-entry point runs through Node + `tsx`. `bun.lock`, `bunfig.toml`, and-`.bun-version` are removed, and the public mirror ships pnpm.--Bun-specific fences retired as part of the cutover:--- `findBunLockMetadataDrift` and the `bun.lock` metadata-drift guard (the pnpm- frozen-lockfile check supersedes it).-- `check:bun-run-fallthrough` (the `bun run` PATH-fallthrough guard) and its- test, along with the `run-bun-if-available.sh` root fan-out wrapper.-- `bun-install-ci.sh`, the retry/idle-timeout install wrapper that existed to- work around a Bun install-hang issue; pnpm's install path replaces it.-- The `run-test-dom.sh` `--isolate` mock-leak mitigation (the per-file- fresh-module-registry workaround for a Bun `mock.module` in-place-patch leak);- the DOM tier is now a dedicated Vitest project with `isolate: true`.--Two small, required behavioral deltas ride along with the swap: `ok diagnose---redact` bundles now derive doc-name redaction tokens with sha256 instead of-BLAKE2b-256 (Node's OpenSSL rejects BLAKE2 `outputLength`), so the `doc:<hex>`-tokens differ while the in-bundle inverse map still resolves them; and the-file-copy API now returns HTTP 409 for `ERR_FS_CP_DIR_TO_NON_DIR` /-`ERR_FS_CP_NON_DIR_TO_DIR` (previously an unhandled 500).diff --git a/.changeset/restore-active-window-on-update.md b/.changeset/restore-active-window-on-update.mddeleted file mode 100644index 1f6668616..000000000--- a/.changeset/restore-active-window-on-update.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": patch------Installing an update no longer lands you in the wrong window. When you relaunch to install the latest version with several project windows open, OpenKnowledge reopens all of them and now brings the window you were last working in back to the front, instead of whichever window happened to finish loading last.diff --git a/.changeset/share-receive-ghost-candidate.md b/.changeset/share-receive-ghost-candidate.mddeleted file mode 100644index 15d6540ee..000000000--- a/.changeset/share-receive-ghost-candidate.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge-desktop": patch------Fix: opening a share link no longer offers to initialize a folder that is no longer a git checkout. If a project was moved or deleted outside OK, its recents entry could still be presented as the share target with a "this branch is checked out in <path>" claim and an "Initialize it and open?" prompt, because the path still existed on disk. Share receive now requires a candidate to be a real git working tree at that exact path, so a stale entry falls through to the launcher's "Clone from GitHub" / "I already have it locally" choices instead. Stale entries also no longer suppress worktree enumeration, so a share whose branch is checked out in a linked worktree now opens that worktree directly rather than prompting to switch branches.diff --git a/.changeset/trailing-hard-break-strip.md b/.changeset/trailing-hard-break-strip.mddeleted file mode 100644index 852236807..000000000--- a/.changeset/trailing-hard-break-strip.md+++ /dev/null@@ -1,7 +0,0 @@-----"@inkeep/open-knowledge": patch------Fix a stray backslash appearing at the end of lines after a hard break--A hard break (Shift+Enter) at the end of a paragraph serialized to a trailing `\` in the markdown source, which users saw as an unexpected character at the end of a line. Worse, deleting it did not stick: the WYSIWYG fragment kept the break node, so the next sync re-emitted the `\` (a fragment/source round-trip that never settled, hidden from the invariant watchdog by parse-equivalence tolerance). A trailing hard break has no CommonMark meaning — a backslash form decays to a literal backslash on the next parse and a two-space form is stripped — so it is now dropped at serialize time. Mid-paragraph hard breaks, source-authored breaks, void `<br>` breaks, and literal backslashes in text are all unaffected and still round-trip byte-for-byte.diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.mdindex dfd6dfefc..f7d5c76f6 100644--- a/docs/CHANGELOG.md+++ b/docs/CHANGELOG.md@@ -1,5 +1,11 @@# @inkeep/open-knowledge-docs+## 0.0.23++### Patch Changes++- @inkeep/[email protected]+## 0.0.22### Patch Changesdiff --git a/docs/package.json b/docs/package.jsonindex 2575e8fce..3f650a63f 100644--- a/docs/package.json+++ b/docs/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge-docs",- "version": "0.0.22",+ "version": "0.0.23","license": "GPL-3.0-or-later","private": true,"packageManager": "[email protected]",diff --git a/packages/app/package.json b/packages/app/package.jsonindex e19c7157e..1a11c6689 100644--- a/packages/app/package.json+++ b/packages/app/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge-app",- "version": "0.33.0",+ "version": "0.34.0","license": "GPL-3.0-or-later","private": true,"type": "module",diff --git a/packages/cli/package.json b/packages/cli/package.jsonindex 2ee587842..ac0ce3aad 100644--- a/packages/cli/package.json+++ b/packages/cli/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge",- "version": "0.33.0",+ "version": "0.34.0","license": "GPL-3.0-or-later","private": false,"type": "module",diff --git a/packages/core/package.json b/packages/core/package.jsonindex a4a4a6859..0cbbd69c3 100644--- a/packages/core/package.json+++ b/packages/core/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge-core",- "version": "0.33.0",+ "version": "0.34.0","license": "GPL-3.0-or-later","private": true,"type": "module",diff --git a/packages/desktop/package.json b/packages/desktop/package.jsonindex 3d7a6534e..a9592b248 100644--- a/packages/desktop/package.json+++ b/packages/desktop/package.json@@ -1,7 +1,7 @@{"name": "@inkeep/open-knowledge-desktop","productName": "OpenKnowledge",- "version": "0.33.0",+ "version": "0.34.0","license": "GPL-3.0-or-later","private": true,"type": "module",diff --git a/packages/server/assets/skills/discovery/SKILL.md b/packages/server/assets/skills/discovery/SKILL.mdindex ba89fcef9..03fb26a84 100644--- a/packages/server/assets/skills/discovery/SKILL.md+++ b/packages/server/assets/skills/discovery/SKILL.md@@ -3,7 +3,7 @@ name: open-knowledge-discoverydescription: "Read when the user asks what OpenKnowledge is, wants to install it on a repository, wants to share an OpenKnowledge project with collaborators, or asks how `ok init` / `ok cowork` / OK Desktop set up a project. Do NOT load to perform OpenKnowledge reads/writes — the runtime guidance for editing markdown inside an initialized OK project ships as a separate project-local skill at `.claude/skills/open-knowledge/` whenever `ok init` runs. If the user appears to be editing markdown inside a `.ok/` project and this is the only OK skill loaded, advise them to re-run `ok init` to install the project-local skill."compatibility: "Any agent host — no MCP server required. Pure discovery + install guidance."metadata:- version: "0.33.0"+ version: "0.34.0"author: "Inkeep"repository: "https://github.com/inkeep/open-knowledge"---diff --git a/packages/server/assets/skills/project/SKILL.md b/packages/server/assets/skills/project/SKILL.mdindex 55e3fe824..ad27eb3f7 100644--- a/packages/server/assets/skills/project/SKILL.md+++ b/packages/server/assets/skills/project/SKILL.md@@ -3,7 +3,7 @@ name: open-knowledgedescription: "Authoritative agent-runtime contract for working inside an OpenKnowledge project — a markdown-CRDT knowledge base exposed over MCP. Use whenever reading, listing, searching, editing, or linting any `.md` or `.mdx` file in the project, and before any `mcp__open-knowledge__*` tool call (`exec`, `search`, `write`, `edit`, `lint`, and the rest). Installed by `ok init`, so its presence means this is an OpenKnowledge project and it governs every markdown file here. Covers the read/write tool surface, grounding and linking rules, folder/template conventions, the live browser preview, and the rule that OK's MCP tools — never native file tools — handle in-scope markdown."compatibility: "Claude Code, Claude Desktop, Claude Cowork, Claude.ai web. Requires OpenKnowledge MCP server + code execution."metadata:- version: "0.33.0"+ version: "0.34.0"author: "Inkeep"repository: "https://github.com/inkeep/open-knowledge"---diff --git a/packages/server/assets/skills/write-skill/SKILL.md b/packages/server/assets/skills/write-skill/SKILL.mdindex a7083e506..3652fd12e 100644--- a/packages/server/assets/skills/write-skill/SKILL.md+++ b/packages/server/assets/skills/write-skill/SKILL.md@@ -3,7 +3,7 @@ name: open-knowledge-write-skilldescription: "Use when the user wants to create, author, write, or design a new Agent Skill (a SKILL.md) — for OpenKnowledge or for their editors — including requests like 'help me write a skill', 'make a skill that…', 'turn this workflow into a skill', or improving an existing skill's triggering and discipline. Also use when capturing reusable agent guidance that should live as an installable skill rather than a one-off prompt. Covers choosing scope (project vs global), the SKILL.md frontmatter contract, progressive-disclosure structure, evaluating the skill, and installing it into the user's editors."compatibility: "OpenKnowledge project recommended (uses the `write` / `edit` / `install` MCP verbs). Authoring + validation are pure file ops; live preview + eval want a running server (`ok start`)."metadata:- version: "0.33.0"+ version: "0.34.0"author: "Inkeep"repository: "https://github.com/inkeep/open-knowledge"---diff --git a/packages/server/package.json b/packages/server/package.jsonindex 46344b893..5973675b0 100644--- a/packages/server/package.json+++ b/packages/server/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge-server",- "version": "0.33.0",+ "version": "0.34.0","license": "GPL-3.0-or-later","private": true,"type": "module",