Zenwiki

ZenWiki

[](https://github.com/ChenXplorer/zenwiki/actions/workflows/ci.yml) [](./LICENSE) [](https://www.python.org/downloads/) 

An implementation of Karpathy's LLM wiki idea — raw sources → agent-compiled wiki → Ask AI. Drop files into `raw/`, let an AI agent compile them into a structured, interlinked wiki.

ZenWiki does not call any LLM API. It provides deterministic tools (search, dedup, lint, index) that an external Agent (Claude Code or Codex CLI) uses to build and maintain the wiki.

Screenshots

Browse — sidebar tree, rendered markdown, frontmatter tags
Ask AI — hybrid retrieval + Agent synthesizes with citations
Crystallize — one-click save Q&A back into wiki/outputs/

How It Works

raw/ (your source files)
  │
  ▼
zenwiki serve  ──→  Agent CLI (claude / codex)
                      │
                      ├─ reads CLAUDE.md (schema + workflows)
                      ├─ reads source files from raw/
                      ├─ calls zenwiki tools (find-similar, rebuild-index, ...)
                      └─ writes structured pages to wiki/
                            │
                            ▼
                      wiki/ (browsable in Web UI, Obsidian, or Git)

Repository Layout

ZenWiki ships with two top-level directories:

• core/ — the program (Python package, web frontend). You only touch this if you're modifying ZenWiki itself.
• my-wiki/ — your content. Drop sources into my-wiki/raw/, the Agent compiles them into my-wiki/wiki/. Open my-wiki/ in Obsidian to rea