README file from
GithubOmegaVault Sync (Obsidian plugin)
Pulls your OmegaVault memories into an Obsidian vault as frontmattered markdown. One-way for v1: OmegaVault is the source of truth, so edits made here are overwritten on the next pull.
How it works
The plugin polls GET /api/connectors/obsidian/pull?since=<cursor> with your API
token as a bearer credential. Each changed memory comes back as a ready-to-write
.md file (frontmatter + body); deletions come back as tombstones. Files are keyed
by omegavault_id, so title changes rename the file and deletions remove it.
Each note looks like:
---
omegavault_id: "665f…"
title: "Interstellar"
collection: "Movies to Watch"
category: "Movies"
tags: ["sci-fi", "movie"]
source_ai: "chatgpt"
created: "2026-07-01T12:00:00.000Z"
updated: "2026-07-01T12:00:00.000Z"
---
Recommended sci-fi film to watch.
Install (developer / BRAT)
- Build the plugin:
npm install npm run build # emits main.js - Copy
manifest.json,main.js(andstyles.cssif present) into<your-vault>/.obsidian/plugins/omegavault-sync/. - Enable OmegaVault Sync in Obsidian → Settings → Community plugins.
- Or install via BRAT by pointing it at this repo.
Configure
In Obsidian → Settings → OmegaVault Sync:
- Server URL — your OmegaVault instance (usually
https://app.omegavault.app). - API token — create one in OmegaVault → Settings → API tokens (
ovk_…). - Vault folder — where notes are written (default
OmegaVault). - Poll interval — minutes between automatic pulls (default
5).
Use Sync now to pull immediately, or Full resync to reset the cursor and re-pull everything.