Skip to content

v0.1.0 — Karpathy Wiki for Codebases

Choose a tag to compare

@Moikapy Moikapy released this 12 Apr 23:20
· 50 commits to main since this release

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).