iOS App — Version 1.0

Sync.md

Real Git on your iPhone. Clone, pull, commit & push any repo. No terminal, no sync layer, no lock-in. Your files, version controlled.

App Store View Source

Sync.md home screen showing cloned repos

libgit2 engine GitHub OAuth Personal Access Tokens iOS Files integration Obsidian x-callback-url Multi-repo management Branch & commit tracking Zero cloud dependency libgit2 engine GitHub OAuth Personal Access Tokens iOS Files integration Obsidian x-callback-url Multi-repo management Branch & commit tracking Zero cloud dependency

001 — Capabilities

Everything you need.
Nothing you don't.

Real Git

Powered by libgit2. Actual .git directories, real commit history, real branches. Any repo, any language — the genuine protocol.

GitHub Native

Files App

Cloned repos appear in the iOS Files provider. Browse, edit, and manage your files with any app that reads Files.

Push & Pull

Full upstream workflow. Pull remote changes, stage edits, write a commit message, push. Works with any repository.

Multi-Repo

Projects, dotfiles, notes, configs — manage them all. Each repo has its own branch, author identity, and sync state.

x-callback-url

Obsidian Git plugin calls syncmd://x-callback-url/sync to pull and push without leaving Obsidian. Programmable from any app that speaks URLs.

Sync.md repo view with pull, commit & push

002 — Workflow

Clone to push
in four steps.

Authenticate

Clone

Browse your repos, tap to clone. Any repository downloads to your device with its complete Git history.

Edit

Open files in any iOS app. Code, notes, configs — the filesystem is yours to edit however you want.

Sync

Pull changes, commit your edits, push upstream. Full version control from your pocket.

003 — Integrations

Works with everything.

x-callback-url

Obsidian

The Obsidian Git plugin calls syncmd://x-callback-url/sync to pull and push without leaving the app. Implementation guide →

Files App

iOS Files

Every cloned repo appears in the iOS file provider. Browse, edit, and manage with any app that reads Files.

Any App

Your Tools

Code editors, markdown apps, text tools — if it can open a file on iOS, it works with your cloned repos.

004 — Automation

Implement x-callback-url in minutes.

Quick start URL

Any app can trigger a full pull + push by opening this URL:

syncmd://x-callback-url/sync?repo=MyVault

The repo value must match the vault folder name shown in Sync.md.

Supported actions

/pull — fetch + fast-forward from remote
/push — stage all, commit, and push
/sync — pull then push (recommended)
/status — read branch/SHA/change count

Optional callback parameters

Add these for full x-callback-url flow control:

message — commit message for push/sync
x-success — URL opened after success
x-error — URL opened after failure

Obsidian implementation

In the Obsidian Git community plugin, set your mobile sync URL to:

syncmd://x-callback-url/sync?repo=MyVault&message=Update%20from%20Obsidian

See the complete iOS setup guide →

005 — Technical

Under the hood.

Git Engine

libgit2 (native C, no shell)

Framework

SwiftUI

Authentication

GitHub OAuth + PAT

Token Storage

iOS Keychain (encrypted)

File Access

iOS File Provider

Automation

x-callback-url (syncmd://)

Cloud Dependency

None — device to GitHub direct

Data Collection

Name + email (Git author only)

Platforms

iPhone · iPad

Price

006 — Blog

Guides & updates.

Guide February 15, 2026

Using Sync.md with Obsidian Git on iOS

How to set up real Git-backed vault syncing on your iPhone using Sync.md and the Obsidian Git community plugin — no Obsidian Sync subscription, no iCloud conflicts, no compromises.

Read article

007 — Get Started

Your notes.
Version controlled.

$5 on the App Store. Open source on GitHub.

App Store Source Code