knowlery

One plain-markdown workspace, served by three shells: an MCP server and CLI for Codex, Claude, Cursor, and Antigravity — and an Obsidian plugin as its richest human interface. Obsidian maximizes Knowlery; nothing about it requires Obsidian.

Your free-form notes stay yours. Agents get a structured, retrievable layer — entities/, concepts/, comparisons/, queries/ — compiled from your material through a reviewed pipeline, plus the skills and conduct that make them good collaborators. Retrieval is deterministic and measured, answers carry citations, and "no confident match" is an honest verdict instead of noise. The workspace format, CLI surface, and MCP contracts are frozen under semver and pinned by contract tests.

Read the official documentation: https://jayjiangct.github.io/knowlery/.

Two ways to start

With your agent (no Obsidian required)

Install the agent plugin — MCP server plus all fifteen skills in one action:

Claude Code:  /plugin marketplace add JayJiangCT/knowlery
              /plugin install knowlery

Codex:        codex plugin marketplace add <source>
              codex plugin add knowlery@<marketplace>

Or add one MCP config block to any client (Cursor, Claude Desktop, Antigravity, …):

{ "command": "npx", "args": ["-y", "knowlery@^1", "mcp"] }

Then everything is conversation: "set up a knowledge base called main", "remember this", "what do I know about X?", "give my KB a checkup". Per-client setup: Connect Your Agent · usage by conversation: Talk to Your Knowledge Base.

In Obsidian

Install Knowlery from Obsidian's community plugin directory (Settings → Community plugins → Browse) and run the setup wizard. You get the action-first dashboard, Knowledge health, and the bundle sharing UI — and the vault registers itself so every agent can address it by name. Full walkthrough: Start in Obsidian.

Either way it's the same plain folder: a KB born in a conversation opens in Obsidian with zero migration, and an Obsidian vault is automatically available to your agents.

Brand

Knowlery's identity is the Atlas Fold system — a K-shaped route connecting source, structure, and retrieval, drawn in graphite and paper with a single Knowledge Lime signal. The metaphor is deliberate: a map you can trust, not a mind you have to believe.

Position	Local-first knowledge infrastructure — your notes remain plain Markdown; Knowlery adds structure, retrieval, and agent access without taking ownership of the source.
Character	Exact, calm, and quietly alive — technical enough to earn developer trust, warm enough to feel like a place where knowledge accumulates.
Difference	Structure over spectacle — no chatbot face, neural cloud, or AI glow. The visual language is navigation through a maintained body of knowledge.

The full brand system — logo construction, palette, typography, voice, and usage rules — lives in design/brand/ (open brand-guide.html in a browser). Marks, lockups, and the app icon are under design/brand/assets/.

Inspiration: LLM Wiki & BYOAO

Andrej Karpathy's "LLM Wiki"

In LLM Wiki, Andrej Karpathy describes a pattern different from one-off RAG: instead of re-deriving answers from raw notes on every question, an agent incrementally builds and maintains a persistent wiki—structured, interlinked markdown that sits between you and your sources. New material is read, distilled, and folded into entity pages, topic summaries, and cross-links; the base is kept current rather than re-scanned from scratch each time.