open-zk-kb

[](https://github.com/mrosnerr/open-zk-kb/actions/workflows/ci.yml) [](https://www.npmjs.com/package/open-zk-kb) [](https://www.npmjs.com/package/open-zk-kb) [](https://opensource.org/licenses/MIT)

Shared, persistent memory for AI assistants, built on the Zettelkasten method. One knowledge base for all your tools — so context persists across sessions and clients.

<p align="center"> <br> _{Real MCP calls — store, search, and stats run against a live knowledge base.} </p>

AI assistants forget everything between sessions. open-zk-kb gives your assistant a persistent, structured memory it queries automatically.

• Hybrid search — full-text + local embeddings, so only relevant notes surface
• Atomic notes — one concept per note (6 kinds, lifecycle management) keeps results precise
• Local-first — no API keys, works offline, scales to thousands of notes
• Human-readable — Markdown + YAML frontmatter, rebuildable from files
• Shared memory across tools — one knowledge base for OpenCode, Claude Code, Cursor, Windsurf, and Zed
• MIT-licensed

> Requires [Bun](https://bun.sh) — install with curl -fsSL https://bun.sh/install | bash

bunx open-zk-kb@latest

That's it. The interactive installer:

1. Adds the MCP server to your client config
2. Installs knowledge base instructions (skill for Claude Code, managed block for OpenCode/Windsurf)
3. Creates a local vault at ~/.local/share/open-zk-kb

Supported clients: OpenCode, Claude Code, Cursor, Windsurf, Zed

Your AI assistant gets three MCP tools:

| Tool | Wh