by nvk
A Claude Code plugin for building LLM-compiled knowledge bases. Ingest sources, compile interconnected markdown articles, query, lint, research, and generate outputs — all from Claude Code. Optionally view in Obsidian.
# Add to your Claude Code skills
git clone https://github.com/nvk/llm-wiki __ __ __ __ __
| \ \ | \ \ | \
| ▓▓ ▓▓______ ____ __ __ __ \▓▓ ▓▓ __ \▓▓
| ▓▓ ▓▓ \ \ | \ | \ | \ \ ▓▓ / \ \
| ▓▓ ▓▓ ▓▓▓▓▓▓\▓▓▓▓\ | ▓▓ | ▓▓ | ▓▓ ▓▓ ▓▓_/ ▓▓ ▓▓
| ▓▓ ▓▓ ▓▓ | ▓▓ | ▓▓ | ▓▓ | ▓▓ | ▓▓ ▓▓ ▓▓ ▓▓| ▓▓
| ▓▓ ▓▓ ▓▓ | ▓▓ | ▓▓ | ▓▓_/ ▓▓_/ ▓▓ ▓▓ ▓▓▓▓▓▓\| ▓▓
| ▓▓ ▓▓ ▓▓ | ▓▓ | ▓▓ \▓▓ ▓▓ ▓▓ ▓▓ ▓▓ \▓▓\ ▓▓
\▓▓\▓▓\▓▓ \▓▓ \▓▓ \▓▓▓▓▓\▓▓▓▓ \▓▓\▓▓ \▓▓\▓▓
LLM-compiled knowledge bases for any AI agent. Parallel multi-agent research, thesis-driven investigation, source ingestion, wiki compilation, querying, and artifact generation. Ships as a Claude Code plugin or a portable AGENTS.md for Codex and others. Obsidian-compatible.
v0.0.12 — Configurable Hub Path. Store wiki on iCloud, Dropbox, or any custom location via /wiki config hub-path <path>. Config at ~/.config/llm-wiki/config.json. Default ~/wiki/ unchanged. v0.0.12-fix: Centralized hub resolution into references/hub-resolution.md — fixes iCloud paths where agents misexpanded tildes in com~apple~CloudDocs or broke on spaces in Mobile Documents.
v0.0.11 — Source Retraction. /wiki:retract removes sources and cleans up all downstream references. --recompile rewrites affected articles, --dry-run previews blast radius. New lint rule C4b catches dangling refs.
v0.0.10 — Research Quality. Session registry for crash recovery, standardized agent prompts, credibility scoring (Phase 2b), progress scoring (0-100) with smart termination, and inter-round plan reflection.
No comments yet. Be the first to share your thoughts!
Claude Code (native plugin):
claude plugin install github:nvk/llm-wiki
OpenAI Codex / Any LLM Agent (idea file):
# Copy AGENTS.md into your agent's context or project root
cp AGENTS.md ~/your-project/AGENTS.md
The AGENTS.md file contains the complete wiki protocol as a single portable document — works with any LLM agent that can read/write files and search the web.
Claude Code — if claude plugin update pulls the latest correctly:
claude plugin update wiki@llm-wiki
# Restart Claude Code to apply
If the update command doesn't pick up the new version (stale marketplace cache), sync manually from the repo:
# Clone or pull the latest
git clone https://github.com/nvk/llm-wiki.git # or: git -C ~/llm-wiki pull
# Sync plugin files to Claude Code's plugin cache
REPO=~/llm-wiki/claude-plugin
DEST=~/.claude/plugins/cache/llm-wiki/wiki
VERSION=$(grep '"version"' "$REPO/.claude-plugin/plugin.json" | grep -o '[0-9.]*')
rm -rf "$DEST"/*
mkdir -p "$DEST/$VERSION"
cp -R "$REPO/.claude-plugin" "$REPO/commands" "$REPO/skills" "$DEST/$VERSION/"
# Restart Claude Code to apply
AGENTS.md — just pull the latest and replace:
curl -sL https://raw.githubusercontent.com/nvk/llm-wiki/master/AGENTS.md > ~/your-project/AGENTS.md
Check your installed version: look for the version in /wiki status output or check ~/.claude/plugins/installed_plugins.json.
New to a topic? One command, from anywhere:
/wiki:research "gut microbiome" --new-topic --min-time 1hCreates a topic wiki, launches parallel agents, and keeps researching for an hour — drilling into subtopics each round finds. Come back to a fully compiled wiki.
/wiki:research "nutrition" --new-topic # Create wiki + research in one shot
/wiki:research "gut-brain axis" --wiki nutrition # Add more research to existing wiki
/wiki:research "fasting" --deep --min-time 2h # 8 agents, keep going for 2 hours
/wiki:research "keto" --retardmax # 10 agents, max speed, ingest everything
/wiki:research "What makes long form articles go viral?" --new-topic # Question → decompose → playbook
/wiki:thesis "fiber reduces neuroinflammation via SCFAs" # Thesis-driven: evidence for + against → verdict
/wiki:thesis "cold exposure upregulates BDNF" --min-time 1h # Deep thesis investigation
/wiki:query "How does fiber affect mood?" # Ask the wiki
/wiki:query "compare keto and mediterranean" --deep # Deep cross-referenced answer
/wiki:ingest https://example.com/article # Manually ingest a source
/wiki:ingest --inbox # Process files dropped in inbox/
/wiki:compile # Compile any unprocessed sources
/wiki:output report --topic gut-brain # Generate a report
/wiki:output slides --retardmax # Ship a rough slide deck NOW
/wiki:assess /path/to/my-app --wiki nutrition # Gap analysis: repo vs wiki vs market
/wiki:lint --fix # Clean up inconsistencies
| Command | Description |
|---------|-------------|
| /wiki | Show wiki status, stats, and list all topic wikis |
| /wiki init <name> | Create a topic wiki at ~/wiki/topics/<name>/ |
| /wiki init <name> --local | Create a project-local wiki at .wiki/ |
| /wiki:ingest <source> | Ingest a URL, file path, or quoted text |
| /wiki:ingest --inbox | Process all files in the topic wiki's inbox/ |
| /wiki:compile | Compile new sources into wiki articles |
| /wiki:compile --full | Recompile everything from scratch |
| /wiki:query <question> | Q&A against the wiki (standard depth) |
| /wiki:query <question> --quick | Fast answer from indexes only |
| /wiki:query <question> --deep | Thorough — reads everything, checks raw + sibling wikis |
| /wiki:research <topic> | 5 parallel agents: academic, technical, applied, news, contrarian |
| /wiki:research <topic> --new-topic | Create a topic wiki and start researching — works from any directory |
| /wiki:research <topic> --min-time 1h | Keep researching in rounds until time budget is spent |
| /wiki:research <topic> --deep | 8 agents: adds historical, adjacent, data/stats |
| /wiki:research <topic> --retardmax | 10 agents: skip planning, max speed, ingest aggressively |
| /wiki:thesis <claim> | Thesis-driven research: evidence for + against → verdict |
| /wiki:thesis <claim> --min-time 1h | Multi-round thesis investigation with anti-confirmation-bias |
| /wiki:search <terms> | Find content by keyword or tag |
| /wiki:lint | Run health checks on the wiki |
| /wiki:lint --fix | Auto-fix structural issues |
| /wiki:lint --deep | Web-verify facts and suggest improvements |
| /wiki:output <type> | Generate: summary, report, study-guide, slides, timeline, glossary, comparison |
| /wiki:output <type> --retardmax | Ship it now — rough but comprehensive, iterate later |
| /wiki:assess <path> | Assess a repo against wiki research + market. Gap analysis. |
| /wiki:assess <path> --retardmax | Wide net — adds adjacent fields and failure analysis |
All commands accept --wiki <name> to target a specific topic wiki and --local to target the project wiki.
~/wiki/ # Hub — lightweight, no content
├── wikis.json # Registry of all topic wikis
├── _index.md # Lists topic wikis with stats
├── log.md # Global activity log
└── topics/ # Each topic is an isolated wiki
├── nutrition/ # Example topic wiki
│ ├── .obsidian/ # Obsidian vault config
│ ├── inbox/ # Drop zone for this topic
│ ├── raw/ # Immutable sources
│ ├── wiki/ # Compiled articles
│ │ ├── concepts/
│ │ ├── topics/
│ │ └── references/
│ ├── output/ # Generated artifacts
│ ├── _index.md
│ ├── config.md
│ └── log.md
├── woodworking/ # Another topic wiki
└── ...
The hub is just a registry — no content directories, no .obsidian/. All content lives in topic sub-wikis with isolated indexes and articles. Queries stay focused. The multi-wiki peek finds overlap across topics when relevant.
_index.md navigation — every directory has an index. Claude reads indexes first, never scans blindly.[[wikilinks]] (Obsidian) and standard markdown links on every cross-reference. Works everywhere.log.md tracks every operation, append-only, grep-friendly.| Mode | Flag | Agents