Back to browse
GitHub Repository

Zero-cost Obsidian vault sync across iPhone, Mac, and GitHub.

24 starsShell

Cc-md – Zero-cost Obsidian sync across iPhone, Mac, and GitHub

by YuukiJyoudai·Feb 21, 2026·8 points·4 comments

AI Analysis

●●●●GemZero to OneBig BrainNiche Gem

400-line bash replaces $48/year Obsidian Sync; AI-native plain markdown beats proprietary APIs entirely.

Strengths
  • Genuinely novel insight: plain markdown files are more AI-accessible than any API—Claude Code reads/writes directly
  • Ultra-low friction: one-line installer auto-discovers vault, inits git, creates GitHub repo, starts syncing
  • Solves a real pricing/UX gap in the Obsidian ecosystem while doubling down on file-based simplicity
Weaknesses
  • macOS/iCloud only—Windows users relegated to obsidian-git workaround; cross-platform support would unlock broader appeal
Category
Target Audience

Obsidian users on macOS with iPhones who want local-first sync without subscription, AI tool builders integrating with markdown vaults

Similar To

Obsidian Sync · Syncthing · Logseq

Post Description

Here's something I realized: the most AI-native knowledge base isn't a SaaS product with an API. It's a folder of markdown files on your disk.

Obsidian stores everything as plain .md files. That means Claude Code (or any AI tool) can grep, read, write, and traverse your entire knowledge base with zero setup. No API keys. No OAuth. No middleware. Just local file I/O.

The only missing piece was sync. I wanted my vault on iPhone (iCloud), on Mac (local), and on GitHub (backup + version history) — without paying $4/mo for Obsidian Sync.

cc-md is ~400 lines of bash. iCloud handles Apple device sync in seconds. A launchd job runs git add/commit/push every 5 minutes. That's it.

One command to install:

bash <(curl -sL https://raw.githubusercontent.com/yuukiLike/cc-md/main/insta...)

The installer auto-discovers your vault, inits git, creates a GitHub repo (if you have gh CLI), and starts syncing. Zero prompts in the best case.

I built this in a weekend, solo, with AI assistance from first line to last. A year ago I couldn't have shipped this. Now I can.

I feel genuinely lucky to be alive in the AI era. It's making childhood dreams come true — one project at a time.

Similar Projects