A Karpathy-style LLM wiki your agents maintain (Markdown and Git)

I shipped a wiki layer for AI agents that uses markdown + git as the source of truth, with a bleve (BM25) + SQLite index on top. No vector or graph db yet.It runs locally in ~/.wuphf/wiki/ and you can git clone it out if you want to take your knowledge with you.The shape is the one Karpathy has been circling for a while: an LLM-native knowledge substrate that agents both read from and write into, so context compounds across sessions rather than getting re-pasted every morning. Most implementations of that idea land on Postgres, pgvector, Neo4j, Kafka, and a dashboard.I wanted to go back to the basics and see how far markdown + git could go before I added anything heavier.What it does: -> Each agent gets a private notebook at agents/{slug}/notebook/.md, plus access to a shared team wiki at team/.-> Draft-to-wiki promotion flow. Notebook entries are reviewed (agent or human) and promoted to the canonical wiki with a back-link. A small state machine drives expiry and auto-archive.-> Per-entity fact log: append-only JSONL at team/entities/{kind}-{slug}.facts.jsonl. A synthesis worker rebuilds the entity brief every N facts. Commits land under a distinct "Pam the Archivist" git identity so provenance is visible in git log.-> [[Wikilinks]] with broken-link detection rendered in red.-> Daily lint cron for contradictions, stale entries, and broken wikilinks.-> /lookup slash command plus an MCP tool for cited retrieval. A heuristic classifier routes short lookups to BM25 and narrative queries to a cited-answer loop.Substrate choices: Markdown for durability. The wiki outlives the runtime, and a user can walk away with every byte. Bleve for BM25. SQLite for structured metadata (facts, entities, edges, redirects, and supersedes). No vectors yet. The current benchmark (500 artifacts, 50 queries) clears 85% recall@20 on BM25 alone, which is the internal ship gate. sqlite-vec is the pre-committed fallba

Hacker NewsToolAISource
0Sign in to voteCopy link

FL score

72

out of 100

Verdict

VALIDATE

medium confidence

Competition

No competitor data yet

Trend

No signal yet

A Git+Markdown knowledge substrate for AI agents that compounds context across sessions without requiring heavy infrastructure.

The pain

AI agents lose institutional memory between sessions, forcing re-pasting of context. Teams building agent systems need durable, auditable knowledge layers but default to over-engineered stacks (Postgres+pgvector+Neo4j) that add operational burden and lock-in.

The gap

No lightweight, portable, Git-native knowledge system exists that lets agents both read and write to a canonical wiki while maintaining provenance, durability, and reasonable retrieval performance (85% recall@20 on BM25 alone is competitive).

Build angle

Ship as a pluggable layer for agent frameworks (LangChain, CrewAI, Claude MCP). Start with the CLI + Git integration as the moat. Monetize via hosted sync + team collaboration features later. The simplicity is the feature, users can fork their knowledge.

Strengths

  • Architectural clarity: Markdown+Git is durable, auditable, and portable, users own their data
  • Pragmatic tech choices: BM25+SQLite hits 85% recall without vectors; sqlite-vec is a clear upgrade path
  • Proven pattern: Karpathy's framing gives credibility; this is the 'boring' version that actually ships
  • Agent-native: Designed for read/write loops, not just retrieval, compounds value over time
  • Provenance: Git log + 'Pam the Archivist' identity makes reasoning auditable
  • Low operational overhead: Runs locally in ~/.wuphf/wiki/, no managed services required

Risks

  • Market timing: Vector DBs (Pinecone, Weaviate) are well-funded; positioning as 'simpler' is a niche play, not a wedge
  • Scaling questions: Git + SQLite work at 500 artifacts; unclear if this holds at 50k+ facts across teams. Merge conflicts on shared wiki could become painful
  • Adoption friction: Requires agents to be trained to write Markdown + Git semantics; not all frameworks support this well yet
  • Retrieval ceiling: 85% recall@20 is good for internal use but may not compete with vector-based systems for complex reasoning tasks
  • Competitive moat: The tech stack is simple enough that competitors can replicate quickly; moat is in UX/integrations, not IP
  • Team collaboration UX: Git workflows are powerful but unfamiliar to non-technical users; the 'promotion flow' and lint cron need to be bulletproof

Questions about this idea?

FlyBot reads the scoring and gives you a second opinion on “A Karpathy-style LLM wiki your agents maintain (Markdown and Git)”.

Open FlyBot