llm-wiki

Install

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.

Upgrade

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 1h

Creates 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.

Quick Start

/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

Commands

| 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.

How It Works

Architecture

~/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.

The Flow

1. Research a topic — parallel agents search the web, ingest sources, and compile articles in one command
2. Ingest additional sources — URLs, files, text, tweets (via Grok MCP), or bulk via inbox
3. Compile raw sources into synthesized wiki articles with cross-references and confidence scores
4. Query the wiki — quick (indexes), standard (articles), or deep (everything)
5. Assess a repo against the wiki — gap analysis: what aligns, what's missing, what the market offers
6. Lint for consistency — broken links, missing indexes, orphan articles
7. Output artifacts — summaries, reports, slides — filed back into the wiki

Key Design

• One topic, one wiki — each research area gets its own sub-wiki with isolated indexes. No cross-topic noise.
• Parallel research agents — 5 standard, 8 deep, 10 retardmax. Each agent searches from a different angle.
• _index.md navigation — every directory has an index. Claude reads indexes first, never scans blindly.
• Articles are synthesized, not copied — they explain, contextualize, cross-reference.
• Raw is immutable — once ingested, sources are never modified.
• Multi-wiki aware — queries peek at sibling wiki indexes for overlap.
• Dual-linking — both [[wikilinks]] (Obsidian) and standard markdown links on every cross-reference. Works everywhere.
• Confidence scoring — articles rated high/medium/low based on source quality and corroboration.
• Structural guardian — auto-checks wiki integrity after operations, fixes trivial issues silently.
• Activity log — log.md tracks every operation, append-only, grep-friendly.
• Zero dependencies — runs entirely on Claude Code built-in tools.

Research Modes

| Mode | Flag | Agents