Obsidian Stats logoObsidian Stats

Vault Change Feed

by kains
5
4
3
2
1
Score: 41/100
Install Code

Description

Reviews

No reviews yet.

Stats

0
stars
184
downloads
0
forks
89
days
42
days
45
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
2
total issues
1
open issues
1
closed issues
68
commits

Latest Version

2.0.0
2 months ago

Changelog

2.0.0

  • 每台设备拥有自己独立的日志
  • 事件现在会携带设备信息，并按跨设备排序、去重
  • 两台设备记录同一物理编辑时，只保留最早一条
  • 多台设备可以并行编辑同一个库，不会出现序列冲突，也无需选择单一写入设备
  • 旧版日志会自动迁移到新日志（无向后兼容，迁移前自动备份）
  • 修复了多台同步设备写入共享日志时出现的重复序列、重复事件等根本问题
See all version on GitHub

README file from

Github

Vault Change Feed

Give your AI agents a changelog of your vault. Every manual edit you make is recorded — so an AI can see what changed since its last visit, without rescanning your whole vault.

GitHub release License: MIT Downloads

中文文档 · Obsidian Community Listing

Support / 支持

如果这个插件帮你省了时间，可以请我喝杯咖啡 ☕ — Buy Me a Coffee · 国内 爱发电

What it does

  • Every edit is recorded — create / modify / delete / rename, with line counts, on your phone and desktop alike
  • Made for multi-device vaults — each device keeps its own log, so phone and computer can edit the same vault at the same time without conflicts
  • Clean history — the same edit recorded by two devices is shown only once
  • Built for AI agents — each agent has its own cursor and reads only what's new, so AI work costs less context
  • Zero setup for agents — the read protocol is auto-installed into AGENTS.md / CLAUDE.md on first run
  • Human-friendly tools — status-bar activity light, quick menu, recent-changes browser, pause, health check
  • Fully local — no network, no telemetry. Everything stays in your vault.

Installation

Community market (recommended): Settings → Community plugins → Browse → search Vault Change Feed → Install → Enable.

BRAT: add kains2866/vault-change-feed.

Manual: copy main.js, manifest.json (and styles.css) from the latest release into <vault>/.obsidian/plugins/vault-change-feed/, then enable.

Quick use

  • Status bar shows VCF (light glows after changes). Click it for quick actions: recent changes, health check, pause/resume, copy unread for an AI.
  • Commands: Copy unread changes for AI · Browse recent changes · Check feed health · Pause/Resume recording · install/remove the AI protocol.
  • Settings are short: what to track, exclusion rules, size/retention limits, and whether to install the AI protocol.

For AI agents

The plugin installs a short reading protocol into your vault's AGENTS.md / CLAUDE.md on first enable. Agents follow it to fetch only their unread changes (each agent keeps its own cursor; a content-hash de-duplicates the same edit recorded by two devices). An optional SessionStart hook (extras/vault-feed-hook.mjs) injects those changes automatically. Data files live under <configDir>/plugins/vault-change-feed/ (events/, cursors/, …).

Compatibility notes

  • Works on desktop and mobile; all file I/O goes through Obsidian's official API.
  • Cloud-synced vaults (iCloud / Syncthing / Dropbox / OneDrive / git) are safe to use on several devices at once.
  • Windows isn't smoke-tested yet — please report any issue you hit.
  • v2 data layout is not compatible with 1.x; old logs are migrated automatically with a backup on first run after upgrading.

Privacy

Fully local: no network calls, no uploads, no data collection.

Development

npm install
npm run build
npm test

License

MIT © tiyukains

Sponsors