Built on my own time
Aetherkeep
An MCP server and a git-backed vault that give AI agents a memory across sessions.
Loading the graph
The 482 notes that link to each other, and the 1,311 links between them, drawn from the vault's own links. Titles are left out: the vault is private.
- notes in the vault
- 1,895
- links between notes
- 1,311
- commits
- 3,364
- days with commits
- 119
It started with an article on living files: a vault the AI reads, writes and links, so its notes build up over time.
From March to August, hooks enforced it in every session: instructions loaded at the start, save reminders that grew firmer as the session went on, and a check before the session closed. Since then I pull memory in through the MCP server when a task needs it.
- Git-backed Obsidian vault
- MCP server
- Synced PC ↔ GitHub ↔ VPS
A session, enforced
From March to August, hooks ran at five points in every AI session, whether or not the model remembered to. Since then I pull memory in when a task needs it.
- 1
Session starts
Instructions and core context go in first, in a fixed order, about 500 tokens. Anything deeper is pulled through the MCP server when it is needed.
- 2
Every prompt
A reminder to save, which gets firmer the longer the session runs.
- 3
Every write
The note's structure is checked, and the change is committed to git in the background.
- 4
Compaction
State is marked before the context is compressed, and the core context goes in again afterwards.
- 5
Session ends
A check asked for working memory to be updated and cleaned up before the session closed.
One memory, three places
The vault lives in git. My PC, GitHub and the VPS where Rune runs hold the same copy, and every agent reaches it through the same MCP server.
My PC
Claude Code in my editor
GitHub
The vault's origin
VPS
Where Rune runs
MCP server
TypeScript, SQLite and sqlite-vec. Semantic search, graph traversal and context routing, offered to any agent as nine tools.
- aetherkeep_orient
- aetherkeep_context
- aetherkeep_search
- aetherkeep_search_by_tag
- aetherkeep_get
- aetherkeep_create
- aetherkeep_write
- aetherkeep_relate
- aetherkeep_status
In use since February
3,364 commits on 119 days. Most are automatic saves made by the hooks.Busiest day: 11 May, with 196 commits.