a harbor for the things I love to build

AIOcean

Apps and tools I can't stop making, all docked in one place.

See what I've built

the collection

Things I couldn't stop building

vault-keeper

  • plugin
  • Claude Code
  • Markdown

A Claude Code plugin and CLI that checks every markdown note against the templates you wrote.

Visit project

A markdown vault starts with fifty notes and one tidy convention. Templates get copied and tweaked, AI assistants write notes with slightly different frontmatter, and six months later half the book notes say author and the other half say by. Queries built on those fields quietly miss half the data, and the cleanup pass never happens.

The idea behind vault-keeper is that a vault should enforce its own conventions. The rules live in the templates the owner already writes, not inside the tool, so it knows nothing about books, tasks or decisions. Change a template and every note that points at it is held to the new rules.

A broken note gets a red mark while it is being typed, fails CI before it merges, and is flagged in the loop where an AI assistant writes notes, so the assistant corrects itself. It suits any markdown folder, from an Obsidian vault to a repo of decision records. The live marks need Claude Code; the CLI needs only Node 18.

bunx -p claude-code-vault-keeper vault-keeper init my-vault
  • Queries tell the truthA query is only as good as the fields under it, so drift is caught before it hides notes. Each field can be required, limited to a list of values, matched to a pattern or kept between a minimum and a maximum.
  • Caught while typingA mistake is cheapest to fix in the line where it was made, not in a cleanup months later. The same check runs live in the editor and in CI, so a note that passes on your machine passes in the pipeline.
  • Assistants fix itNotes written by an assistant drift the same way hand-written ones do. Each problem comes back with its fix, such as the allowed values for a status, so the assistant repairs the note from the same message a person reads.
  • One folder at a timeAn existing vault does not have to be converted overnight. Rules apply only to the folders listed in the config, so one folder can turn green before the next one is added.

More from the harbor