GitHub

What this does

Sync memories to a private GitHub repo as an Obsidian-compatible vault.

Requirements

• A GitHub account
• An OmegaVault account on Pro (monthly or Founding Member) — vault sync is not part of the Free plan
• Git and Obsidian on your computer, if you want to open the repository as a vault

Setup

1. Open Connectors. In the OmegaVault app, open Connectors and find the GitHub × Obsidian card under Sync to your vault.
2. Connect GitHub. Click Connect GitHub and approve the request on GitHub. OmegaVault asks for the repo scope so it can create a private repository and write to it.
3. Let OmegaVault create the repository. OmegaVault creates a new private repository named omegavault in your account (or omegavault-vault if that name is taken) and seeds it with a README, a minimal .obsidian config, and one folder per collection under Collections/. It never reuses a repository you already have.
4. Clone it. Back on the Connectors page the card now shows the repository and a git clone command. Copy it and run it wherever you want the vault to live.
5. Open it in Obsidian. In Obsidian choose Open folder as vault and pick the cloned folder. Install the community Obsidian Git plugin and enable auto pull, and new memories appear without a manual git pull.

Notes & caveats

Each memory is one Markdown file at Collections/<Collection>/<Title>.md, with frontmatter for omegavault_id, title, collection, category, tags, source_ai, created, and updated. Renaming a memory or moving it to another collection moves its file; deleting or archiving it removes the file.

OmegaVault only pushes to the repository — your vault in OmegaVault stays the source of truth. Disconnecting removes OmegaVault's access and leaves the repository exactly as it is.