wiki

LLM Wiki — portable scaffold

Personal LLM-curated wiki: a structured markdown KB that an LLM grows incrementally (ingest → sources → entities/concepts) instead of re-deriving knowledge each time through RAG. Local search via qmd + MCP integration with Claude Code.

This repository is both a Claude Code marketplace (so you can install the wiki plugin with one command) and a template scaffold (init.sh materializes a fresh wiki in any folder).

Quickstart

# 1. Materialize a wiki skeleton inside your project (no clone — fetches template tarball)
curl -fsSL https://raw.githubusercontent.com/genkovich/llm-wiki/main/init.sh | bash -s ./wiki

# 2. Add this repo as a Claude Code marketplace and install the plugin
#    Inside Claude Code:
/plugin marketplace add genkovich/llm-wiki
/plugin install wiki@llm-wiki

# 3. Install qmd (search engine: on-device BM25 + vector + LLM rerank)
npm install -g @tobilu/qmd
qmd collection add ./wiki --name my-wiki
qmd context add qmd://my-wiki "<1-2 sentences about the domain — affects reranking>"
qmd embed   # first run downloads ~330MB of embedder GGUF

In Claude Code, install the qmd plugin so that query/get/multi_get are available as native MCP tools:

/plugin marketplace add tobi/qmd
/plugin install qmd@qmd
/reload-plugins

After that the skills are reachable under the wiki: namespace:

Skill	Triggers on
wiki:inbox	inbox this, wiki: inbox <url>, drop a URL for later parsing
wiki:parse	parse this, wiki: parse <path>, a new file in raw/_inbox/
wiki:query	wiki: <question>, що каже wiki про X, знайди в wiki
wiki:lint	wiki: lint, перевір wiki, audit the wiki

Each skill locates the target wiki by type: schema, scope: wiki in the CLAUDE.md frontmatter and runs the workflow from that wiki's CLAUDE.md.

Cron / scheduled parse (optional)

Auto-parse raw/_inbox/ every 10 minutes — through launchd on macOS or systemd user units on Linux.

Common — env file

mkdir -p ~/.config
WIKI_PLUGIN_BASE="$HOME/.claude/plugins/cache/llm-wiki/wiki"
WIKI_PLUGIN="$WIKI_PLUGIN_BASE/$(ls -1t "$WIKI_PLUGIN_BASE" | head -1)"
cp "$WIKI_PLUGIN/scripts/wiki-parse.env.example" ~/.config/wiki-parse.env
# edit ~/.config/wiki-parse.env — set WIKI=/path/to/your/wiki

macOS (launchd)

sed "s|__PLUGIN_ROOT__|$WIKI_PLUGIN|g" "$WIKI_PLUGIN/launchd/com.wiki-parse.plist.example" \
  > ~/Library/LaunchAgents/com.wiki-parse.plist
launchctl load ~/Library/LaunchAgents/com.wiki-parse.plist

Logs: $WIKI/.cron-parse.log. Stop: launchctl unload ~/Library/LaunchAgents/com.wiki-parse.plist.

Linux (systemd user units)

mkdir -p ~/.config/systemd/user
for f in wiki-parse.service wiki-parse.timer; do
  sed "s|__PLUGIN_ROOT__|$WIKI_PLUGIN|g" "$WIKI_PLUGIN/systemd/$f.example" \
    > ~/.config/systemd/user/$f
done
systemctl --user daemon-reload
systemctl --user enable --now wiki-parse.timer

Logs: ~/.local/state/wiki-parse.log and $WIKI/.cron-parse.log. Stop: systemctl --user disable --now wiki-parse.timer.

Local development

Working on the plugin itself? Add the local checkout as a marketplace and reinstall after every change:

/plugin marketplace add /path/to/llm-wiki
/plugin install wiki@llm-wiki
/reload-plugins

Customization

After init.sh runs, open and edit the placeholders in the new wiki:

• wiki/CLAUDE.md — replace <DOMAIN> and <DOMAIN_DESCRIPTION> with your domain. This is the schema the LLM reads on every ingest/query/lint
• wiki/overview.md — set the domain title in the heading
• wiki/log.md — set today's date in the bootstrap entry

Workflows

The four skills above map to these actions — authoritative protocols live in the generated wiki/CLAUDE.md, which the LLM reads on every invocation:

• wiki:inbox — queue helper: drop a URL or file into raw/_inbox/ for later parsing (no other writes)
• wiki:parse — ingest pipeline: raw source → sources/<slug>.md → updates 10-15 entities//concepts/ with citations → append log.md
• wiki:query — MCP qmd search → synthesis with [[wikilink]] citations → optional filer-back into comparisons//questions/
• wiki:lint — find contradictions, orphans, stale pages, data gaps → write into questions/lint-YYYY-MM-DD.md

Generated structure