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 β
- Download and open Obsidian (macOS, Windows, Linux, iOS, Android).
- Click Open folder as vault.
- Select this folder:
c:\Users\aalde\aldilaijankhobara-app\docs - 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:
- In Obsidian, open Settings (
Ctrl + ,/Cmd + ,). - Navigate to Community Plugins β Turn off Restricted Mode β Click Browse.
- Search for Obsidian Git and click Install, then Enable.
- 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
- Vault backup interval (minutes):
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
maintriggers GitHub Actions to rebuild and deploy the live web portal on Cloudflare Pages (docs.aldilaijan.com). - Visual Graph: In Obsidian, press
Ctrl + Gto view the knowledge graph connecting all architectural modules, regulations, and QA runbooks.
