LLM Wiki

A persistent, compounding knowledge base built and maintained by LLMs.

Inspired by Andrej Karpathy's LLM Wiki pattern. Instead of re-deriving knowledge from scratch on every query (like RAG), the LLM incrementally builds a structured, interlinked wiki — summarizing sources, cross-referencing entities, and maintaining consistency over time.

Features

• Incremental knowledge building — each source enriches the entire wiki, not just one page
• Obsidian-compatible — [[wikilinks]], YAML frontmatter, graph view, backlinks
• Four core operations — Ingest (add sources), Query (ask questions), Lint (health check), Auto-capture (passive)
• Global + project wikis — personal knowledge base with per-project extensions
• OMC compatible — 2-tier mode with oh-my-claudecode: OMC wiki (project) → global wiki (distillation)
• Cross-platform — works with Claude Code (CLAUDE.md), Codex, Gemini CLI (AGENTS.md)
• Git-managed — full version history, branching, multi-device sync

Architecture

wiki/
├── CLAUDE.md / AGENTS.md     # Wiki schema (LLM instructions)
├── index.template.md         # Index template (tracked)
├── log.template.md           # Log template (tracked)
├── setup.sh                  # One-click setup script
├── setup/
│   └── wiki.md               # Global agent rule (installed by setup.sh)
├── raw/                      # Immutable source documents (.gitignored)
│   └── assets/               # Images, PDFs
├── entities/                 # People, organizations, tools
├── concepts/                 # Ideas, techniques, patterns
├── sources/                  # Source summaries
└── synthesis/                # Comparisons, analyses

# After setup.sh, these local-only files are created (.gitignored):
# ├── index.md                # Content catalog
# └── log.md                  # Chronological operations log

Quick Start

Global Wiki (personal knowledge base)

git clone https://github.com/ingeun92/ing-wiki.git ~/wiki
cd ~/wiki
./setup.sh

Project Wiki (per-project knowledge base)

cd my-project
git clone https://github.com/ingeun92/ing-wiki.git ./wiki
cd wiki
./setup.sh

Note: If the global wiki is already set up, you can skip setup.sh and just tell your LLM agent "Create a wiki for this project" — it will scaffold the wiki/ directory from the schema automatically. See Project Wiki Setup for details.

What setup.sh does

1. Create index.md and log.md from templates
2. Detect environment and inject ## Wiki section into ~/.claude/CLAUDE.md:
   • OMC detected → 2-tier config (OMC wiki → global wiki auto-distillation)
   • No OMC → standard config (direct global wiki with routing)
3. Install the global agent rule (setup/wiki.md → ~/.claude/rules/wiki.md)

Then open the wiki directory as an Obsidian vault.

Manual setup (without script)

git clone https://github.com/ingeun92/ing-wiki.git ~/wiki  # or ./wiki for project
cd ~/wiki
cp index.template.md index.md
cp log.template.md log.md

# Claude Code
mkdir -p ~/.claude/rules
cp setup/wiki.md ~/.claude/rules/wiki.md

Pulling Template Updates

Wiki content (entities/, concepts/, sources/, synthesis/, index.md, log.md) is gitignored — it stays local and is never pushed to the remote:

git pull origin main        # template files update, your data is untouched
./setup.sh                  # re-run to pick up any new rule changes

Usage

The wiki supports both explicit commands and auto-capture:

# Explicit
"Ingest this article into the wiki"        → creates source summary + updates related pages
"What does the wiki say about X?"           → searches index, reads pages, synthesizes answer
"Run a wiki lint"                           → checks for contradictions, orphans, stale content

# Auto-capture (via global rule)
# During any conversation, the agent proactively suggests saving
# valuable knowledge to the wiki — no manual command needed.

Project Wiki Setup

From any project directory, tell your LLM agent:

"Create a wiki for this project"

This scaffolds a wiki/ directory inside your project:

my-project/
├── CLAUDE.md          ← wiki reference added here
├── AGENTS.md          ← same content (cross-platform)
└── wiki/
    ├── CLAUDE.md      ← project wiki schema
    ├── AGENTS.md      ← symlink → CLAUDE.md
    ├── index.md
    ├── log.md
    ├── raw/
    ├── entities/
    ├── concepts/
    ├── sources/
    └── synthesis/

Usage (Project)

"Add this to the wiki"                      → saves to project wiki (default when it exists)
"Add this to the global wiki"               → saves to ~/wiki/ explicitly
"Promote this to the global wiki"           → copies project wiki page → global wiki
"Import X from the global wiki"             → brings global knowledge into project context

Cross-Wiki Operations

Operation	Direction	Description
Promote	Project → Global	Elevate project-specific knowledge to the global wiki
Import	Global → Project	Bring global knowledge into project context
Query	Either	Search and synthesize from either wiki

OMC Integration (oh-my-claudecode)

If you use oh-my-claudecode, the wiki operates in 2-tier mode:

Session work → OMC wiki (.omc/wiki/)    Auto-capture, MCP tools, fast writes
                    ↓ auto-distill (session end)
Long-term   → Global wiki (~/wiki/)     Obsidian, structured taxonomy, permanent

• Auto-capture: saves to OMC wiki without confirmation (architecture, patterns, findings)
• Auto-distill: on session end, promotes valuable pages (architecture/decision/pattern) to global wiki
• Routing: "add to wiki" → OMC wiki | "global wiki" → ~/wiki/ | "promote" → OMC → global

setup.sh auto-detects OMC (via OMC:START marker in ~/.claude/CLAUDE.md) and injects the appropriate config.

Page Format

Every wiki page uses YAML frontmatter + Obsidian-compatible markdown:

---
title: React Server Components
type: concept
tags: [react, frontend, architecture]
sources: ["[[sources/dan-abramov-rsc-talk]]"]
created: 2026-04-06
updated: 2026-04-06
---

# React Server Components

Content with [[wikilinks]] to related pages...

Page types: entity, concept, source, synthesis

Obsidian Integration

Open ~/wiki/ (or project/wiki/) as an Obsidian vault:

• Graph View — visualize connections between pages
• Backlinks — see which pages link to the current page
• Dataview — dynamic queries on frontmatter metadata
• Web Clipper — save browser articles as markdown sources

Multi-Device Sync

This repo is a template — wiki content is gitignored and stays local. To sync your wiki data across devices, use a separate mechanism:

• Obsidian Sync — built-in Obsidian syncing
• Syncthing / rsync — sync the content directories directly
• Separate private repo — track your data in a private repo alongside the template

License

MIT