Independent files. Anywhere.

REAL GIT.
IN YOUR
POCKET.

Your Obsidian vault. Your code. Your next idea.
Create a repo from local files or clone an existing one. Edit, commit, and push from your iPhone or iPad.

Download GitSync.md on the App Store Get GitSync.md on Google Play
Create a repo

iPhone + iPad: $9.99 once. Unlimited repositories.Android: free download, one-time Full Access purchase.No subscriptions.

GitSync.md repository list with three example repositories and their branch and commit details

Your vaults and codebases. One place. Real Git.

Real .git directories
Your files. Your remote.
Open source. Open by design.

01 / The workflow

From remote to right here.

DESKTOP HABITS.
POCKET SIZE.

Keep the workflow you know.
Leave the laptop behind.

01

Create or clone.

Turn a local folder into a repo and publish to GitHub, or clone an existing repository from your Git server.

git init / git clone
02

Make it yours.

Write in Obsidian, your favorite Files-compatible editor, or GitSync.md. Your files stay ordinary files.

notes / code / whatever
03

Push it.

Review the diff, stage your changes, and make a commit. Send your work straight to your remote.

git commit → git push

Create on device

Your files already have a head start.

LOCAL FILES.
FIRST COMMIT.
YOUR NEW REPO.

A folder of notes, a small project, your next idea. Turn it into a real Git repository on your iPhone or iPad, then publish it to a new private GitHub repo. Your files stay in their original folder.

ON DEVICEREVIEWED FILESPRIVATE GITHUB REPO
Start with your files

  1. Pick your folder.

    Choose Add Repository → Publish a Folder, select a supported local folder in Files, and sign in with GitHub.

  2. Choose what goes in.

    Review and select your files, set your author details, and save the first commit on-device. Nothing is uploaded in this step.

  3. Make it a private GitHub repo.

    A separate publish action creates a private repository in your personal GitHub account and pushes your saved commit. Keep the app open for the first upload.

First publication supports local app folders under On My iPhone or On My iPad and regular files up to 10 MiB each. Cloud-provider folders and Git LFS publication are outside this flow.

02 / Full control

Small screen. Serious tools.

EVERY CHANGE.
IN PLAIN
SIGHT.

Actual Git, powered by libgit2. See what changed, choose what to stage, and keep your history in your hands.

See the source
DIFF / projects/app-launch.md+ / −
GitSync.md diff viewer showing added lines in green and removed lines in red
01 /

All the Git. None of the guesswork.

Branches, commit history, diffs, stash, tags, merge, and rebase. Resolve conflicts with a three-way view.

BRANCHSTAGECOMMITPUSH
02 /

Any repo. Your rules.

GitHub, GitLab, Bitbucket, Gitea, Forgejo, or a self-hosted remote. Connect over HTTPS or SSH. Git LFS included.

PRIVATE REPOSSSH + HTTPS
03 /

Your editor is already invited.

Files live in iOS Files. Work in Obsidian, iA Writer, or the built-in syntax-highlighted editor. GitSync.md handles the Git.

OBSIDIANIOS FILES
04 /

A little less tapping.

Run Pull, Push, or Sync from Apple Shortcuts. Pull from your Home Screen or Control Center. Enable Background Sync when it suits your workflow.

Background work is best effort and scheduled by iOS. Automatic publishing is off by default.

03 / Built for your files

One app. Plenty of possibilities.

NOTES. CODE.
WHATEVER'S NEXT.

If it belongs in a Git repository,
it belongs in your pocket.

For the note takers

Your second brain.
First-class Git.

Keep your Obsidian vault versioned and ready wherever an idea finds you.

Set up your vault
For the builders

The quick fix.
Without the laptop.

Edit a config, update your docs, or commit a change to your own Git server.

Connect your remote

Standard Git. Ordinary files. Always yours. Git traffic goes directly from your device to your remote. Git credentials are stored in the iOS Keychain.

Privacy

04 / Good questions

BEFORE
YOU COMMIT.

A few things to know.
For everything else, get in touch ↗

How does pricing work?

On iPhone and iPad, GitSync.md is $9.99 on the US App Store, paid once. Unlimited repositories, the editor, all manual Git tools, and optional Background Sync are included. On Android, the app is free to download from Google Play, with a one-time Full Access in-app purchase. Neither version has a subscription. Local store prices may vary.

Can I create a repository on my device?

Yes. On iPhone and iPad, choose Add Repository → Publish a Folder and sign in with GitHub. Select an existing local folder, review the files, and prepare the initial commit in place. Uploading is a separate action that creates a new private repository in your personal GitHub account. This flow supports local app folders under On My iPhone or On My iPad, with regular files up to 10 MiB each; cloud-provider folders, empty repositories, and Git LFS publication are outside this flow. See how it works →

Does it work with my Obsidian vault?

Yes. Clone your vault into a Files location Obsidian can access, then use GitSync.md to pull and push. Shortcuts and syncmd:// links can trigger repository actions. Follow the setup guide →

Can I use private or self-hosted repos?

Yes. Use GitHub OAuth or a Personal Access Token for GitHub, or connect another Git remote over HTTPS or SSH with its own credentials. GitLab, Bitbucket, Gitea, and Forgejo are supported.

What happens when there's a conflict?

Review conflicts in the Conflict Center. Choose ours or theirs, or edit a merged result in the three-way view. Continue or abort a merge or rebase explicitly. It's a real Git working copy, so you can also finish on desktop.

How automatic is Background Sync?

You choose automatic pulls, automatic commit and push, or both. Publishing starts off. Sync attempts happen when the app opens and when iOS allows background processing; they aren't guaranteed or real time. Concurrent edits and unsafe Git states stop for your attention.

Where do my files and data go?

Files live on your device, and Git operations talk directly to your remote. Credentials stay in Keychain. Separately opted-in Push Sync uses a relay for repository names, GitHub installation/account identifiers, and APNs registration data, but never file contents, local paths, or Git credentials. The app also collects coarse onboarding analytics. Read the privacy policy →

Which platforms can I install it on?

GitSync.md is available for iPhone and iPad on the App Store, and for Android on Google Play. The iPhone and iPad app requires iOS 17 or iPadOS 17 or later; its Control Center pull button requires iOS 18 or later. The Files, Apple Shortcuts, and on-device folder publication workflows shown here describe the iPhone and iPad app.

Read the field notes

Obsidian + Git on iPhone & iPad Put your Git workflow on a Shortcut All guides →

GitSync.md / iOS + Android

GOOD WORK
TRAVELS.

Take your repositories with you.

Download GitSync.md on the App Store Get GitSync.md on Google Play

iPhone + iPad: $9.99 once.Android: free download, one-time Full Access purchase.No subscriptions.