Skip to content

README.md

Latest commit

 

History

History
45 lines (32 loc) · 1.05 KB

README.md

File metadata and controls

45 lines (32 loc) · 1.05 KB

Syncyphus

Obsidian vault to HelixDB sync tool.

What it does

Parses an Obsidian vault (Markdown files with wikilinks and tags), generates Gemini embeddings for semantic search, and syncs notes as HelixDB nodes with LinksTo edges.

Setup

  1. Start HelixDB

    helix push dev

  2. Configure API key (for embeddings, optional)

    # Edit .env and add your key
GEMINI_API_KEY=your-gemini-key

  3. Sync your vault

    ./syncyphus sync path/to/vault

How it uses HelixDB

  • Note node - Stores vault note with path, title, content, tags, and embedding vector
  • LinksTo edge - Creates directed edges between notes based on wikilinks [[note]]
  • Queries - Custom HQL queries for CRUD operations and semantic search via vector similarity

Commands

  • sync <vault> - Full sync (diff-based updates)
  • watch <vault> - File watcher for live sync

Example

./syncyphus sync test-vault/
# Found 87 notes in vault
# Adding link: README -> Ingredients/
# Sync completed successfully