Release v0.30.0 · inkeep/open-knowledge

0.30.0

Stable promotion of beta v0.30.0-beta.4.

Aggregated changes since previous stable:

Links in the terminal are now clickable. URLs open in your browser (including explicit OSC 8 hyperlinks from tools like ls --hyperlink), and file paths in output — absolute, relative, or with a trailing :line:col — become clickable when they point to something inside your project: Markdown documents open in the editor, folders open to their overview, and other files open in the OS default app (revealed in Finder when the type can't be opened directly). Only in-project paths that actually exist are highlighted, so there are no dead links. A file path pointing outside your project asks first with a "this file is outside your project — reveal in Finder?" prompt. Links inside a full-screen terminal app that handles its own clicks (like the Claude TUI) are left to that app, so they open exactly once.

Add Hermes Agent (Nous Research) as an MCP-host AI option. ok init now detects Hermes (via ~/.hermes/) and registers the OpenKnowledge server in ~/.hermes/config.yaml under mcp_servers, using the same resilient launcher every other editor gets. Hermes keeps its whole config — models, tool filters, other MCP servers — in that one YAML file, so OK edits only its own open-knowledge entry via a format-preserving surgical write (the first YAML host; comments, values, key order, and block formatting are preserved) and declines rather than clobber a config it can't safely parse. Uninstall/repair strip only OK's own entry, leaving a foreign server that shares the key untouched. Like OpenClaw, Hermes is written only when it's actually installed.

Remove the launch.json preview machinery and the pane-target arming subsystem. Claude Code Desktop's in-app Browser pane now opens the preview URL directly (preview_start({url}) + navigate({url})), so OK no longer scaffolds .claude/launch.json.

Breaking for consumers: the @inkeep/open-knowledge package drops the scaffoldLaunchJson, LAUNCH_UI_CHAIN_*, and LaunchJsonResult exports; the preview_url MCP tool drops the armPaneTarget param; and the /api/config response drops the paneTarget field. The ok start repair sweep now removes any pre-existing open-knowledge-ui launch.json entry instead of rewriting it.

Configure a custom OpenAI-compatible embeddings endpoint from Settings → This project → Search instead of editing config files by hand. The semantic-search settings now expose the embeddings base URL directly, and the account copy plus ok embeddings set-key messaging now describe the key as belonging to the configured embeddings provider rather than only to OpenAI.