the-vault

Markdown in Git that Claude Code and Codex sessions in any of my repos can search and add to.

A session can ask it what we already know: last month's fix, a decision and its reason, how a tool behaves past its docs.

I read it in Obsidian, the agents through a search script. What a session learns lands in a raw folder, searchable at once. Nothing has to be filed first.

When a capture comes up a second time, a vault session can distill it into a wiki note and update the notes around it. Most never need that.

Some of the work has been taking automation out: the scheduled agents and the note suggestions went once I checked whether anything acted on them.

The format started from Karpathy's gist on personal AI context.

concept · 13
pattern · 13
method · 8
meta · 8
hover a node to highlight neighbours · drag to rearrange · click to opentap a node to open it · drag one to rearrange · drag the gaps to pan
STRUCTURE
429wiki371raw142archived notes
the-vault/
├── AGENTS.md       # the rules, for both harnesses
├── wiki/           # distilled notes
├── raw/            # captures, searchable as is
├── docs/           # open threads and decisions
├── coordination/   # notes between repos
├── handoffs/       # where the last session stopped
├── scripts/        # search, index, integrity checks
└── private/        # off-limits to other repos

markdown in git · read by Claude Code and Codex