Skip to content

Obsidian Setup & Cloud Sync Guide ​

This repository's docs/ folder is designed to work natively as an Obsidian Vault while staying 100% synchronized with GitHub and the live Cloudflare Pages documentation website.


1. Opening the Docs in Obsidian ​

  1. Download and open Obsidian (macOS, Windows, Linux, iOS, Android).
  2. Click Open folder as vault.
  3. Select this folder:
    c:\Users\aalde\aldilaijankhobara-app\docs
  4. You now have full visual access to all documentation, including Markdown previews, LaTeX formulas, Mermaid diagrams, and the interactive Graph View.

2. Automated Free Cloud Sync via GitHub ​

Because this repository is hosted on GitHub, you can use the Obsidian Git community plugin to synchronize notes across devices for free:

  1. In Obsidian, open Settings (Ctrl + , / Cmd + ,).
  2. Navigate to Community Plugins β†’ Turn off Restricted Mode β†’ Click Browse.
  3. Search for Obsidian Git and click Install, then Enable.
  4. Configure these recommended settings:
    • Vault backup interval (minutes): 10
    • Auto-pull interval (minutes): 10
    • Commit message: docs: auto-update from Obsidian
    • Push on backup: On

3. How AI Agents & Obsidian Work Together ​

  • Zero Sync Drift: When AI coding agents (Antigravity, Cursor, Claude) update specifications (e.g. docs/AI_AGENT_MASTER_PLAN.md), the changes are committed directly to Git.
  • Instant Live Portal: Every commit pushed to main triggers GitHub Actions to rebuild and deploy the live web portal on Cloudflare Pages (docs.aldilaijan.com).
  • Visual Graph: In Obsidian, press Ctrl + G to view the knowledge graph connecting all architectural modules, regulations, and QA runbooks.

Aldilaijan & Khobara Real Estate Platform