​

Obsidian CORE Sync Plugin

Sync your Obsidian notes with CORE (Contextual Observation & Recall Engine) and get memory-aware answers directly inside Obsidian.

​

✨ What it does

• Sync Notes: Push selected notes (or entire vault sections) into CORE as Episodes.
• Right-Side Panel: Opens a dedicated panel in Obsidian that sends the current note’s content to CORE and shows relevant results, links, or summaries.
• Frontmatter Control: Decide which notes to sync by adding simple YAML flags.
• Offline Safe: Failed syncs are queued locally and retried automatically.

​

🚀 Installation

​

Local development

1. Download the latest release assets from core-obsidian v0.1.0 and extract them into your Obsidian vault under .obsidian/plugins/obsidian-core-sync/:
   • Ensure the directory contains main.js, style.css, and manifest.json.
2. Enable the plugin in Obsidian:
   • Go to Settings → Community plugins
   • Find “CORE Sync” and toggle it on

​

Community Installation

Note: A pull request for community installation is pending approval. You can track its progress here.

​

⚙️ Configuration

​

Step 1: Get Your API Key

1. Login to CORE dashboard at core.heysol.ai
2. Navigate to Settings (bottom left)
3. Go to API Key → Generate new key → Name it “obsidian”
4. Copy the generated API key

​

Step 2: Configure Plugin Settings

1. In Obsidian, go to Settings → CORE Sync
2. Configure the following:
   • CORE Endpoint: Your CORE ingest/search API (default: https://core.heysol.ai)
   • API Key: Paste the API key from Step 1
   • Auto-sync on modify: If enabled, every note edit will sync automatically

​

🛠️ Usage

​

Mark Notes for Sync

---
core.sync: true
---

​

Manual Sync Commands

• “Sync current note to CORE” - Sync the currently open note
• “Sync all notes with core.sync=true” - Sync all notes marked for synchronization

​

CORE Panel

1. Open the CORE Panel by running “Open CORE Panel” from the command palette
2. This opens a new tab on the right side of Obsidian
3. When you open or edit a note, the plugin will automatically:
   • Send the note’s content to CORE
   • Display relevant memories, links, and summaries
   • Show related notes from your vault

​

🎯 Features

​

Smart Sync

• Incremental Updates: Only syncs changed content to avoid duplicates
• Conflict Resolution: Handles simultaneous edits gracefully
• Queue Management: Failed syncs are queued and retried automatically

​

Context-Aware Panel

• Related Memories: Shows relevant content from your CORE memory
• Cross-References: Links to related notes in your vault
• AI Summaries: Get AI-generated summaries of your note’s context

​

💡 Use Cases

​

Research & Knowledge Management

• Automatically sync research notes to build a searchable knowledge base
• Get contextual suggestions while writing based on your existing notes
• Cross-reference information across different projects and topics

​

Meeting & Project Notes

• Sync meeting notes with core.tags: ["meetings", "project-name"]
• Access relevant context from previous meetings when taking new notes
• Build project timelines and track decisions over time

​

Personal Knowledge System

• Create a personal Wikipedia from your notes
• Get AI-powered insights on connections between ideas
• Build upon previous thoughts and research automatically

​

🛠️ Troubleshooting

​

Common Issues

• Verify the key is correctly copied from CORE dashboard
• Check that the API key has proper permissions
• Try regenerating the key if issues persist

• Ensure core.sync: true is in the frontmatter
• Check internet connection
• Look for error messages in Developer Console (Ctrl+Shift+I)

• Restart Obsidian
• Check that the API endpoint is correct
• Verify CORE service is accessible

​

🤝 Support

• GitHub Issues: Report bugs and feature requests
• Discord Community: Join our Discord and ask questions in #core-support
• Documentation: Visit core.heysol.ai for more resources