xheldon/vaultecho

VaultEcho is a bridge between automation tools and a note vault managed by Obsidian. It captures input from things like Coze, n8n, or Apple Shortcuts, turns that input into structured data, and writes it as Markdown files into a local vault that Obsidian keeps in sync in the background. The project itself does not try to understand or transcribe what you send it. That work is left to Coze or another automation platform. VaultEcho's job is narrower: take the structured result and write it into the right place in the vault, safely and in a way you can audit later. Before running VaultEcho, you need a local vault folder that is already being kept in sync by Obsidian's headless sync feature, a separate process running in the background. VaultEcho reads and writes Markdown files in that folder, but it does not manage the syncing itself, log into Obsidian, or handle your Obsidian account. It is meant to run alongside a sync process that someone else is responsible for. Setup is done through Docker Compose, and once running, a web based admin panel lets you configure things like where notes go, daily note formatting rules, time zone handling, and file size limits. The admin interface protects itself with basic authentication so it is not left open by accident. Beyond simple capture, VaultEcho also builds a searchable index of your notes using an external embedding API, which turns text into a form a computer can compare for similarity. This lets it support semantic recall, meaning it can find notes related to a topic even if they do not share exact words. It can also run scheduled AI review tasks, such as weekly or monthly summaries, that read through recent notes and write a summary back into the vault on a schedule you define. The project is designed to run cheaply, on a small low powered server, without needing a local AI model or a dedicated database.