Skip to content

Releases: praneybehl/llm-wiki-plugin

v0.3.0 — Optional compiled graph layer + upgrade flow

25 Apr 11:09

Choose a tag to compare

Pages can now declare typed graph: metadata in frontmatter (predicate, source-page slug, evidence quote, confidence, status). A bundled extractor compiles every page into wiki/graph/{nodes.jsonl, edges.jsonl, graph.sqlite, graph.graphml}. Markdown stays canonical — the graph can be deleted and rebuilt at any time.

What's new

  • Optional graph layer. Typed semantic edges (founded, proposed, depends_on, …) require an explicit source and evidence quote — the extractor never invents them. Body wikilinks become low-confidence mentions edges; frontmatter sources: lists become sourced_from; source pages' raw: fields become summarizes_raw.
  • Three new scripts (require PyYAML; existing four remain stdlib-only):
    • wiki_graph_extract.py — compile pages → JSONL + SQLite + GraphML, deterministic and sorted
    • wiki_graph_lint.py — validate typed edges against wiki/graph/ontology.yaml
    • wiki_graph_query.pyneighbors, edges, path, facts queries against graph.sqlite
  • /wiki:graph <action> slash command dispatching to extract/lint/neighbors/edges/path/facts. /wiki:ingest, /wiki:lint, and /wiki:query wire the graph step in conditionally — only when wiki/graph/ontology.yaml exists.
  • /wiki:upgrade slash command + init_wiki.py --upgrade flag for wikis bootstrapped under v0.2.0. Idempotent file ops plus a walked SCHEMA.md merge — one section at a time, per-edit approval, never silent.
  • references/graph-workflow.md with full reference: ontology, frontmatter schema, when to add a typed edge vs a plain wikilink, the extract/lint/query loop, generated-artifact tracking, anti-patterns.

Upgrading

  • From an older Claude Code install: /plugin marketplace update then /plugin install llm-wiki@llm-wiki.
  • Existing wiki: run /wiki:upgrade (or python skills/llm-wiki/scripts/init_wiki.py . --upgrade from the CLI).
  • Other agents: npx skills update llm-wiki, or re-run the original npx skills add praneybehl/llm-wiki-plugin -a <agent>.
  • Pre-graph wikis remain fully valid — the graph layer is opt-in. New scripts no-op when wiki/graph/ontology.yaml is absent; existing scripts and slash commands behave identically when no page carries graph: metadata.
  • The graph scripts require PyYAML (pip install pyyaml). The existing four scripts are still stdlib-only.

Full notes: see CHANGELOG.md.

v0.2.0 — Multi-agent support and agent-memory integration

15 Apr 11:41

Choose a tag to compare

Second release. Adds multi-agent documentation and an agent-memory integration step at init time. No breaking changes.

Added

  • Multi-agent installation. The llm-wiki skill is agentskills.io-format and installs into Codex, Cursor, Gemini CLI, OpenCode, OpenClaw, Pi Agent, and Hermes Agent via npx skills add (or manual symlink for runtimes outside the skills CLI registry). README now includes a per-agent install table with the exact --agent flag, invocation pattern, and script-execution caveats. OpenCode reads .claude/skills/ directly, so Claude Code users don't need a second install. The /wiki:* slash commands and marketplace manifest remain Claude Code-only.

  • Agent-memory integration during init. /wiki:init now proposes adding a canonical LLM Wiki stanza to the project's agent-memory file so the running agent remembers the wiki in future sessions without being re-told. Target file is agent-aware:

    • Claude Code → CLAUDE.md
    • Codex / Cursor / OpenCode / Pi / OpenClaw → AGENTS.md
    • Gemini CLI → GEMINI.md
    • Multi-agent or unsure → AGENTS.md (symlink CLAUDE.md to it)

    Full workflow, canonical stanza, three-line short variant, and the "never write without user approval" protocol live in the new skills/llm-wiki/references/agent-memory-integration.md.

Notes for upgraders

  • Claude Code: run /plugin marketplace update then /plugin install llm-wiki@llm-wiki. Claude Code picks up the new version from the marketplace entry.
  • Other agents: npx skills update llm-wiki or re-run the same npx skills add praneybehl/llm-wiki-plugin -a <agent> command.
  • Wiki format and schema unchanged; existing wikis keep working as-is.

Verification

Full changelog: https://github.com/praneybehl/llm-wiki-plugin/blob/v0.2.0/CHANGELOG.md

v0.1.0 — Initial release

15 Apr 11:40

Choose a tag to compare

Initial release of the Claude Code plugin implementing Andrej Karpathy's LLM Wiki pattern.

Added

  • llm-wiki skill with progressive-disclosure references.
  • Five slash commands: /wiki:init, /wiki:ingest, /wiki:query, /wiki:lint, /wiki:stats.
  • Four stdlib-only Python scripts: init, BM25 search with frontmatter filters, structural lint, size/shape stats.
  • Marketplace manifest so the repo doubles as a single-plugin marketplace.

Install in Claude Code:

/plugin marketplace add praneybehl/llm-wiki-plugin
/plugin install llm-wiki@llm-wiki

See the README for the full design rationale and Karpathy's original gist: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f