Repository navigation
v0.1.0 — Karpathy Wiki for Codebases
pi-codebase-wiki v0.1.0
📖 Karpathy Wiki for codebases — auto-maintained knowledge base from git commits and code docs.
What It Does
Incrementally builds and maintains a structured, interlinked knowledge base from your codebase documentation and git commit history — compiled once, kept current, never re-derived.
Three-Layer Architecture
- Layer 1: Raw Sources — git log, source files, configs (immutable)
- Layer 2: The Wiki —
.codebase-wiki/directory of LLM-owned markdown pages - Layer 3: Schema —
.codebase-wiki/SCHEMA.md— the constitution for operations
Operations
- Ingest — read commits/files → create/update wiki pages → update INDEX → log it
- Query — search wiki pages → synthesize answers → file good answers back
- Lint — detect contradictions, orphans, stale pages, broken links, missing concepts
Tools (8)
wiki_ingest wiki_query wiki_lint wiki_status wiki_entity wiki_decision wiki_changelog wiki_evolve
Commands (6)
/wiki /wiki-init /wiki-ingest /wiki-lint /wiki-query /wiki-reindex
Storage
sql.js (WASM SQLite) for cross-runtime compatibility — works in both Bun and Node.js.
Tests
55 tests across unit/integration/e2e suites (147 assertions).