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.56.0 (#3555)
inkeep-internal-ci[bot]92cbf70941f9
diff --git a/.changeset/chubby-symbols-build.md b/.changeset/chubby-symbols-build.mddeleted file mode 100644index 6e86c57b8..000000000--- a/.changeset/chubby-symbols-build.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": patch------The Karpathy LLM Wiki starter pack now composes cleanly with the Open Knowledge Format plugin. New research uses OKF `draft` status and object-shaped source provenance, consolidated articles use `stable`, superseded research becomes `deprecated`, and ingested source wrappers declare their type. Existing projects keep working: the updated skills still understand the older `provisional`, `canonical`, and string-source forms, and all published skill IDs remain unchanged for skills.sh updates.diff --git a/.changeset/cold-single-file-launch.md b/.changeset/cold-single-file-launch.mddeleted file mode 100644index 018e0c9cc..000000000--- a/.changeset/cold-single-file-launch.md+++ /dev/null@@ -1,7 +0,0 @@-----"@inkeep/open-knowledge": patch------Opening a standalone Markdown file or a share link while OpenKnowledge is fully closed no longer reopens your previous session's project windows alongside it. The cold launch now opens only the window the link resolves to, and does not start the servers for unrelated projects.--Those previous windows are not held back for a later launch either. The saved session is cleared on the launch that suppresses it, so your next ordinary launch opens your most recent project and the rest stay reachable from File → Recent project (loose files from File → Recent files). Launching from the Dock or the app icon still restores your full window set exactly as before.diff --git a/.changeset/comments-open-in-panel.md b/.changeset/comments-open-in-panel.mddeleted file mode 100644index ba586a740..000000000--- a/.changeset/comments-open-in-panel.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": patch------Clicking a commented passage, its margin icon, or a commented property value now shows that comment in the Comments panel on the right instead of floating a card over the document. The card used to be pinned to the text it was about, so it covered the paragraphs around the passage — the ones you need in order to judge the comment — and printed the comment twice, since the panel was showing it as well. The Comments tab now opens, scrolls to the comment, and highlights it, with the passage still marked in the document. Comments are also reachable in single-file (`ok <file>`) sessions, which previously offered no Comments tab at all.diff --git a/.changeset/create-project-pack-configurator.md b/.changeset/create-project-pack-configurator.mddeleted file mode 100644index c158697b5..000000000--- a/.changeset/create-project-pack-configurator.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": minor------Picking a starter pack while creating a new project now works the same way it does inside an open project. The create-project dialog shows the pack's full description, a live list of exactly which folders, files, and skills it will add, and a choice of where they go — the project root, or a subfolder you name. Before, the same pick gave you a one-line summary and no preview, and it quietly put a pack's contents in that pack's own default subfolder (so a knowledge base landed in `brain/` rather than at the top level of your new project). The project root is now the default in both places, and you can switch packs from inside the dialog instead of cancelling out to start over.diff --git a/.changeset/external-apps-agent-picker.md b/.changeset/external-apps-agent-picker.mddeleted file mode 100644index ef0a972db..000000000--- a/.changeset/external-apps-agent-picker.md+++ /dev/null@@ -1,7 +0,0 @@-----"@inkeep/open-knowledge": patch------Desktop apps you already have installed now show up in the agent pickers automatically. Claude, Codex, and Cursor were previously hidden until you opted each one in under Settings → Configure agents; OpenKnowledge now detects them per platform (LaunchServices on macOS, the registered protocol handler on Windows, `xdg-mime` on Linux) and lists them without any setup. The Settings toggles still win in both directions — turn one off to hide it, or turn on an app you haven't installed yet to get its download page.--The section is now called "External apps" and each row reads "Claude Desktop" / "ChatGPT Desktop" / "Cursor Desktop" (the Codex desktop app is branded ChatGPT since OpenAI folded the two together), so it is no longer confusable with the same-named Terminal CLI row above it. When an external app is the selected target, the composer's button says "Open Claude Desktop" with an external-action arrow, since that click leaves OpenKnowledge; in-app agents and terminal CLIs now consistently read "Ask <name>".diff --git a/.changeset/generated-index-writer-identity.md b/.changeset/generated-index-writer-identity.mddeleted file mode 100644index 28265b1a9..000000000--- a/.changeset/generated-index-writer-identity.md+++ /dev/null@@ -1,21 +0,0 @@-----'@inkeep/open-knowledge-core': patch-'@inkeep/open-knowledge-server': patch------Attribute the generated `index.md` to OK, not to you--Rebuilds of the generated root index now commit under a dedicated `ok-generator`-writer, so history names what actually wrote the file, and the timeline shows it-as OK rather than as a person.--Previously the generator recorded no contributor at all. The bytes still reached-the shadow repo — every commit's tree is a sweep of the whole content directory —-but they landed under whichever writer drained next: your own principal when you-had the index open, `openknowledge-service` when you did not. The result was a-commit reading `wip: index` authored by you, for lines you never typed, on a file-OK overwrites on the next rebuild.--`ok-generator` is a classified writer, so its history is never garbage-collected-and `git log refs/wip/<branch>/ok-generator` is exactly the generator's own-record.diff --git a/.changeset/okf-lint-plugin-with-per-rule-toggles.md b/.changeset/okf-lint-plugin-with-per-rule-toggles.mddeleted file mode 100644index 4c2ca411e..000000000--- a/.changeset/okf-lint-plugin-with-per-rule-toggles.md+++ /dev/null@@ -1,17 +0,0 @@-----"@inkeep/open-knowledge": patch------A new lint plugin, OKF, checks your documents for things an external reader of the Open Knowledge Format would get wrong. It is off by default, every finding is an advisory warning, and nothing it reports ever blocks a write.--Eleven rules in three groups. **Document structure** is four. `no-wiki-links` catches `[[Page]]` syntax: a perfectly good way to link here, flagged only because a reader outside this app renders the brackets literally and loses the connection. The other three concern the two reserved filenames. In a `log`, every entry heading leading with an ISO `YYYY-MM-DD` date, newest first — a trailing summary after the date is fine, and a log with no entries yet is not a violation. In an `index`, entries sit under a section heading and each carries a link, since an entry with nothing to follow is not navigation. And a reserved file spelled `Index.md` is flagged: OKF only recognizes the lowercase name, so on a case-sensitive filesystem that file quietly stops being your index.--**Frontmatter** is six, one per family of the OKF field contract: the required `type`, the recommended keys, the provenance and trust families, the attested-computation fields, the rule that index documents carry no frontmatter, and the shape of `okf_version` on your root index. These need no setup — you do not have to turn on the frontmatter plugin, or author a schema, or map one to a folder. Enabling OKF is the whole action.--**Project** is one: any `.mdx` file, which the format has no concept of — a reader scanning for `.md` never opens it. That one needs to compare files, so it appears when you run a project audit rather than while you type.--All eleven are deliberately narrow. They enforce the four fields OKF actually marks as required and nothing beyond them, so a concept carrying only a `type` is fully conformant, an unverified document is a normal document, and a field you left out is never an error. Prose around your lists is fine, the heading level is yours to pick, the separator between a link and its description is yours, and so is how many titles a log carries and whether its entries are bullets or paragraphs. Log frontmatter is not checked at all — OKF constrains a log's dated entries, never its frontmatter.--Each rule has its own switch in Settings, so you can keep the structural checks while silencing one you disagree with. The schemas behind the frontmatter rules are written to `.ok/okf/` when you enable the plugin — generated and gitignored — so you and your agents can read the contract rather than infer it from warnings. The directory tracks the switches: turning a rule off removes its schema file, and disabling the plugin removes them all. Your config records only what you turned off, so a rule added later is live without you touching anything. Agents see which parts of the contract govern a document when they read it, and `status` becomes a dropdown in the property panel.--Two numbers worth knowing before you turn it on, both measured against this repository's own 6,117 markdown files — a knowledge base that was never written to the format. The structure rules produce 4,148 findings over 230 documents, almost all of them wiki-links, with one outlier at 2,816 which is, fittingly, the spec about wiki-links. The frontmatter rules produce 12,706 over 5,979 documents, because almost nothing here declares a `type` and because this repository already uses `sources` for its own purpose — a list of file paths, where OKF expects a list of entries. That second one is the case the per-rule switches exist for: a project with its own meaning for an OKF key turns that one family off and keeps the rest.diff --git a/.changeset/okf-recommended-skill-install.md b/.changeset/okf-recommended-skill-install.mddeleted file mode 100644index d5de3501f..000000000--- a/.changeset/okf-recommended-skill-install.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": minor------The OKF plugin now recommends its companion agent skill directly in Settings. You can review what the skill changes, install it explicitly into the current project, and open it afterward to edit its guidance or agent availability. Installation never overwrites a same-name project skill, and disabling OKF does not remove the skill.diff --git a/.changeset/per-directory-generated-indexes.md b/.changeset/per-directory-generated-indexes.mddeleted file mode 100644index 1e8b0b3fe..000000000--- a/.changeset/per-directory-generated-indexes.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": patch------Open Knowledge Format projects can now opt into a generated `index.md` in every Markdown-bearing directory. Each index lists that folder's documents and immediate child indexes, rebuilds in the background after changes, avoids rewriting identical files, preserves unowned orphan indexes, and pauses safely during live conflicts.diff --git a/.changeset/pop-out-note-window.md b/.changeset/pop-out-note-window.mddeleted file mode 100644index 7277bf86b..000000000--- a/.changeset/pop-out-note-window.md+++ /dev/null@@ -1,11 +0,0 @@-----"@inkeep/open-knowledge": minor------Open a document in its own window (desktop). Right-click a document tab and choose "Open in New Window", run it from the command palette, or pick it from the Window menu to pop the current document out into a dedicated window you can park on another monitor.--- Edits sync live between the pop-out and the main window through the project's existing collaboration server, with no extra setup.-- Opening the same document again focuses the window you already have rather than stacking duplicates. Any number of pop-outs can coexist across and within projects.-- Following a wiki link navigates the pop-out in place and updates its title.-- A pop-out closes with its project's main window. If its document is deleted, it shows an explicit "document deleted" state with a close button rather than closing out from under you.-- Your pop-out layout comes back on relaunch, each window reattached to its project and restored to its own position.diff --git a/.changeset/pre.json b/.changeset/pre.jsonindex aaa0227bd..7b54602a5 100644--- a/.changeset/pre.json+++ b/.changeset/pre.json@@ -2,15 +2,15 @@"mode": "pre","tag": "beta","initialVersions": {- "@inkeep/open-knowledge-docs": "0.0.114",- "@inkeep/open-knowledge-app": "0.55.2",- "@inkeep/open-knowledge": "0.55.2",- "@inkeep/open-knowledge-core": "0.55.2",- "@inkeep/open-knowledge-desktop": "0.55.2",- "@inkeep/md-conformance": "0.0.122",+ "@inkeep/open-knowledge-docs": "0.0.115",+ "@inkeep/open-knowledge-app": "0.56.0",+ "@inkeep/open-knowledge": "0.56.0",+ "@inkeep/open-knowledge-core": "0.56.0",+ "@inkeep/open-knowledge-desktop": "0.56.0",+ "@inkeep/md-conformance": "0.0.123","@inkeep/open-knowledge-native-config": "0.0.0","@inkeep/open-knowledge-plugin": "0.3.1",- "@inkeep/open-knowledge-server": "0.55.2"+ "@inkeep/open-knowledge-server": "0.56.0"},"changesets": []}diff --git a/.changeset/server-bind-per-machine.md b/.changeset/server-bind-per-machine.mddeleted file mode 100644index b7c20cc03..000000000--- a/.changeset/server-bind-per-machine.md+++ /dev/null@@ -1,11 +0,0 @@-----"@inkeep/open-knowledge": patch------`server.bind` is now a per-machine setting, so a committed bind can no longer break local runs for people who clone a shared project.--Before this change, a project that committed `server.bind: 0.0.0.0` (or `::`) to `.ok/config.yml` so one machine could serve it remotely made `ok start` fail for every teammate who cloned the repo and ran it locally. The exposure interlock refused to boot because a non-loopback bind requires per-machine `server.allowExternal` consent, and consent is never committed.--`server.bind` moves from `project` scope to `project-local`, the same posture as `server.allowExternal`. A bind committed to the shared `.ok/config.yml` is now ignored, and named at startup with the fix, so local clones always bind loopback and boot. The machine that actually exposes the server sets the bind per-machine with `OK_BIND`, `ok start --bind <address>`, or `.ok/local/config.yml`.--The exposure gate is unchanged: an explicit `OK_BIND` or `--bind` to a non-loopback address without consent still refuses to start.diff --git a/.changeset/server-lock-port-sentinel.md b/.changeset/server-lock-port-sentinel.mddeleted file mode 100644index 099ba1bc9..000000000--- a/.changeset/server-lock-port-sentinel.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": patch------Documents no longer open to "Connection dropped" after an update relaunch in projects that pin a server port. The server writes its lock file before it starts listening, and the port field in that lock is how everything else — the desktop app, the CLI's sync, audit and embeddings commands — decides the server is reachable. A project that set `server.port` had its configured port written into the lock immediately, so the desktop opened document windows against a port nothing was listening on yet and the editor gave up with a "Connection dropped" error you had to dismiss with Try again. Projects on an automatically assigned port were unaffected, which is why this looked intermittent. The lock now reports port 0 until the server is actually accepting connections, so windows open only once the server can serve them.diff --git a/.changeset/starter-packs-require-plugins.md b/.changeset/starter-packs-require-plugins.mddeleted file mode 100644index 0b5102bd1..000000000--- a/.changeset/starter-packs-require-plugins.md+++ /dev/null@@ -1,11 +0,0 @@-----"@inkeep/open-knowledge": patch------Starter packs can now require a plugin, and seeding one turns it on.--The Open Knowledge Format pack is the first to use this. It now scaffolds a minimal OKF v0.2 bundle: a root `index.md`, one populated `concepts/` folder, one typed guide, and one draft Concept template. It also installs the v0.2 companion skill. The pack leaves optional taxonomies and `log.md` out until the project needs them. Seeding enables the OKF plugin too, which turns "conformant when you made it" into "conformance you can see slipping".--The initialize dialog says so before it happens. A required plugin appears in the plan preview alongside the folders and files it will create, named the way it appears in Settings, with a note that you can turn it off any time. `ok seed` prints the same thing after applying. This matters most in one specific case: if you had previously switched the plugin off and then seed a pack that requires it, it comes back on — and you should not have to go hunting through Settings to work out why. Turning it back off afterward is a single toggle, and nothing re-enables it later.--Your existing configuration is left alone. Enabling a plugin sets one key; other plugins, their settings, and any comments in your `config.yml` survive untouched. Re-seeding a project whose required plugins are already on writes nothing at all.diff --git a/.changeset/win-msix-detect-fallback.md b/.changeset/win-msix-detect-fallback.mddeleted file mode 100644index 453cf6382..000000000--- a/.changeset/win-msix-detect-fallback.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": patch------OpenKnowledge Desktop on Windows now detects MSIX-installed agent apps — including Claude's current Windows distribution and the ChatGPT (Codex) Store app. MSIX packages register their `claude://` / `codex://` link handler at install time but in a way Electron's protocol query can't see (it looks for a classic executable association, which MSIX never writes), so the "External apps" picker wrongly treated those apps as not installed even though the browser-mode picker on the same machine saw them. The desktop app now falls back to the same registry check the server uses, so both hosts agree.diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.mdindex 0da3ca1a9..974a5a88d 100644--- a/docs/CHANGELOG.md+++ b/docs/CHANGELOG.md@@ -1,5 +1,12 @@# @inkeep/open-knowledge-docs+## 0.0.115++### Patch Changes++- Updated dependencies [3bc2490]+ - @inkeep/[email protected]+## 0.0.114### Patch Changesdiff --git a/docs/package.json b/docs/package.jsonindex 11768969a..06a96f592 100644--- a/docs/package.json+++ b/docs/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge-docs",- "version": "0.0.114",+ "version": "0.0.115","license": "GPL-3.0-or-later","private": true,"packageManager": "[email protected]",diff --git a/packages/app/package.json b/packages/app/package.jsonindex f8987621a..940270f1c 100644--- a/packages/app/package.json+++ b/packages/app/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge-app",- "version": "0.55.2",+ "version": "0.56.0","license": "GPL-3.0-or-later","private": true,"type": "module",diff --git a/packages/cli/package.json b/packages/cli/package.jsonindex 20467a785..461f30672 100644--- a/packages/cli/package.json+++ b/packages/cli/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge",- "version": "0.55.2",+ "version": "0.56.0","license": "GPL-3.0-or-later","private": false,"type": "module",diff --git a/packages/core/package.json b/packages/core/package.jsonindex b6452486c..eb5313fc3 100644--- a/packages/core/package.json+++ b/packages/core/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge-core",- "version": "0.55.2",+ "version": "0.56.0","license": "GPL-3.0-or-later","private": true,"type": "module",diff --git a/packages/desktop/package.json b/packages/desktop/package.jsonindex f7176209c..52c5d9998 100644--- a/packages/desktop/package.json+++ b/packages/desktop/package.json@@ -1,7 +1,7 @@{"name": "@inkeep/open-knowledge-desktop","productName": "OpenKnowledge",- "version": "0.55.2",+ "version": "0.56.0","license": "GPL-3.0-or-later","homepage": "https://openknowledge.ai","author": {diff --git a/packages/server/package.json b/packages/server/package.jsonindex 6e53132d6..629da661b 100644--- a/packages/server/package.json+++ b/packages/server/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge-server",- "version": "0.55.2",+ "version": "0.56.0","license": "GPL-3.0-or-later","private": true,"type": "module",