Skip to content

v0.1.0 — first public release

Latest
Latest

Choose a tag to compare

View all tags
@ashish-frozo ashish-frozo released this 30 Apr 03:48
· 40 commits to main since this release
v0.1.0
6010f67

First public release. vault-mem is a local-first, file-based shared memory layer for AI agents — one Obsidian-friendly markdown vault, multiple agents (Claude Code, Claude Desktop, Cursor, any MCP client), zero cloud dependency.

What's in 0.1.0

MCP server (packages/mcp/)

  • 5 MCP tools: memory_write, memory_read, memory_search, memory_promote, memory_context
  • 4 CLI subcommands: init, doctor, reindex, tail-audit
  • SQLite FTS5 keyword index + LanceDB vector index (via @xenova/transformers ONNX MiniLM, runs locally — no API keys)
  • Hybrid search via Reciprocal Rank Fusion (default mode for memory_search)
  • JSONL audit log with SHA-256-hashed search queries
  • Atomic writes (temp+fsync+rename), per-file advisory locks, stdio-only transport

Hygiene daemon (packages/keeper/, Python 3.12+)

  • Stateless python -m vault_mem_keeper run invocation; scheduled every 30 min via macOS launchd
  • 4 ops: triage (inbox→memory), auto-link (top-K semantic neighbors → _system/links.jsonl), confidence decay, archive (TTL + low-confidence)
  • --dry-run flag; status and doctor subcommands

Vault scaffolding

  • 7 memory types: decision, observation, todo, learning, summary, entity, question
  • JSON Schema (draft-07) frontmatter validation
  • Schema additivity rule: new fields must be optional
  • Sample memory + bundled markdown templates

Quality

  • 106 TypeScript tests + 46 Python tests, all passing
  • Typecheck clean (strict NodeNext ESM); ruff clean (Python)
  • macOS-tested. Linux likely works for the script (launchd plist is macOS-only — Linux/systemd unit welcome as PR). Windows untested.

Quick install

git clone https://github.com/frozo-ai/frozo-vault-mem.git
cd frozo-vault-mem
pnpm install
pnpm --filter @vault-mem/mcp build
node packages/mcp/bin/vault-mem-mcp init           # creates ~/vault-mem/
claude mcp add --scope user vault-mem \
  -e VAULT_MEM_PATH=\$HOME/vault-mem \
  -- node \$(pwd)/packages/mcp/bin/vault-mem-mcp

Full guide: docs/INSTALL.md

Roadmap

  • Phase 4 — Telegram approval gate for destructive ops (dedupe, merge, supersede)
  • Phase 5 — Sonnet-powered contradiction detection + summarization
  • Phase 6 — Polish (Dataview dashboards, optional Obsidian plugin)

See docs/origin/personal-use-prd.md §8 for the full PRD roadmap.

Origin

vault-mem began as a one-person weekend build to solve a concrete personal problem: too many AI agents, each with siloed memory, no shared context between sessions. It shipped as a personal tool, was used solo for the weeks before this release, and is now public for anyone who wants the same thing.

Assets 2
Loading