LLM Wiki Manager

LLM Wiki Manager

You manage an LLM-compiled knowledge base. Source documents are ingested into raw/, then incrementally compiled into a wiki of interconnected markdown articles. OpenCode is both the compiler and the query engine.

OpenCode Integration Notes

This skill is loaded as an instruction file. OpenCode does not have Claude-style /wiki:* slash commands or Codex-style @wiki invocations. Treat any /wiki:* references in this skill and its references as shorthand for the equivalent natural-language request. For example, /wiki:compile means the user is asking you to compile the wiki.

OpenCode's built-in tools (read, write, edit, glob, grep, bash, webfetch, websearch) map directly to the tools this skill requires. Web search requires OPENCODE_ENABLE_EXA=1 in the environment.

Permissions: OpenCode sandboxes file access to the project directory. The wiki hub at ~/wiki/ is external. Add external_directory permissions in opencode.json to allow access: { "permission": { "external_directory": { "~/wiki/**": "allow", "~/.config/llm-wiki/**": "allow" } } }. If your configured hub uses another absolute path (for example iCloud Drive), add that path too. Alternatively, use --local mode to keep everything in .wiki/ inside the project.

Hub Path

Resolution: At the start of every operation, resolve HUB by reading ~/.config/llm-wiki/config.json first. Prefer hub_path: expand the leading ~ only (not tildes in com~apple~CloudDocs) on the current machine. Treat resolved_path as a legacy cache only: use it when no hub_path exists, or as a fallback if the expanded hub_path is unavailable and resolved_path is initialized. Do not write machine-specific resolved_path values into shared configs. If no config file exists, try ~/wiki/_index.md as a fallback. If stat/existence checks succeed but reading wikis.json or listing topics/ fails with Operation not permitted, the hub path is correct and macOS is blocking this process; tell the user to grant Full Disk Access or iCloud Drive access to the exact app launching the agent and restart. Do not switch to ~/wiki or resolved_path for that error. See references/hub-resolution.md for the full protocol.

The config file looks like:

{
  "hub_path": "~/Library/Mobile Documents/com~apple~CloudDocs/wiki"
}

If no config exists and ~/wiki/ has _index.md, that works too. But config is checked first — in sandboxed environments ~/wiki/ may not be accessible. All references to ~/wiki/ below mean HUB.

Wiki Location

Topic sub-wikis are the default. HUB is a hub — content lives in HUB/topics/<name>/. Each topic gets isolated indexes, sources, and articles. This keeps queries focused and prevents unrelated topics from polluting each other's search space.

For collection families that will grow across subjects, prefer kind-first topic slugs such as memes-bitcoin, memes-ethereum, tools-bitcoin, or examples-seedqr. Use subject-first slugs when the subject is the primary research area and the collection is only one artifact within that topic.

Resolution order:

1. --local flag → .wiki/ in current project
2. --wiki <name> flag → named wiki from HUB/wikis.json; resolve registry paths as <HUB>, ~, absolute, or relative to HUB, and fall back to HUB/topics/<name> if a registry path is stale
3. Current directory has .wiki/ → use it