llm-wiki

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

llm-wiki.net · @LLMWIKI on X · github.com/nvk/llm-wiki

LLM-compiled knowledge bases for any AI agent. Capture rough Ideas, research and shape them, then explicitly promote approved briefs into delivery Projects. Also includes parallel research, collector catalogs, session memory, source ingestion, compilation, audits, querying, and artifact generation. Ships for Claude Code, OpenAI Codex, OpenCode, and portable agents. Obsidian-compatible.

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

Changelog

v0.23.0 — Personal specialist framework. Adds optional user-owned, instruction-only SKILL.md review methods under the user's local wiki hub, explicit per-topic allowlists, deterministic validation and management, and research selection with version/hash provenance. The public release contains the framework only; personal specialist packages and wiki-derived candidate reports are not bundled or published.

v0.22.0 — Declarative private-adapter routing. Registered adapters may declare provider-neutral intent and exact-URL routes plus an adapter-owned workflow guide. The public plugin discovers the route before ingestion but no longer embeds any provider's authentication, browser, recovery, or editing workflow.

v0.21.3 — Adapter-boundary transition. Consolidates the v0.21 line and keeps the session-hook compatibility fix. Provider-specific workflow material from that line is superseded in current source by manifest-driven routing and lives only in the corresponding private adapter.

v0.20.0 — Governed remote writes. Extends private adapters with exact remote-resource allowlists, declared read/write effects, explicit approval bound to an exact plan hash, expected revisions, stable idempotency keys, private verified receipts, and content-free terminal reporting.

v0.19.0 — Private adapter protocol. Adds an explicitly trusted, machine-local adapter registry and portable llm-wiki-adapter/v1 JSON contract, with manifest handshakes, path scopes, sanitized environments, hash-verified artifacts, bundled management CLI, and an explicit workflow boundary that never passes a wiki destination or auto-promotes adapter output.

v0.18.0 — Hub-wide portfolio. Adds /wiki:portfolio, a live read-only view across active topic wikis that lists canonical Ideas and active Projects separately, distinguishes explicitly promoted Projects from direct ones, preserves Concepts as supporting knowledge, and avoids catch-all topics, duplicated records, inferred lineage, and stale portfolio caches.

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: