How gd4ai/obsidian-llm-wiki works
Karpathy LLM Wiki is an Obsidian plugin that turns vault notes and documents into a linked wiki, then answers conversational questions over that wiki without embeddings. Its primary workflow is user-triggered ingest, source analysis and page generation, followed by graph-based retrieval and an LLM response. Lint/repair, schema management, PDF conversion, settings, and provider authentication are substantial companion capabilities. Edges reflect the sampled calls and the documented retrieval design; unsampled links are omitted where ownership is not established.
Main entry points: wiki-engine.ts Wiki engine · QueryView-class.ts Query view · main.ts Plugin commands · create-llm-client.ts Provider factory
Components 24
Obsidian Plugin
- Plugin commands
src/main.ts - Ingest commands
src/main-commands/ingest-commands.ts - Plugin settings
src/ui/settings.ts - History and reports
src/ui/history-modal/index.ts
Wiki Creation
- Wiki engine
src/wiki/wiki-engine.ts - Source analysis
src/wiki/source-analyzer.ts - Document conversion
src/core/pdf-converter.ts - Page generation
src/wiki/page-factory/index.ts - Wiki schema
src/schema/schema-manager.ts - Wiki index
src/wiki/engine-internals/index-generator.ts
Graph Retrieval
- Query view
src/wiki/query-engine/QueryView-class.ts - PPR seed selection
src/wiki/query-engine/pipeline/select-seeds.ts - Relevant pages
src/wiki/query-engine/pipeline/load-pages.ts - Context assembly
src/wiki/query-engine/pipeline/assemble-context.ts - LLM answer
src/wiki/query-engine/QueryView-class.ts
LLM Providers
- Client factory
src/core/create-plugin-llm-client.ts - Task settings
src/llm-client-wrapper.ts - Provider factory
src/llm-sdk/create-llm-client.ts - Codex authentication
src/llm-sdk/openai-codex/auth-manager.ts
Wiki Maintenance
- Lint and repair
src/wiki/lint/controller.ts - Contradiction checks
src/wiki/contradictions.ts
Other components
- Vault user
- Obsidian vault
- LLM providers
Connections 25
- Vault user → Plugin commands: invokes
- Plugin commands → Ingest commands: dispatches
- Ingest commands → Wiki engine: starts ingest
- Wiki engine → Source analysis: analyzes source
- Wiki engine → Document conversion: converts documents
- Wiki engine → Page generation: generates pages
- Wiki engine → Wiki schema: uses schema
- Wiki engine → Wiki index: generates index
- Wiki engine → Obsidian vault: reads and writes
- Vault user → Query view: asks question
- Query view → PPR seed selection: selects seeds
- Query view → Relevant pages: loads pages
- Query view → Context assembly: assembles context
- Query view → Client factory: requests answer
- Query view → Obsidian vault: reads wiki
- Vault user → Lint and repair: runs maintenance
- Lint and repair → Contradiction checks: checks contradictions
- Lint and repair → Obsidian vault: repairs pages
- Plugin commands → Client factory: creates client
- Client factory → Task settings: wraps client
- Task settings → Provider factory: creates provider client
- Provider factory → LLM providers: sends model requests
- Provider factory → Codex authentication: uses Codex auth
- Vault user → Plugin settings: configures
- Vault user → History and reports: views reports