Vault

An agent-maintained notes vault, as a plugin. Vault sets up and tends the notes folder your agents already read: guided setup, Apple Notes import, scheduled inbox sweeps that keep project and people notes current, and durable knowledge that stays dated, source-backed, and reviewable.

Plain Markdown files are the only source of truth. Works with Claude Code today; Codex dist coming (V1). Optional capture HUD (meeting recording, local transcription) comes later and plugs into the same files.

Install

git clone https://github.com/conmeara/vault && cd vault && ./install.sh

The installer links the skill into Claude Code (~/.claude/skills/vault) and puts the CLIs on your PATH. Or add the repo as a local plugin from Claude Code's plugin settings (.claude-plugin/plugin.json is at the repo root).

Use

/vault init       set up a new vault, or upgrade an existing notes folder
/vault import     bring in Apple Notes / Notion / Bear / Evernote / folders
/vault sweep      process the inbox (also what scheduled routines run)
/vault dream      weekly consolidation: stage durable memory for your review
/vault lint       challenge the notes: contradictions, stale claims, orphans
/vault file|distill|task|ask ...

Two CLIs run anywhere inside a vault, zero tokens:

• vault-doctor — structure, broken wikilinks, frontmatter sanity, index drift, inbox aging, stale entity notes. --mark-run / --changed give sweeps a cheap changed-since-last-run scope.
• vault-index — rebuild index.md from the durable notes, preserving your hand-edited descriptions. --check reports drift.

Layout

skills/vault/
  SKILL.md            router: /vault <verb>
  vocabulary.md       the verbs, each with one operational meaning
  schema.md           frontmatter, dated claims, observation bullets, log format
  VAULT.md.template   personalized per-vault contract, written by init
  workflows/          init · import · sweep · dream · lint
cli/                  vault-doctor · vault-index — python3 stdlib only
install.sh            links the skill + CLIs

MIT licensed.

Design notes live in the build plan and product spec (see the project's vision.md and docs). The short version: contract + CLI is the system; harness dists are comfort; plain files are the only truth.