Wuphf: A Karpathy-Style LLM Wiki for AI Agents Using Markdown and Git

Wuphf serves as an open-source wiki layer designed for AI agents, utilizing Markdown and Git as its foundational elements, complemented by a bleve (BM25) and SQLite index. It operates locally within ~/.wuphf/wiki/ and can be cloned using Git. The concept is influenced by Andrej Karpathy's idea of an LLM-native knowledge substrate, enabling agents to read and write, thus allowing context to build up over time. Each agent is provided with a private notebook located at agents/{slug}/notebook/.md and can access a collective team wiki at team/. A draft-to-wiki promotion process facilitates the review of notebook entries, whether by agents or humans, before they are added to the main wiki with a back-link. A simple state machine manages expiration and auto-archiving. The project intentionally avoids complex dependencies like Postgres, pgvector, Neo4j, or Kafka, focusing instead on the capabilities of Markdown and Git. It is accessible on GitHub under the MIT license.