llm-wiki - Personal Knowledge Base
An opinionated implementation of Karpathy's LLM Wiki concept — a Claude Code plugin that turns Claude into the compiler and query engine for a personal, LLM-maintained knowledge base. Ready for using Obsidian as an optional content viewer.
This README has two audiences, and it is split to match:
For wiki users — install the plugin and drive it with /pkb commands to research, ingest, compile, and query a personal knowledge base. Installing means cloning this repo once; after that, nothing inside the repo needs to be read or changed.
For plugin developers — change the prompts, command specs, scripts, and tests that are this repo.
Wiki Users
What this is
Bookmarks rot. Notes go stale. "I read something about this once" is not knowledge.
pkb turns Claude Code into a compiler for the things worth knowing. Point it at the world — a question, a URL, a pile of PDFs — and it researches, reads, cross-checks, and writes the result into a wiki that stays queryable forever. The articles are never written by hand; Claude writes them. The job here is to ask.
The mental model is one sentence: raw sources are the source code, Claude is the compiler, the wiki is the executable. Everything else follows from that.
Three layers, one rule
raw/ ← sources, ingested once, never edited (the source code)
wiki/ ← articles Claude synthesizes from raw/ (the executable)
output/ ← reports, slides, plans on request (what ships)
The rule: never hand-edit wiki/. It is compiled — Claude rebuilds it from raw/. When an article is wrong, fix the source (ingest a better one, /pkb-retract a bad one) and recompile. Editing the compiled article is pointless: the next compile overwrites it.
Each topic is its own isolated wiki (crypto-quant, market-microstructure, defi…). Topics sit side by side under one hub but never bleed into each other — research stays scoped and context stays clean:
~/llm-wiki-data/ # Hub — registry only, no content
├── wikis.json # Registry of all topic wikis
├── _index.md # Lists topic wikis with stats
├── log.md # Global activity log
└── topics/
└── <topic>/ # One isolated wiki per topic
├── raw/ # Immutable sources
├── wiki/ # Compiled, cross-linked articles
├── output/ # Generated artifacts + projects
├── inventory/ # Lazy: durable tracking records
├── datasets/ # Lazy: manifests for large/external data
├── _index.md
├── config.md
└── log.md
_index.md files are a derived cache rebuilt from frontmatter — also never hand-edited. For the full design — components, flows, and the rationale behind them — see docs/llm-agent-architecture.md.
Install once
pkb installs into Claude Code from a local checkout of this repo. Cloning it is a one-time install step — afterward the repo never needs opening again:
git clone https://github.com/zhaow-de/llm-wiki.git
claude plugin marketplace add /absolute/path/to/llm-wiki
claude plugin install pkb@llm-wiki
# restart Claude Code or run /reload-plugins in Claude Code
Then, in Claude Code, run once to register the /pkb-* slash commands:
/pkb:install-commands
After this, invoke wiki commands as /pkb, /pkb-research, /pkb-ingest, etc. Re-run /pkb-install-commands after plugin updates to sync any new or removed commands.
Confirm it loaded with /pkb status. Claude Desktop picks up the same plugin once Claude Code has installed it.
The wiki lives at ~/llm-wiki-data/ by default; change the hub path with /pkb config hub-path "<new-path>". To move to a newer version later, run git -C /path/to/llm-wiki pull then claude plugin update pkb@llm-wiki (restart or /reload-plugins).
