Vault Change Feed — let your AI agents see what you changed, without rescanning your vault

Disclaimer

Is this project open source? Yes
Is this project completely free? Yes
Is this project vibe-coded beyond the author’s ability to comprehend how it works? No
Community Directory: Vault Change Feed - Obsidian Plugin

If you let AI coding agents (Claude Code, Codex, Cursor, Kimi Code…) manage your Obsidian vault, you’ve hit this: the AI has no idea what you edited between sessions. Rescanning the whole vault every time is expensive; not scanning means it works from stale knowledge.

Vault Change Feed fixes this with a simple mechanism: it records every change in your vault — create / modify / delete / rename, with line-diff stats — as a machine-readable JSONL feed, and keeps an independent read cursor per AI reader. Before the AI touches your notes, it reads the feed once and knows exactly what changed since its last visit.

  • Works out of the box: on first run it auto-installs a small reading-protocol block into your vault’s AGENTS.md / CLAUDE.md / GEMINI.md, so agents discover the feed by themselves

  • Offline-safe: startup reconciliation backfills changes made while Obsidian was closed (mobile, iCloud, CLI edits), with rename detection

  • Read-side merging: edit bursts on one file collapse into a single cumulative line

  • Multi-instance standby protection for synced vaults, log rotation with a stale signal

  • Fully local: no network, no telemetry. Desktop + mobile

There’s also an optional SessionStart hook script that injects unread changes into your agent’s context automatically — no “please remember to read the file” required.

It’s my first community plugin — feedback and issues very welcome.

Links: Community listing · GitHub