A personal wiki inspired by karpathy's llm-wiki idea

I recently built a personal wiki for myself: llm-wiki.

It is a implementation of karpathy's llm-wiki idea, with a few small tweaks for my own workflow.

This repo is how I organize and browse knowledge for myself. It also works well as a reference implementation for the pattern.

I like this idea a lot. Markdown is great for storing content. Git is great for preserving history. LLMs are great at organizing, linking, and synthesizing. Put them together and the repo slowly grows into something browsable, navigable, and maintainable.

The project is currently an Astro site, and the core structure is very simple:

articles/    # source materials
wiki/        # synthesized pages
raw/assets/  # local assets

articles/ stores source material. wiki/ stores synthesized knowledge pages. Pages are connected with Obsidian-style [[wikilinks]], and the site also generates backlinks. That gives the content a real graph structure. When I open one concept, I can keep jumping through related pages, which feels a lot like browsing a mini wiki that I maintain for myself. I prefer viewing it in the browser because it is easier for me to open, scan, and navigate there.

The homepage stays very direct. It shows Featured Concepts, Latest Sources, and Recent Activity. I like that density. One glance tells me what I have been reading, what I have been organizing, and which concepts are becoming central nodes.

How I use it

My workflow is straightforward:

  1. Drop articles, papers, long posts, or my own notes into articles/ Most of the time I use the Obsidian Web Clipper extension for this step.
  2. Use the repo's wiki-ingest skill in Codex CLI
  3. Let the agent update the related pages in wiki/, along with the index, log, and cross-links
  4. Push the changes and let the site update automatically

The dev commands are simple:

pnpm install
pnpm dev

This format feels great if you keep collecting material around a topic over time. In practice I mostly just add source material and trigger ingest. The rest of the wiki maintenance is all automatic.

Ref

https://github.com/zoubingwu/llm-wiki

https://wiki.zoubingwu.com/