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.24.0 (#2362)
inkeep-internal-ci[bot]3e8b45de62e3
diff --git a/.changeset/desktop-startup-instrumentation.md b/.changeset/desktop-startup-instrumentation.mddeleted file mode 100644index fcba7d28b..000000000--- a/.changeset/desktop-startup-instrumentation.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": patch------Add always-on desktop startup instrumentation. Every launch now emits one structured `desktop.startup-timeline` log line with bounded per-phase durations (app-ready → bootstrap → server spawn → lock-ready → window → load → shown, plus the server's HTTP-listen / seed-walk / index / ready timings and the renderer's page-list and first-content marks). The server exposes its boot timings on `GET /api/server-info`, and the file-watcher seed walk and index phases are now traced (`ok.boot.seed-walk`, `ok.boot.indexes`). When OpenTelemetry is enabled, the three processes (Electron main, server, renderer) join into a single correlated `ok.app-startup` trace via W3C traceparent propagation. This is instrumentation only; startup behavior and timing are unchanged.diff --git a/.changeset/exec-enriched-reads.md b/.changeset/exec-enriched-reads.mddeleted file mode 100644index d246803eb..000000000--- a/.changeset/exec-enriched-reads.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": patch------`exec` reads now surface more of what OpenKnowledge already tracks, in the human-readable listing an agent reads. `ls` shows a folder's available templates (name, description, scope), its description and tags, and direct-vs-recursive file counts with the most-recent date; `cat` shows the backlink and forward-link source paths (not just counts) and a coarse graph role (hub / connector / leaf / orphan); both render triage frontmatter (`status`, `type`) per file.diff --git a/.changeset/fix-attempted-install-nag.md b/.changeset/fix-attempted-install-nag.mddeleted file mode 100644index 83a6ebd0e..000000000--- a/.changeset/fix-attempted-install-nag.md+++ /dev/null@@ -1,11 +0,0 @@-----"@inkeep/open-knowledge": patch------Stop OK Desktop's "Update to X didn't install" notice from firing spuriously and re-appearing on every launch. The boot-time failed-install detector now handles two cases it previously got wrong:--1. Cross-channel state. The stable and beta builds share one settings file (same app id), so a version that one channel armed as its pending install could poison the other channel's boot check. A beta build would show "Update to 0.23.0 didn't install" for a stable version it can never install (cross-channel updates are blocked), and there was no way for it to clear, so the notice returned on every launch. That stale cross-channel record is now cleared silently.--2. No retry bound. A genuinely stuck install (a persistently-failing installer, a pulled release) re-surfaced the notice on every boot forever. It is now shown at most 3 times per failed update, after which the record is dropped. The 7-day "updates paused" hint remains the backstop.--Genuine same-channel install failures still surface as before, so a real failed update is not hidden.diff --git a/.changeset/fix-download-manually-link.md b/.changeset/fix-download-manually-link.mddeleted file mode 100644index aace8240f..000000000--- a/.changeset/fix-download-manually-link.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": patch------Fix the "Download manually" link in OK Desktop's update notices. When an update fails to install (the "Update to X didn't install" card) or the app detects it hasn't received updates in a while, the manual-download link now points at the GitHub Releases page (https://github.com/inkeep/open-knowledge/releases) where the signed DMGs actually live, instead of a marketing URL that returned a 404.diff --git a/.changeset/init-git-root-promotion-warning.md b/.changeset/init-git-root-promotion-warning.mddeleted file mode 100644index 1e8882405..000000000--- a/.changeset/init-git-root-promotion-warning.md+++ /dev/null@@ -1,29 +0,0 @@-----"@inkeep/open-knowledge": patch------fix(open-knowledge): make `ok init` git-root promotion visible + add `--content-dir`--When `ok init` runs in a sub-folder of a git repo, it scaffolds `.ok/` at the-git root and scopes the whole repo as content (one `.ok/` per git repo). That-promotion previously surfaced only as a single `console.log` line on stdout,-which `ok init 2>&1 | tail` / `| head` silently dropped — so a large repo could-get whole-repo-scoped without the user noticing.--- The promotion is now disclosed as a styled warning on stderr at decision- time, and repeated in the init summary directly next to the "Found N markdown- files" preview, naming the sub-folder and how to narrow scope.-- New `ok init --content-dir <path>` flag scopes content to `<path>` (resolved- relative to the current directory, written to `.ok/config.yml` as- `content.dir`). `--content-dir .` from a promoted sub-folder scopes the- project to that folder. Paths outside the project root, missing paths, or- files are rejected with a clear usage error (exit 64). Supplying the flag- suppresses the whole-repo promotion warning (the scope choice was explicit).-- New `ok init --json` flag prints a machine-readable summary to stdout- (`projectRoot`, `gitRootPromoted`, `promotedFromDir`, `contentDir`,- `contentDirRequested`, `contentDirApplied`, `contentFileCount`, `didGitInit`,- `mcpAction`, `editors[]`) so scripts and agents read the promotion + scope- signals as fields instead of scraping log text. Diagnostics stay on stderr;- stdout carries only the JSON document.--Behavior of the promotion itself is unchanged.diff --git a/.changeset/notion-export-cleanup.md b/.changeset/notion-export-cleanup.mddeleted file mode 100644index 445f1bd3c..000000000--- a/.changeset/notion-export-cleanup.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": minor------Add `ok migrate notion [dir]` to clean up a Notion "Markdown & CSV" export in place. It normalizes internal links so they both render and resolve (decodes `%20`, handles targets with parentheses, and angle-wraps targets containing spaces), converts `<aside>` callouts to `> [!note]`, lifts database row properties into YAML frontmatter, extracts inline base64 images to files, and renders each database CSV as a markdown table (keeping the per-row pages). Dry-run by default; pass `--apply` to write. Every transform is idempotent, and the command refuses non-Notion directories unless `--force`.diff --git a/.changeset/pre.json b/.changeset/pre.jsonindex ae3ee59bb..0c5d73fe1 100644--- a/.changeset/pre.json+++ b/.changeset/pre.json@@ -2,15 +2,15 @@"mode": "pre","tag": "beta","initialVersions": {- "@inkeep/open-knowledge-docs": "0.0.8",- "@inkeep/open-knowledge-app": "0.23.0",- "@inkeep/open-knowledge": "0.23.0",- "@inkeep/open-knowledge-core": "0.23.0",- "@inkeep/open-knowledge-desktop": "0.23.0",- "@inkeep/md-conformance": "0.0.16",+ "@inkeep/open-knowledge-docs": "0.0.9",+ "@inkeep/open-knowledge-app": "0.24.0",+ "@inkeep/open-knowledge": "0.24.0",+ "@inkeep/open-knowledge-core": "0.24.0",+ "@inkeep/open-knowledge-desktop": "0.24.0",+ "@inkeep/md-conformance": "0.0.17","@inkeep/open-knowledge-native-config": "0.0.0","@inkeep/open-knowledge-plugin": "0.3.1",- "@inkeep/open-knowledge-server": "0.23.0"+ "@inkeep/open-knowledge-server": "0.24.0"},"changesets": []}diff --git a/.changeset/subscribe-card.md b/.changeset/subscribe-card.mddeleted file mode 100644index 6255965ae..000000000--- a/.changeset/subscribe-card.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": minor------Invite OK Desktop users to subscribe to product updates from the post-update release-notes card. When the app updates, the "Updated to Version X · Release notes" card in the sidebar footer now also carries a compact "Stay in the loop" subscribe form (reusing the existing form) with a "Follow us on" row for X, GitHub, and Discord — shown only when the user hasn't already subscribed or dismissed it, and for at most three distinct update versions. It never appears on its own (no update, no prompt) and won't re-nag on reopen. Dismissing closes the whole card and stops the prompt for good; subscribing from here or the Resources menu retires it. All state is device-local; web and CLI are unaffected.diff --git a/.changeset/terminal-ask-ai-selection-grounding.md b/.changeset/terminal-ask-ai-selection-grounding.mddeleted file mode 100644index 69a987de2..000000000--- a/.changeset/terminal-ask-ai-selection-grounding.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": patch------The editor's inline **Ask AI** button now sends a grounded prompt to the docked terminal instead of the raw selected text. When you highlight a passage and click Ask AI with a terminal open, the running CLI receives the passage together with a reference to the document it came from (or a pointer to read the full passage via the OpenKnowledge MCP server when the selection is large), so the agent can place it in your knowledge base instead of getting an unattributed blob.diff --git a/.changeset/terminal-chat-controls-followups.md b/.changeset/terminal-chat-controls-followups.mddeleted file mode 100644index 97f47e90a..000000000--- a/.changeset/terminal-chat-controls-followups.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": patch------Refined the docked terminal's chat controls. Show or hide the terminal with an edge "Show terminal" tab that appears right where you closed it — on the right column or under the editor, depending on where it's docked — and the header's separate chat toggle is gone. The terminal's "new tab" control is now a split button: click it to open a new tab in your current CLI, or use the dropdown to switch CLI (your pick sticks, shared with the Ask AI composer) or open a plain "Terminal" tab (which sticks too, just for the terminal). New-chat now respects a CLI you picked but haven't installed instead of silently falling back, terminal tabs show their full title on hover, and opening the chat no longer collapses the document panel.diff --git a/.changeset/terminal-wheel-pointer-position.md b/.changeset/terminal-wheel-pointer-position.mddeleted file mode 100644index 991f1cbd4..000000000--- a/.changeset/terminal-wheel-pointer-position.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": patch------Fix mouse-wheel scrolling in the desktop terminal for TUIs that hit-test mouse coordinates (opencode, bubbletea apps). The terminal's mouse-mode wheel reports were pinned to cell 1;1 — fine for claude/vim/less, which ignore the position, but coordinate-dispatching TUIs route the wheel to the component under the reported cell, and the top-left corner is never the scrollable region, so scrolling silently did nothing. Wheel reports now carry the pointer's actual cell (with a viewport-center fallback when the renderer hasn't measured yet), and SGR-pixels mode reports CSS-px coordinates. This also corrects scroll targeting in window-under-pointer TUIs: vim/neovim splits and tmux panes previously always scrolled the top-left window regardless of where the pointer was; they now scroll the hovered one, matching native terminals.diff --git a/.changeset/worktree-selector.md b/.changeset/worktree-selector.mddeleted file mode 100644index f84503bc6..000000000--- a/.changeset/worktree-selector.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": patch------You can now work on several branches of a project at once, each in its own window. The project switcher in the sidebar footer groups your recent projects by repository: a project with open worktrees expands inline to show them (the current window's project is expanded by default), and typing in the search box matches projects, open worktrees, and the current project's branches. Opening a branch that has no worktree yet creates one on demand. "New worktree" lets you start a fresh branch or check out an existing one, and your worktrees also show up in the Cmd-K command palette. Worktrees are stored inside the project under `.ok/worktrees/` and kept out of git status automatically, so each window stays fully isolated (its own editor and server) without touching your working copy.diff --git a/bun.lock b/bun.lockindex 159850b53..356e243cf 100644--- a/bun.lock+++ b/bun.lock@@ -19,7 +19,7 @@},"docs": {"name": "@inkeep/open-knowledge-docs",- "version": "0.0.8",+ "version": "0.0.9","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.23.0",+ "version": "0.24.0","dependencies": {"@codemirror/autocomplete": "^6.20.1","@codemirror/commands": "^6.10.3",@@ -206,7 +206,7 @@},"packages/cli": {"name": "@inkeep/open-knowledge",- "version": "0.23.0",+ "version": "0.24.0","bin": {"open-knowledge": "dist/cli.mjs","ok": "dist/cli.mjs",@@ -250,7 +250,7 @@},"packages/core": {"name": "@inkeep/open-knowledge-core",- "version": "0.23.0",+ "version": "0.24.0","dependencies": {"@handlewithcare/remark-prosemirror": "0.1.5","@opentelemetry/api": "^1.9.0",@@ -326,7 +326,7 @@},"packages/desktop": {"name": "@inkeep/open-knowledge-desktop",- "version": "0.23.0",+ "version": "0.24.0","dependencies": {"@inkeep/open-knowledge": "workspace:*","@inkeep/open-knowledge-core": "workspace:*",@@ -369,7 +369,7 @@},"packages/server": {"name": "@inkeep/open-knowledge-server",- "version": "0.23.0",+ "version": "0.24.0","dependencies": {"@hocuspocus/server": "4.0.0-rc.1","@inkeep/open-knowledge-core": "workspace:*",diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.mdindex 9f3a740ca..ed8ecf7b3 100644--- a/docs/CHANGELOG.md+++ b/docs/CHANGELOG.md@@ -1,5 +1,11 @@# @inkeep/open-knowledge-docs+## 0.0.9++### Patch Changes++- @inkeep/[email protected]+## 0.0.8### Patch Changesdiff --git a/docs/package.json b/docs/package.jsonindex 1f8caf5c2..afc74f62f 100644--- a/docs/package.json+++ b/docs/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge-docs",- "version": "0.0.8",+ "version": "0.0.9","license": "GPL-3.0-or-later","private": true,"packageManager": "[email protected]",diff --git a/packages/app/package.json b/packages/app/package.jsonindex 5cbea7dc4..180ff4b95 100644--- a/packages/app/package.json+++ b/packages/app/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge-app",- "version": "0.23.0",+ "version": "0.24.0","license": "GPL-3.0-or-later","private": true,"type": "module",diff --git a/packages/cli/package.json b/packages/cli/package.jsonindex df30fb7ff..7dfc92104 100644--- a/packages/cli/package.json+++ b/packages/cli/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge",- "version": "0.23.0",+ "version": "0.24.0","license": "GPL-3.0-or-later","private": false,"type": "module",diff --git a/packages/core/package.json b/packages/core/package.jsonindex 5465845f0..5f45d7db2 100644--- a/packages/core/package.json+++ b/packages/core/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge-core",- "version": "0.23.0",+ "version": "0.24.0","license": "GPL-3.0-or-later","private": true,"type": "module",diff --git a/packages/desktop/package.json b/packages/desktop/package.jsonindex 7b48947d1..b91dc0d6f 100644--- a/packages/desktop/package.json+++ b/packages/desktop/package.json@@ -1,7 +1,7 @@{"name": "@inkeep/open-knowledge-desktop","productName": "OpenKnowledge",- "version": "0.23.0",+ "version": "0.24.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 89b46a7e2..26ca9d82a 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.23.0"+ version: "0.24.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 ebdcce268..2782fa069 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, 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.23.0"+ version: "0.24.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 18364d79f..b5e367c7e 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.23.0"+ version: "0.24.0"author: "Inkeep"repository: "https://github.com/inkeep/open-knowledge"---diff --git a/packages/server/package.json b/packages/server/package.jsonindex 3e9be6614..8b57ac8d3 100644--- a/packages/server/package.json+++ b/packages/server/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge-server",- "version": "0.23.0",+ "version": "0.24.0","license": "GPL-3.0-or-later","private": true,"type": "module",