Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

main reset: post-stable v0.28.0 (#2531)

inkeep-internal-ci[bot]a08aaf22bcf9
diff --git a/.changeset/ask-ai-composer-click-to-focus.md b/.changeset/ask-ai-composer-click-to-focus.md
deleted file mode 100644
index cc1f118dc..000000000
--- a/.changeset/ask-ai-composer-click-to-focus.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Clicking anywhere in an Ask AI composer now focuses its input. Previously only the text itself was a focus target, so the padding around the field, the gaps beside the send button, and the empty space in the card were dead — a click there did nothing. Both composers get the standard chat-composer behavior: the bottom docked composer (open-doc and folder-overview modes) and the empty-state "Create with AI" composer. Keyboard and screen-reader users are unaffected — the input keeps its own semantics and is still reached directly via Tab and ⌘L.
diff --git a/.changeset/consolidate-git-path-parsing.md b/.changeset/consolidate-git-path-parsing.md
deleted file mode 100644
index 0a288a5fc..000000000
--- a/.changeset/consolidate-git-path-parsing.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Fix git rename detection for non-ASCII filenames in two more places. A shared doc or folder whose name contains non-ASCII characters (umlauts, accents, CJK) that is renamed on the remote now reports its correct new location instead of showing as deleted, and version-timeline entries recover the real document name instead of garbled text. All git path-listing now routes through a single NUL-safe helper (`git-paths.ts`) so this class of bug cannot recur at new call sites.
diff --git a/.changeset/deinit-projection-symlinks.md b/.changeset/deinit-projection-symlinks.md
deleted file mode 100644
index 783d4aa40..000000000
--- a/.changeset/deinit-projection-symlinks.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-`ok deinit` (and the per-project sweep in `ok uninstall`) now removes OK-installed skill projection symlinks (pack and authored skills under `.claude/skills/`, `.cursor/skills/`, etc.) instead of refusing them with "Refusing to write through a symbolic link" — removal unlinks the link itself and never touches its target. Dangling projection symlinks are cleaned up too; the refusal for symlinked ancestors that escape the project is unchanged.
diff --git a/.changeset/desktop-self-uninstall.md b/.changeset/desktop-self-uninstall.md
deleted file mode 100644
index 6add38f51..000000000
--- a/.changeset/desktop-self-uninstall.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge-desktop": patch
----
-
-Add a packaged macOS menu flow to uninstall OpenKnowledge, with a per-project picker for optionally deinitializing recent/open/running projects before removing the global footprint. After cleanup — including when cleanup reports failures, in which case the error dialog embeds the cleanup log inline — a final dialog walks the user through the one remaining manual step, then reveals OpenKnowledge.app in Finder so it can be dragged to the Trash and quits.
diff --git a/.changeset/jsx-interior-edit-freshness.md b/.changeset/jsx-interior-edit-freshness.md
deleted file mode 100644
index 20e69bd10..000000000
--- a/.changeset/jsx-interior-edit-freshness.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Editing inside a Callout, tab, accordion, or table cell in the visual editor now always reaches collaborators and reopens with exactly the content you see. Previously the editor could hold a cached copy of a component's original source and, when the inside was edited, serialize those stale bytes for everyone else — your own editor looked right while a teammate (or a fresh reopen) got the pre-edit content, or in rare cases structurally-broken markdown. The server now re-derives a component's markdown whenever its live contents diverge from that cached source, regardless of which surface made the edit, so what you see is what everyone gets. A drain-time legality check backs this up: if a serialization would still lose content, it is caught at the moment the bytes are written and a recoverable snapshot is kept instead of shipping the corruption.
diff --git a/.changeset/link-authoring-ux.md b/.changeset/link-authoring-ux.md
deleted file mode 100644
index b94cd1306..000000000
--- a/.changeset/link-authoring-ux.md
+++ /dev/null
@@ -1,19 +0,0 @@
----
-"@inkeep/open-knowledge": minor
----
-
-Link authoring in the visual editor now matches the conventions of the editors
-you already know. Typing a full URL (`https://…`, `www.…`, or an email) and
-pressing space or enter converts it to a link — including local-development
-URLs like `http://localhost:5174` — while plain words and filenames like
-`AGENTS.md` are never touched, and one undo restores plain text. Pasting or
-dropping a lone URL links it; pasting a URL over selected text links that text
-instead; `Cmd+Shift+V` still pastes plain. Typing markdown's `[text](url)`
-shorthand converts on the closing parenthesis. `Cmd+K` is now dual-role: with
-text selected it opens the link popover (focused, pre-filled from your
-clipboard when it holds a URL), with the cursor inside a link it opens that
-link for editing, and everywhere else it keeps opening the command palette.
-Linkification never fires on content written by other collaborators or agents
-— only on your own local typing and paste gestures. Also fixes two
-long-standing popover bugs: the URL input now reliably takes focus on open,
-and Escape correctly closes the popover after dismissing path suggestions.
diff --git a/.changeset/ok-exec-windows-subpath-reads.md b/.changeset/ok-exec-windows-subpath-reads.md
deleted file mode 100644
index 7e146b433..000000000
--- a/.changeset/ok-exec-windows-subpath-reads.md
+++ /dev/null
@@ -1,11 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Fix the `exec` MCP tool being unable to read any file below the project root on
-Windows. `cat`, `ls`, `grep`, and `find` against a subpath (e.g. `cat notes/x.md`)
-returned "No such file or directory" even though the file existed, because the
-bundled `just-bash` sandbox judged every backslash-separated Windows path as
-"outside sandbox". Bumping `just-bash` to the release that handles Windows path
-separators restores subpath reads/listings; only genuinely-absent files now
-report ENOENT. macOS and Linux are unaffected.
diff --git a/.changeset/pre.json b/.changeset/pre.json
index 5f251122b..3d0fcb99d 100644
--- a/.changeset/pre.json
+++ b/.changeset/pre.json
@@ -2,15 +2,15 @@
"mode": "pre",
"tag": "beta",
"initialVersions": {
- "@inkeep/open-knowledge-docs": "0.0.12",
- "@inkeep/open-knowledge-app": "0.27.0",
- "@inkeep/open-knowledge": "0.27.0",
- "@inkeep/open-knowledge-core": "0.27.0",
- "@inkeep/open-knowledge-desktop": "0.27.0",
- "@inkeep/md-conformance": "0.0.20",
+ "@inkeep/open-knowledge-docs": "0.0.13",
+ "@inkeep/open-knowledge-app": "0.28.0",
+ "@inkeep/open-knowledge": "0.28.0",
+ "@inkeep/open-knowledge-core": "0.28.0",
+ "@inkeep/open-knowledge-desktop": "0.28.0",
+ "@inkeep/md-conformance": "0.0.21",
"@inkeep/open-knowledge-native-config": "0.0.0",
"@inkeep/open-knowledge-plugin": "0.3.1",
- "@inkeep/open-knowledge-server": "0.27.0"
+ "@inkeep/open-knowledge-server": "0.28.0"
},
"changesets": []
}
diff --git a/.changeset/prevent-staging-symlink-deletion.md b/.changeset/prevent-staging-symlink-deletion.md
deleted file mode 100644
index fae3d5ca9..000000000
--- a/.changeset/prevent-staging-symlink-deletion.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Fixed symbolic links (mode `120000`) being automatically staged as deleted in the background Git sync loop. The filesystem scanner now correctly walks and includes symbolic links inside the content directory so they are recognized as on-disk files and are not incorrectly removed from Git tracking during sync commits.
diff --git a/.changeset/settings-project-ai-tools-section.md b/.changeset/settings-project-ai-tools-section.md
deleted file mode 100644
index de296291b..000000000
--- a/.changeset/settings-project-ai-tools-section.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-"@inkeep/open-knowledge": minor
----
-
-Settings → This project gains an "AI tools" section — the project-scoped sibling of the "AI tools & CLI" section. It manages OpenKnowledge's project-local footprint for the project the window has open: the per-editor project MCP config files (`.mcp.json` for Claude Code, `.cursor/mcp.json` for Cursor, `.codex/config.toml` for Codex, and the OpenCode/Pi equivalents) and the project runtime skill (`.claude/skills/open-knowledge/`). Every row reflects its live installed state and a click installs or uninstalls that one component; removal follows the same guest discipline as install (only entries OpenKnowledge recognizably wrote are deleted). Because a written project config is not always a connected one, each installed row states its remaining step — Claude Code needs a one-time approval, Cursor must be enabled in its own settings, Codex auto-connects on a trusted project. Editors with no project surface (Claude Desktop) are omitted. Mutations resolve and serialize against the sender window's project in the desktop main process.
-
-This also fixes a related leak in the existing "AI tools & CLI" (user-global) section: project-only editors such as Pi have no user-global MCP config, so they surfaced there as a permanently-unmanageable row. The global section now lists only `scope: 'global'` editors; Pi is managed in the new project section instead.
diff --git a/.changeset/terminal-tab-manual-rename.md b/.changeset/terminal-tab-manual-rename.md
deleted file mode 100644
index 287a26e48..000000000
--- a/.changeset/terminal-tab-manual-rename.md
+++ /dev/null
@@ -1,11 +0,0 @@
----
-"@inkeep/open-knowledge": minor
----
-
-Add manual rename to terminal tabs. Double-click a terminal tab (or press F2
-while it's focused) to give it a name of your own, edited inline. The custom
-name pins over whatever title the running program sets via its terminal title
-escape sequence — useful for agent CLIs that constantly rewrite their title — so
-the tab keeps the name you chose. Press Enter or click away to commit, Escape to
-cancel; committing an empty name clears the custom label and restores the
-program's title (or the positional "Terminal N" default).
diff --git a/.changeset/terminal-tab-reorder.md b/.changeset/terminal-tab-reorder.md
deleted file mode 100644
index 53238eb98..000000000
--- a/.changeset/terminal-tab-reorder.md
+++ /dev/null
@@ -1,14 +0,0 @@
----
-"@inkeep/open-knowledge": minor
----
-
-Reorder terminal tabs. Drag a terminal tab to a new position with the pointer, or
-move the active tab with ⌘⇧← / ⌘⇧→ (keyboard reorders are announced to screen
-readers). Untitled tabs now carry a sticky number that stays with the session, so
-reordering them is visibly meaningful instead of silently renumbering, and ⌘1–9
-still jumps to the tab at that visual position. The drag reuses the editor's tab
-chrome, and in the standalone terminal window a drag across the tab strip reorders
-tabs instead of moving the window. Your custom names and tab order are retained by
-the main process, so a renderer reload (View → Reload) restores both names and
-order; a full app quit still starts fresh, since the shells themselves don't
-survive a restart.
diff --git a/.changeset/windows-hide-git-subprocesses.md b/.changeset/windows-hide-git-subprocesses.md
deleted file mode 100644
index e0a662a9b..000000000
--- a/.changeset/windows-hide-git-subprocesses.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Hide server-launched Git and helper subprocess console windows on Windows by setting hidden console spawn options on direct child-process calls.
diff --git a/.changeset/windows-launch-json-ui-chain.md b/.changeset/windows-launch-json-ui-chain.md
deleted file mode 100644
index 4bdd201ba..000000000
--- a/.changeset/windows-launch-json-ui-chain.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-'@inkeep/open-knowledge': patch
----
-
-Make the `open-knowledge-ui` entry in `.claude/launch.json` launchable on Windows. Previously `ok init` always wrote a `/bin/sh` chain, so Claude Code Desktop's preview pane could not start the OpenKnowledge UI on Windows (there is no `/bin/sh`). On Windows, `ok init` now scaffolds a `powershell -NoProfile -NonInteractive -Command <chain>` entry that resolves the npm-global `ok.cmd` shim first, then `npx.cmd`, then common version-manager/installer paths, and runs `ok start --ui-port` so the opened folder gets its own collab server. The `ok start` launch.json repair sweep now recognizes both platforms' canonical shapes on every OS, so a `launch.json` committed on one platform is never rewritten back and forth by the other, and custom entries are still preserved.
diff --git a/.changeset/worktree-list-live-refresh.md b/.changeset/worktree-list-live-refresh.md
deleted file mode 100644
index b07b034ff..000000000
--- a/.changeset/worktree-list-live-refresh.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Fixed the project switcher's worktree list not refreshing until an app restart. A worktree created outside the current window — a `git worktree add` in a terminal, or a create in another OpenKnowledge window — now appears when the window regains focus, instead of staying hidden until you quit and reopen. The cached worktree model now revalidates on window focus / tab-visible, the same signal the file list and graph already use to recover from stale data.
diff --git a/bun.lock b/bun.lock
index 2b871a979..fb46823a7 100644
--- a/bun.lock
+++ b/bun.lock
@@ -19,7 +19,7 @@
},
"docs": {
"name": "@inkeep/open-knowledge-docs",
- "version": "0.0.12",
+ "version": "0.0.13",
"dependencies": {
"@hookform/resolvers": "^5.4.0",
"@inkeep/cxkit-react": "^0.5.117",
@@ -62,7 +62,7 @@
},
"packages/app": {
"name": "@inkeep/open-knowledge-app",
- "version": "0.27.0",
+ "version": "0.28.0",
"dependencies": {
"@codemirror/autocomplete": "^6.20.1",
"@codemirror/commands": "^6.10.3",
@@ -209,7 +209,7 @@
},
"packages/cli": {
"name": "@inkeep/open-knowledge",
- "version": "0.27.0",
+ "version": "0.28.0",
"bin": {
"open-knowledge": "dist/cli.mjs",
"ok": "dist/cli.mjs",
@@ -253,7 +253,7 @@
},
"packages/core": {
"name": "@inkeep/open-knowledge-core",
- "version": "0.27.0",
+ "version": "0.28.0",
"dependencies": {
"@handlewithcare/remark-prosemirror": "0.1.5",
"@opentelemetry/api": "^1.9.0",
@@ -329,7 +329,7 @@
},
"packages/desktop": {
"name": "@inkeep/open-knowledge-desktop",
- "version": "0.27.0",
+ "version": "0.28.0",
"dependencies": {
"@inkeep/open-knowledge": "workspace:*",
"@inkeep/open-knowledge-core": "workspace:*",
@@ -374,7 +374,7 @@
},
"packages/server": {
"name": "@inkeep/open-knowledge-server",
- "version": "0.27.0",
+ "version": "0.28.0",
"dependencies": {
"@hocuspocus/server": "4.0.0-rc.1",
"@inkeep/open-knowledge-core": "workspace:*",
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 5d38d73d6..8152a64b1 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -1,5 +1,11 @@
# @inkeep/open-knowledge-docs
+## 0.0.13
+
+### Patch Changes
+
+
## 0.0.12
### Patch Changes
diff --git a/docs/package.json b/docs/package.json
index 93055fbb6..b019e6d71 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -1,6 +1,6 @@
{
"name": "@inkeep/open-knowledge-docs",
- "version": "0.0.12",
+ "version": "0.0.13",
"license": "GPL-3.0-or-later",
"private": true,
"packageManager": "[email protected]",
diff --git a/packages/app/package.json b/packages/app/package.json
index 69510af9c..0bff7b104 100644
--- a/packages/app/package.json
+++ b/packages/app/package.json
@@ -1,6 +1,6 @@
{
"name": "@inkeep/open-knowledge-app",
- "version": "0.27.0",
+ "version": "0.28.0",
"license": "GPL-3.0-or-later",
"private": true,
"type": "module",
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 5aeb0627b..02422620a 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
{
"name": "@inkeep/open-knowledge",
- "version": "0.27.0",
+ "version": "0.28.0",
"license": "GPL-3.0-or-later",
"private": false,
"type": "module",
diff --git a/packages/core/package.json b/packages/core/package.json
index 33a521ac0..d21c9731a 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
{
"name": "@inkeep/open-knowledge-core",
- "version": "0.27.0",
+ "version": "0.28.0",
"license": "GPL-3.0-or-later",
"private": true,
"type": "module",
diff --git a/packages/desktop/package.json b/packages/desktop/package.json
index 1e81c00d0..425fc4194 100644
--- a/packages/desktop/package.json
+++ b/packages/desktop/package.json
@@ -1,7 +1,7 @@
{
"name": "@inkeep/open-knowledge-desktop",
"productName": "OpenKnowledge",
- "version": "0.27.0",
+ "version": "0.28.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.md
index da9e1aa3b..698fb3113 100644
--- a/packages/server/assets/skills/discovery/SKILL.md
+++ b/packages/server/assets/skills/discovery/SKILL.md
@@ -3,7 +3,7 @@ name: open-knowledge-discovery
description: "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.27.0"
+ version: "0.28.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.md
index 060b55bea..33f2c4906 100644
--- a/packages/server/assets/skills/project/SKILL.md
+++ b/packages/server/assets/skills/project/SKILL.md
@@ -3,7 +3,7 @@ name: open-knowledge
description: "Authoritative agent-runtime contract for working inside an OpenKnowledge project — a markdown-CRDT knowledge base exposed over MCP. Use whenever reading, listing, searching, or editing any `.md` or `.mdx` file in the project, and before any `mcp__open-knowledge__*` tool call (`exec`, `search`, `write`, `edit`, 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.27.0"
+ version: "0.28.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.md
index 58bc8f986..411e3afdd 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-skill
description: "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.27.0"
+ version: "0.28.0"
author: "Inkeep"
repository: "https://github.com/inkeep/open-knowledge"
---
diff --git a/packages/server/package.json b/packages/server/package.json
index 9be57d887..e6e19b69d 100644
--- a/packages/server/package.json
+++ b/packages/server/package.json
@@ -1,6 +1,6 @@
{
"name": "@inkeep/open-knowledge-server",
- "version": "0.27.0",
+ "version": "0.28.0",
"license": "GPL-3.0-or-later",
"private": true,
"type": "module",