llmwiki

Inspired by Andrej Karpathy's llmwiki gist.

A personal knowledge base built and maintained by an AI agent (Claude Code). Drop source documents into raw/, then tell the agent to ingest, query, or lint. The agent owns everything under wiki/; you own everything under raw/.

How it works

The agent follows the operations defined in AGENTS.md:

• ingest <source>: summarize a raw document, create or update concept and entity pages, cross-link related pages, update the index.
• query <question>: answer a question from the wiki, optionally filing the answer as a new synthesis page.
• lint: find contradictions, orphan pages, missing cross-references, and low-confidence unsourced claims.

Directory layout

raw/            Source documents (immutable — drop files here)
raw/assets/     Images, PDFs, attachments
wiki/           Agent-maintained knowledge base
wiki/index.md   Catalog of all wiki pages
wiki/log.md     Append-only operation log
AGENTS.md       Agent instructions and page schema

Getting started

1. Clone this repo as your wiki template.

2. Add source documents to raw/.

3. Open Claude Code or the pi CLI and run:

   ingest <filename>
   

Page types

Type	Description
concept	An idea, technique, or term
entity	A person, model, paper, project, or organization
source	Summary of a raw document (src- prefix)
synthesis	Answer to a query, filed for future reference
comparison	Side-by-side analysis of two or more entities