claude-wiki-pages

Karpathy's LLM Wiki, shipped as a Claude Code plugin — four layers, hook-enforced.

A Claude Code plugin that turns an Obsidian vault into a maintained, provenance-tracked knowledge base following Andrej Karpathy's LLM Wiki pattern. The human curates sources; the plugin maintains the wiki; hooks enforce the schema at every tool-call boundary.

The system is convention-driven: the schema lives in skills/init/template/CLAUDE.md, the canonical terms in docs/GLOSSARY.md, the architecture in docs/architecture.md. Every skill, agent, and hook binds to them.

What's inside

Long-form architecture: docs/architecture.md. Feature list and competitor comparison: docs/features.md.

How it works

You type one verb; the orchestrator routes it through the right skill, the Bun engine does the exact work (verify / fix), and a git checkpoint makes every auto-heal reversible. Hooks enforce the schema at each write.

flowchart TD
    U([You]) -->|/claude-wiki-pages:wiki| O[orchestrator agent]
    O -->|fresh vault| INIT[init]
    O -->|raw/ pending| ING[ingest agent]
    O -->|question| ANA[analyst agent]
    O -->|drift| CUR[curator agent]

    subgraph L2["Layer 2 — Skills (thin orchestrators)"]
      INIT & ING & ANA & CUR
    end

    ING & CUR -->|call| ENG[["Bun engine<br/>verify · fix · heal · search · doctor"]]
    ENG -->|checkpoint then auto-heal| HEAL{{"verify → fix → re-verify<br/>(git-checkpointed)"}}
    HEAL -->|clean| VAULT[("Vault<br/>raw/ → wiki/")]
    HEAL -.->|rollback| GIT[(git revert)]

    PreHook[/"hooks: frontmatter · wikilinks · raw-immutable"/] -.->|gate every write| VAULT

    classDef eng fill:#1c2c3c,stroke:#4aa3ff,color:#eaf2ff;
    classDef vault fill:#10261a,stroke:#3ddc84,color:#eafff2;
    class ENG,HEAL eng;
    class VAULT vault;

Prerequisites

/claude-wiki-pages:doctor checks all of these and tells you exactly what to install. The SessionStart hook prints a one-line notice if Bun is missing.

macOS one-liner. Install every dependency above (Homebrew, git, jq, Bun) and patch your PATH in one idempotent step:

curl -fsSL https://raw.githubusercontent.com/odere-pro/claude-wiki-pages-plugin/main/install-macos.sh | bash

OS: macOS or Linux verified. Windows/WSL unverified for hook scripts; markdown-only paths should work.

Install

/plugin marketplace add odere-pro/claude-software-3-0-marketplace
/plugin install claude-wiki-pages

macOS one-command dependency setup, scriptable per-project enablement, local-clone install, update, and uninstall: see docs/install.md.

Quickstart

/claude-wiki-pages:wiki

That is the one verb. The orchestrator probes vault state and dispatches:

• No vault yet → runs the init wizard. Scaffolds docs/vault/ with the schema and a bundled sample source ready to ingest — no files needed from you to see a real result.
• New files in raw/ → runs claude-wiki-pages-ingest-agent. Produces typed wiki pages with citations and a wiki/log.md entry, then runs claude-wiki-pages-polish-agent to refresh graph colors and indexes.
• Pending lint after an ingest → runs claude-wiki-pages-curator-agent to audit and repair.
• Analytical prompt (what, why, compare, summarize, …) → runs claude-wiki-pages-analyst-agent. Every answer cites [[wikilinks]] back to source.

Full operations reference: docs/operations.md.

Guided first-run wizard — walks scaffold → ingest → first answer, one step at a time:

/claude-wiki-pages:onboarding

Environment health check — run after install and whenever something feels off:

/claude-wiki-pages:doctor

doctor reports all green when prerequisites are met. If it flags anything, fix the prerequisite it names and run /claude-wiki-pages:wiki.

The basic operations — ingestion and querying — also run with a local model, fully offline, with zero Claude. Both are gated: only a model that passed the per-tier quality gate runs (qwen3-coder:30b today), and a query answer is shown only after every citation verifies verbatim against the wiki — otherwise the plugin warns and denies the operation. doctor is deterministic and needs no model at all.

// .claude/claude-wiki-pages.json
{
  "localModel": {
    "enabled": true,
    "model": "qwen3-coder:30b",
    "tier": "query",
    "offlinePolicy": "prefer-local",
  },
}

# With Claude Code stopped and `ollama serve` running:
bash scripts/offline-draft.sh                          # ingest raw/ → _proposed/ drafts (tier: ingest-extract)
bash scripts/offline-query.sh --question "<question>"  # verified, cited answer  (tier: query)

Drafts are promoted later via /claude-wiki-pages:review. Full story, tested models, and how tiers unlock: docs/local-models.md.

Documentation

Privacy

No telemetry. The plugin never phones home. Your vault, your hooks, your shell. Settings are local at .claude/claude-wiki-pages/settings.json.

License and non-affiliation

Licensed under the MIT License. Bundled third-party code is credited in THIRD_PARTY_LICENSES.md.

Not affiliated with Anthropic, Obsidian, or Andrej Karpathy — this is an independent implementation built on their public work. Credits:

• Andrej Karpathy's LLM Wiki gist — the pattern this implements.
• kepano/obsidian-skills — MIT — obsidian-markdown, obsidian-bases, obsidian-cli skills, included unmodified.
• Anthropic — Claude Code and the plugin format.
• Obsidian — the vault format this plugin maintains.

Author: odere-pro on GitHub.