llm-wiki

██╗     ██╗     ███╗   ███╗    ██╗    ██╗██╗██╗  ██╗██╗
██║     ██║     ████╗ ████║    ██║    ██║██║██║ ██╔╝██║
██║     ██║     ██╔████╔██║    ██║ █╗ ██║██║█████╔╝ ██║
██║     ██║     ██║╚██╔╝██║    ██║███╗██║██║██╔═██╗ ██║
███████╗███████╗██║ ╚═╝ ██║    ╚███╔███╔╝██║██║  ██╗██║
╚══════╝╚══════╝╚═╝     ╚═╝     ╚══╝╚══╝ ╚═╝╚═╝  ╚═╝╚═╝

github.com/nvk/llm-wiki

LLM-compiled knowledge bases for any AI agent. Parallel multi-agent research, collector catalogs, automated session capture, feedback curation, thesis-driven investigation, source ingestion, wiki compilation, truth-seeking audits, querying, and artifact generation. Ships as a Claude Code plugin, an OpenAI Codex plugin, an OpenCode instruction file, or a portable AGENTS.md for any other LLM agent. Obsidian-compatible.

Install · Quick Start · Commands · How It Works · Research Modes · Thesis Research · Query Depths · Linking · Obsidian · Architecture · Nono Sandbox · Upgrade · Changelog · Credits

Changelog

v0.16.0 — Query Lite and token benchmarks. Adds a compact read-only query protocol across Claude Code, Codex, Pi, DS4, OpenCode, and portable agents; reduces Claude /wiki:query instructions by 72.54%; adds explicit $wiki-query, read-only Pi launchers, static context budgets, corpus-identity gates, and reproducible Codex/Claude/DS4 benchmark lanes. OpenCode live-model behavior remains best effort.

v0.15.0 — Topic guides. Reframes schema.md as a human-owned topic guide, adds the friendlier llm-wiki schema adopt helper, keeps schema migrate --apply as a compatibility alias, and updates librarian docs to talk about conventions proposals instead of database-style schema migrations.

v0.14.0 — Default topic guides. Adds advisory schema.md by default, safe adoption helpers for older wikis, proposal-only librarian convention updates, deterministic docs/lint checks, and clarifies the optional index/server layer as a rebuildable non-authoritative cache.

v0.12.0 — Feedback curator. Captures high-signal corrections, preferences, approvals, and plan acceptance as redacted feedback candidates under HUB/.sessions/feedback/; ignores generic acknowledgements; adds review/manual-capture/promotion workflows; and keeps promotion into topic raw/notes/ explicit.

v0.11.1 — Session helper compatibility. Small hotfix so automated session capture works on Python 3.9/macOS system Python as well as newer Python runtimes.

v0.11.0 — Automated session capture. Default-on redacted checkpoints under HUB/.sessions/, opt-out via session disable, compact context rehydration, explicit digest promotion, and a tested Codex hook bundle.

Install

Claude Code (native plugin):

claude plugin install wiki@llm-wiki

OpenAI Codex (marketplace plugin):

Install from GitHub:

codex plugin marketplace add nvk/llm-wiki
codex plugin add wiki@llm-wiki
# Start a new Codex thread, then use @wiki or type $ to select wiki-query

Install from a local checkout with the managed bootstrap helper:

./scripts/bootstrap-codex-plugin.sh --scope user --verify

Or register the local checkout manually:

codex plugin marketplace add /absolute/path/to/llm-wiki
codex plugin add wiki@llm-wiki

Canonical explicit invocation:

$wiki-query "What does the wiki say about hardware wallet threat models?"
@wiki research "hardware wallet threat models"
@wiki collect "bitcoin memes" --wiki memes-bitcoin
@wiki ingest https://example.com/article
@wiki audit --project coldcard-threat-model
@wiki session status
@wiki feedback list --unpromoted
@wiki session disable   # optional opt-out
@wiki ll "codex plugin install gotchas"

Upgrade:

codex plugin marketplace upgrade llm-wiki
codex plugin add wiki@llm-wiki

Remove:

codex plugin remove wiki@llm-wiki
codex plugin marketplace remove llm-wiki

Troubleshooting:

• codex plugin marketplace add registers the catalog; codex plugin add wiki@llm-wiki installs and enables the cached plugin non-interactively.
• Open /hooks to review and trust the bundled hooks if you want automated session capture. The @wiki skill works without hook trust.
• $wiki-query is the small, explicit, read-only skill for lookups. In Codex CLI/IDE, type $ or open /skills and select it. It never activates implicitly or changes wiki files.
• @wiki is the full research and maintenance entry point. Natural-language wiki requests can still auto-activate it.
• Restart Codex after changing config if an existing session does not pick up the new plugin state.
• If you run Codex under a sandbox wrapper like nono, see Nono Sandbox Permissions — Codex needs r+w to $HOME/.codex for plugin install.

OpenCode (instruction file):

Add to your opencode.json (project-level or ~/.config/opencode/.opencode.json for global):

{
  "instructions": ["https://raw.githubusercontent.com/nvk/llm-wiki/master/plugins/llm-wiki-opencode/skills/wiki-manager/SKILL.md"],
  "permission": {
    "external_directory": {
      "~/.config/llm-wiki/**": "allow",
      "~/Library/Mobile Documents/com~apple~CloudDocs/wiki/**": "allow"
    }
  }
}

OpenCode fetches the URL fresh on every session start — no manual updates needed. If you prefer a local copy instead:

curl -sL https://raw.githubusercontent.com/nvk/llm-wiki/master/plugins/llm-wiki-opencode/skills/wiki-manager/SKILL.md > ~/.config/opencode/AGENTS.md

For a smaller read-only setup, use the best-effort query preset instead:

{
  "instructions": ["https://raw.githubusercontent.com/nvk/llm-wiki/master/plugins/llm-wiki-opencode/skills/wiki-query/SKILL.md"]
}

The OpenCode profile is sync- and budget-tested, but not tied to one model, so it does not have a provider-specific live quality gate. Treat it as a portable best-effort preset and keep OpenCode's write and shell permissions disabled for query-only sessions.

The external_directory permission is required because the wiki hub lives outside the project directory. Set the paths to match your hub location. Alternatively, use --local mode (.wiki/ in the project) to skip permissions entirely.

Web search requires export OPENCODE_ENABLE_EXA=1.

Pi (skill file, best for local models):

Pi's minimal system prompt leaves room for on-demand wiki workflows on local models. Load the full skill for research and write-capable maintenance:

pi --skill path/to/llm-wiki/plugins/llm-wiki-opencode/skills/wiki-manager/SKILL.md

Invoke it as /skill:wiki-manager, or let Pi load it when the request clearly matches its description.

For fast read-only queries with Pi's currently configured provider, use the generic launcher. It disables discovery and write tools and loads the compact shared query protocol:

./scripts/pi-wiki-query

For DS4, the provider-specific launcher additionally creates an isolated Pi state directory and pins the local model settings:

./scripts/pi-ds4-wiki-query

Set PI_CLI, DS4_BASE_URL, or LLM_WIKI_PI_DS4_STATE_DIR only when your local setup differs from the defaults. Both launchers accept --dry-run to show the exact command. The equivalent generic Pi settings are:

pi \
  --append-system-prompt path/to/llm-wiki/profiles/query-lite/SKILL.md \
  --tools read,grep,find,ls \
  --no-extensions --no-skills --no-prompt-templates --no-themes

The DS4 query profile is intentionally unable to write. Switch to the full skill for ingest, research, compile, lint, or other mutating workflows. See profiles/ds4/README.md and the reproducible benchmarks/README.md DS4 lane.

Any LLM Agent (portable instruction file):

# Read-only queries: small default
cp profiles/query-lite/SKILL.md ~/your-project/AGENTS.md

# Research and maintenance: complete protocol
cp AGENTS.md ~/your-project/AGENTS.md

The query-lite profile works with agents that can read and search files. The root AGENTS.md contains the complete write-capable protocol for agents that can also edit files and search the web.

Claude-First, Multi-Runtime

Claude Code is the principal user. Keep one shared behavior layer and thin packaging layers per runtime:

• claude-plugin/ is the primary distribution target and UX surface.
• claude-plugin/skills/wiki-manager/ is the behavioral source of truth.
• plugins/llm-wiki/skills/wiki/ is the generated Codex packaging target behind @wiki.
• claude-plugin/skills/wiki-manager/references/query-lite.md is the canonical read-only query protocol.
• profiles/query-lite/SKILL.md and generated wiki-query skills expose that protocol without the full research context.
• plugins/llm-wiki-opencode/ is the OpenCode and Pi packaging target.
• .agents/plugins/marketplace.json makes the Codex plugin installable from this repo.
• AGENTS.md is the portable single-file protocol for any other LLM agent.

Query and research presets: