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.29.0 (#2587)
inkeep-internal-ci[bot]a46305b9eeb0
diff --git a/.changeset/antigravity-integration.md b/.changeset/antigravity-integration.mddeleted file mode 100644index 85ba407e5..000000000--- a/.changeset/antigravity-integration.md+++ /dev/null@@ -1,7 +0,0 @@-----"@inkeep/open-knowledge": minor------First-class support for Google Antigravity — the agentic IDE and the `agy` terminal agent (the Gemini CLI's successor). `ok init` now registers the OpenKnowledge MCP server for Antigravity, writing the standard `mcpServers` entry (the same resilient launcher every other editor gets) into Antigravity's single user-global config at `~/.gemini/config/mcp_config.json`, shared by the IDE and `agy` alike. Antigravity has no project-scoped MCP config, so — like Claude Desktop and OpenClaw — it registers once at user scope, gated on the `~/.gemini/` home existing so a config is never written for a tool that isn't installed. It also appears in the macOS desktop app's consent dialog and is healed by the startup repair/reclaim sweeps.--Antigravity also joins the docked-terminal launch registry: the OpenKnowledge desktop app's "Open in Antigravity" action launches `agy '<prompt>'` in the docked terminal, scoped to the current doc, folder, or project. The row appears only when `agy` is detected on your `PATH`. A new integrations docs page covers MCP setup and the `agy` CLI.diff --git a/.changeset/clone-allow-unsafe-editor.md b/.changeset/clone-allow-unsafe-editor.mddeleted file mode 100644index eb9672b2d..000000000--- a/.changeset/clone-allow-unsafe-editor.md+++ /dev/null@@ -1,7 +0,0 @@-----"@inkeep/open-knowledge": patch------Fix "clone to a new folder" (Open shared document) failing with `Use of "EDITOR" is not permitted without enabling allowUnsafeEditor` for anyone who has `EDITOR` or `GIT_EDITOR` set in their environment — i.e. most developers. `ok clone` runs git as the user with the user's own environment, and simple-git 3.36 refuses to run when it sees an editor env var present (it checks presence, not value) unless explicitly told the env is trusted. The clone path already opted into the sibling PAGER / SSH / askpass flags for the same reason; this adds the missing `allowUnsafeEditor` opt-in. A clone never launches an editor, so honoring the env is safe.--Also hardens the background sync path: the server's `git merge` now runs with `GIT_MERGE_AUTOEDIT=no`, so a merge commit can never launch an editor and hang the TTY-less sync process.diff --git a/.changeset/frontmatter-schema-ref-free.md b/.changeset/frontmatter-schema-ref-free.mddeleted file mode 100644index d811c97b5..000000000--- a/.changeset/frontmatter-schema-ref-free.md+++ /dev/null@@ -1,7 +0,0 @@-----"@inkeep/open-knowledge": patch------Fix the `write` and `edit` MCP tools failing with a schema-conversion error on constrained-decoding hosts like LM Studio (`Error resolving ref #/definitions/__schema0`). Their `frontmatter` field advertised a recursive JSON Schema (`$ref: "#/definitions/__schema0"`); LM Studio — and some function-calling APIs like Gemini — can't resolve an intra-schema `$ref` in a tool definition and reject the whole tool. Claude and most MCP clients resolve it leniently, so this only surfaced on local-inference hosts.--The `frontmatter` value now advertises a flat, `$ref`-free JSON Schema (scalar | array | object | null), while a runtime refinement re-applies the exact recursive validation — so accepted/rejected inputs are unchanged for every client and every write path (nested `null` is still rejected, deep nesting and heterogeneous arrays still accepted). Added a test that compiles every tool's input and output schema and fails if any emits a `$ref`, so this can't silently regress.diff --git a/.changeset/launch-ai-terminal-shortcut.md b/.changeset/launch-ai-terminal-shortcut.mddeleted file mode 100644index 0e09df774..000000000--- a/.changeset/launch-ai-terminal-shortcut.md+++ /dev/null@@ -1,10 +0,0 @@-----"@inkeep/open-knowledge": patch------Keyboard shortcuts for staging a selection into an AI CLI in the terminal, plus new terminal tabs:--- **⌘J** (Show/Hide Terminal): with text selected in the editor, ⌘J stages that selection into an AI CLI's input in the terminal — **not** submitted, so you can add context and press Enter yourself. If the active tab is already running a CLI (claude/codex/…), the passage goes into its prompt (no screen wipe); otherwise a new CLI tab opens and the passage is staged into it. With no selection, ⌘J toggles the terminal as before.-- **⇧⌘J**: opens a new terminal tab. With text selected, it opens a new CLI tab with the passage staged into its input; with no selection, it starts a new chat with your preferred CLI.--The passage is grounded the same way the "Ask AI" selection button does (doc reference + text). Nothing is auto-run — the selection is staged for you to review, extend, and send. Brings AI-in-terminal keyboard parity with Cursor/Zed/VS Code.diff --git a/.changeset/lm-studio-mcp-editor.md b/.changeset/lm-studio-mcp-editor.mddeleted file mode 100644index f913cfcec..000000000--- a/.changeset/lm-studio-mcp-editor.md+++ /dev/null@@ -1,7 +0,0 @@-----"@inkeep/open-knowledge": patch------Add LM Studio as a supported AI tool. `ok init` and the desktop consent dialog now register the OpenKnowledge MCP server into LM Studio's `mcp.json`, so a locally-hosted model in LM Studio's chat can read, search, and write your knowledge base through OK's tools — fully local inference, nothing leaves your machine.--LM Studio is an MCP host that follows Cursor's `mcp.json` notation, so the entry is the same resilient stdio launcher every other editor gets. It's user-global only (no project-scoped config, like Claude Desktop). OpenKnowledge probes both the documented `~/.lmstudio/mcp.json` and the location LM Studio actually uses on macOS (`~/.cache/lm-studio/mcp.json`, per lmstudio-ai/lmstudio-bug-tracker#1371) and writes wherever LM Studio already keeps its config.diff --git a/.changeset/ok-terminal-auto-approve-ok-tools.md b/.changeset/ok-terminal-auto-approve-ok-tools.mddeleted file mode 100644index 277b449a0..000000000--- a/.changeset/ok-terminal-auto-approve-ok-tools.md+++ /dev/null@@ -1,5 +0,0 @@-----"@inkeep/open-knowledge": minor------Built-in terminal now auto-approves OpenKnowledge's own tools for agents it launches, so the read/write loop runs without a per-call approval wall. Claude gets an allow-list (OK's MCP tools + the `ok open` command) with a deny-list that keeps `delete`/`move`/`share_link`/`install` prompting; Codex gets its per-server `approve` mode. Other shell commands, non-OK file edits, and other MCP servers stay gated as before. Applied per launch (nothing written to your CLI config files). Toggle in Settings → Terminal ("Let agents use OpenKnowledge without asking", `agents.autoApproveOkTools`), on by default, per machine. When Codex is installed but OpenKnowledge isn't configured for it, the toggle says so instead of letting Codex quietly keep asking.diff --git a/.changeset/pre.json b/.changeset/pre.jsonindex b762e1455..809d5389f 100644--- a/.changeset/pre.json+++ b/.changeset/pre.json@@ -2,15 +2,15 @@"mode": "pre","tag": "beta","initialVersions": {- "@inkeep/open-knowledge-docs": "0.0.15",- "@inkeep/open-knowledge-app": "0.28.2",- "@inkeep/open-knowledge": "0.28.2",- "@inkeep/open-knowledge-core": "0.28.2",- "@inkeep/open-knowledge-desktop": "0.28.2",- "@inkeep/md-conformance": "0.0.23",+ "@inkeep/open-knowledge-docs": "0.0.16",+ "@inkeep/open-knowledge-app": "0.29.0",+ "@inkeep/open-knowledge": "0.29.0",+ "@inkeep/open-knowledge-core": "0.29.0",+ "@inkeep/open-knowledge-desktop": "0.29.0",+ "@inkeep/md-conformance": "0.0.24","@inkeep/open-knowledge-native-config": "0.0.0","@inkeep/open-knowledge-plugin": "0.3.1",- "@inkeep/open-knowledge-server": "0.28.2"+ "@inkeep/open-knowledge-server": "0.29.0"},"changesets": []}diff --git a/bun.lock b/bun.lockindex 742d6d6bc..c8945d678 100644--- a/bun.lock+++ b/bun.lock@@ -19,7 +19,7 @@},"docs": {"name": "@inkeep/open-knowledge-docs",- "version": "0.0.15",+ "version": "0.0.16","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.28.2",+ "version": "0.29.0","dependencies": {"@codemirror/autocomplete": "^6.20.1","@codemirror/commands": "^6.10.3",@@ -209,7 +209,7 @@},"packages/cli": {"name": "@inkeep/open-knowledge",- "version": "0.28.2",+ "version": "0.29.0","bin": {"open-knowledge": "dist/cli.mjs","ok": "dist/cli.mjs",@@ -253,7 +253,7 @@},"packages/core": {"name": "@inkeep/open-knowledge-core",- "version": "0.28.2",+ "version": "0.29.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.28.2",+ "version": "0.29.0","dependencies": {"@inkeep/open-knowledge": "workspace:*","@inkeep/open-knowledge-core": "workspace:*",@@ -374,7 +374,7 @@},"packages/server": {"name": "@inkeep/open-knowledge-server",- "version": "0.28.2",+ "version": "0.29.0","dependencies": {"@hocuspocus/server": "4.0.0-rc.1","@inkeep/open-knowledge-core": "workspace:*",diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.mdindex 3caa6a352..68f62f4e9 100644--- a/docs/CHANGELOG.md+++ b/docs/CHANGELOG.md@@ -1,5 +1,11 @@# @inkeep/open-knowledge-docs+## 0.0.16++### Patch Changes++- @inkeep/[email protected]+## 0.0.15### Patch Changesdiff --git a/docs/package.json b/docs/package.jsonindex a8bbf0a2c..bbeaad0d3 100644--- a/docs/package.json+++ b/docs/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge-docs",- "version": "0.0.15",+ "version": "0.0.16","license": "GPL-3.0-or-later","private": true,"packageManager": "[email protected]",diff --git a/packages/app/package.json b/packages/app/package.jsonindex 067391a98..e6d0c5216 100644--- a/packages/app/package.json+++ b/packages/app/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge-app",- "version": "0.28.2",+ "version": "0.29.0","license": "GPL-3.0-or-later","private": true,"type": "module",diff --git a/packages/cli/package.json b/packages/cli/package.jsonindex 32ba2f997..1e73b818c 100644--- a/packages/cli/package.json+++ b/packages/cli/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge",- "version": "0.28.2",+ "version": "0.29.0","license": "GPL-3.0-or-later","private": false,"type": "module",diff --git a/packages/core/package.json b/packages/core/package.jsonindex 2e57ec31d..c45849ec0 100644--- a/packages/core/package.json+++ b/packages/core/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge-core",- "version": "0.28.2",+ "version": "0.29.0","license": "GPL-3.0-or-later","private": true,"type": "module",diff --git a/packages/desktop/package.json b/packages/desktop/package.jsonindex 9450fb20b..3b203e280 100644--- a/packages/desktop/package.json+++ b/packages/desktop/package.json@@ -1,7 +1,7 @@{"name": "@inkeep/open-knowledge-desktop","productName": "OpenKnowledge",- "version": "0.28.2",+ "version": "0.29.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 5d2674ccf..4ef44ff82 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.28.2"+ version: "0.29.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 69514591d..45782f083 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.28.2"+ version: "0.29.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 9e67d67c6..d6260ab18 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.28.2"+ version: "0.29.0"author: "Inkeep"repository: "https://github.com/inkeep/open-knowledge"---diff --git a/packages/server/package.json b/packages/server/package.jsonindex 77d66c160..a129202a5 100644--- a/packages/server/package.json+++ b/packages/server/package.json@@ -1,6 +1,6 @@{"name": "@inkeep/open-knowledge-server",- "version": "0.28.2",+ "version": "0.29.0","license": "GPL-3.0-or-later","private": true,"type": "module",