Sync an Obsidian vault on iPhone
Keep a business second-brain vault on an iPhone in sync with a private GitHub repo, using Obsidian's Git plugin and a token limited to one repo.
For small-business owners who keep notes on the phone and want the same notes in a private GitHub repo · ChatGPT or Claude · Intermediate
Researched, not run yetWhat that means
Copy the prompt
Fill in the [brackets] after you paste it.
I run a small [TYPE OF BUSINESS] and I am setting up an Obsidian vault as my business second brain. It syncs to a private GitHub repo from my iPhone, so keep it small: plain Markdown, short notes, no plugins needed.
Write:
1. A simple folder list with one line on what goes in each folder.
2. A Facts note: business name, services, hours, prices, service area and the tools I use, with [BRACKETS] for me to fill in.
3. A Decisions note: a table with date, decision, why, and what would change my mind.
4. A Log note: one dated line per entry, newest at the top.
5. An Inbox note for quick captures that I sort once a week.
6. A Wins and snags note: what worked, what broke, what to try next.
7. A short README for the top of the vault that says what each note is for.
Rules:
- Never ask me for passwords, tokens, card numbers or client personal details, and add a line to the README saying those stay out of the vault.
- Use file names with no spaces or special characters, so they work on an iPhone, a Mac and Windows.
- Show me the folder list first and wait for my OK before you write the notes.Copied. Paste it into ChatGPT next.
Free PDF
Get this setup as a PDF
Enter your email and a print-ready copy of this setup opens here, to save as a PDF. The free starter pack opens too. Tap confirm in the email that follows to get occasional new setups. Unsubscribe anytime.
Already a subscriber? Unlock it on this device
Free PDF
A confirmation email is on its way too: tap confirm in it to get new setups by email.
Three ways to run this setup
Free
Copy and paste it yourself
Copy the prompt above into ChatGPT, Claude or Grok. It drafts. You approve.
Go to the prompt$9 once
Complete Pack
One payment, no membership. Opens the pack pages: Bot Safety Checklist, Second Brain Starter Vault, Voice File Starter, Tested Grok Bot prompt pack, Write it as code prompts.
See the Complete PackFree to start, VIP $19 a month
Save it as a bot in the guided setup app
The app turns this setup into a bot with the draft-only rules. 3 setups build free; the rest are part of VIP. A human reviews a prompt or setup for you within 24 hours, up to 2 a month.
Build it in the app
Want this one tested next? Vote for it.
What you get back
Illustrative. Your results will differ.
- inbox/inbox.md: quick captures, sorted every Friday
- facts/business-facts.md: services, hours, prices, service area
- decisions/decisions.md: date | decision | why
See the rest of the example (1 more)
- log/log.md and log/wins-and-snags.md
3 steps
- Copy the prompt.
- Paste it into ChatGPT.
- Fill in the [brackets], then read the answer before you send or use it.
Quick answer
Install Obsidian, create an empty vault stored on the iPhone (not in iCloud), add the community plugin named Git, and give it a fine-grained GitHub token that reaches only the vault repo. Clone the repo into the vault, then turn on pull on startup and auto commit-and-sync every 30 minutes. The plugin's own docs call mobile Git very unstable and slower than desktop, so keep the vault small and know the fallback.
How do you set it up?
Skip this if
- The vault is large or full of PDFs and photos. The plugin's docs say repo size is limited on mobile.
- The notes would hold client personal details, passwords or card numbers.
Done after day one
A test note written on the iPhone shows up in the private repo on GitHub.
Tools
- An iPhone with Obsidian from the App Store
- A GitHub account and a private repo for the vault
- The Obsidian community plugin named Git (the obsidian-git project)
- A fine-grained GitHub token that reaches only the vault repo
- Optional fallback: the Working Copy app
Steps
- In Safari, sign in to GitHub and create a private repo for the vault: the plus menu, then New repository. Tick the option to add a README so the repo is not empty. GitHub says a private repo is open only to you and people you share it with.
- Install Obsidian from the App Store and open it. Tap Create new vault, give it a name, and leave Store in iCloud switched off. The Git plugin's docs say not to pick Store in iCloud, and Obsidian's help warns against syncing one vault with two services.
- In Obsidian, open Settings and tap Turn on community plugins, then Browse. Search for Git, install the plugin named Git, and tap Enable. Obsidian warns that community plugins run third-party code, so add only what the job needs.
- Back in Safari on GitHub: tap the profile picture, then Settings, Developer settings, Personal access tokens, Fine-grained tokens, Generate new token. Name it after the vault and set Expiration about 90 days out.
- Under Repository access, pick Only select repositories and choose the vault repo only. Under Permissions, set Contents to Read and write, and Commit statuses to Read and write, the two the plugin's docs list. GitHub adds read access to Metadata by itself. Leave everything else off, then tap Generate token.
- Copy the token and paste it only into the plugin, in the next step. Never paste it into a chat, a note, an email or a file in the repo.
- In Obsidian, open Settings, then the Git plugin's options at the bottom under Community plugins. Under Identity, type the GitHub username in Username on your Git server, then create a secret for Git server password or access token and paste the token there. Leave the Advanced settings alone.
- Open the command palette and run Git: Clone an existing remote repo. Enter the repo's https address with .git on the end, such as https://github.com/your-username/your-vault.git, not the address in the browser bar. Choose the vault root as the folder, then wait for the popup asking to restart Obsidian and restart it.
- In the plugin settings, fill in Repository author name and Repository author email (mobile Git has no default for them). Turn on Pull on startup and set Auto commit-and-sync interval (minutes) to 30.
- Test it: write a short note, run Git: Commit-and-sync from the command palette, and check that the note appears in the repo on GitHub. Then paste the prompt below into ChatGPT or Claude for a starter folder layout.
- Fallback if the clone crashes or never finishes: close Obsidian, clone the repo in the Working Copy app with the same https address, the username, and the token as the password. In the Files app, copy that folder over the empty vault, reopen Obsidian, enable the Git plugin and run Git: Pull. Pushing from inside Working Copy needs its paid Pro upgrade.
Where to paste this prompt
ChatGPT → Project instructions, or ChatGPT Tasks for scheduled reminders (once a day on Free)
More ways to run it
Which chat tools work with this prompt?
This prompt needs routines and connectors, so it's written for:
- ChatGPT
- Claude
How sure is this?
Last updated: · Last reviewed:
Before you use this
Who it is for: Small-business owners who keep notes on the phone and want the same notes in a private GitHub repo, with no computer needed. Expect some trial and error: Git on a phone is the weak spot.
What it is allowed to do: Drafts for you. Writes drafts (emails, posts, plans, replies). You review and send. Nothing goes out without you.
At a glance: time, cost and difficulty
At a glance
All outcome figures are estimates from cited sources, not independent verification by us.
- What it is allowed to do
- Drafts for you
Writes drafts (emails, posts, plans, replies). You review and send. Nothing goes out without you.
- Time saved (estimate)
- Not measured yet
- Difficulty
- Intermediate
- Tools needed
- Obsidian, GitHub, Obsidian Git plugin
- Typical cost
- Obsidian: free to use, and commercial licenses are optional, per Obsidian's help. GitHub: private repos are included on GitHub Free for personal accounts, per GitHub Docs. The Git plugin: price Not stated in sources. Working Copy, the fallback only: pushing needs its paid Pro upgrade; price Not stated in sources.
Reviewed Nov 6, 2026
Basis (estimate): No timing claim: nothing in the sources measures time spent or saved for this job.
What usually goes wrong?
Where agents tend to stall on this job. More patterns in Where AI gets stuck.
- Store in iCloud switched on when the vault was made. Make a new vault stored on the iPhone and clone again.
- Pasting the browser address. The clone needs the https address ending in .git.
- Obsidian crashes or hangs during the clone. The plugin's docs say this depends on the device and free memory; use the Working Copy clone instead.
- Sync stops after about 90 days. The token expired; make a new one with the same settings and replace the secret.
- A conflict after editing the same note on two devices. Open source control view, use Keep both, edit the note into one version, select Mark resolved, then commit.
What tips make it smoother?
- Keep the vault small. The plugin's docs say repo size on mobile is limited by memory, and large vaults are the ones that crash.
- Use plain file names. The plugin's docs warn that a name that works on one system can block a pull on another.
- Set a reminder a week before the token expires, so sync does not stop without warning.
- Run the starter prompt once, paste the notes in, and let auto commit-and-sync push them.
Where do the claims come from?
Summaries use public sources linked below, not independent verification. How setups are picked.
- Read Obsidian’s write-up (help.obsidian.md)
Obsidian: Install Obsidian on iPhone and iPad: find Obsidian on the App Store and tap Get (read 2026-11-06 from the page source in the official obsidianmd/obsidian-help repo on GitHub; help.obsidian.md itself could not be opened from the session)
- Read Obsidian’s write-up (help.obsidian.md)
Obsidian: Sync your notes across devices: on iOS, Create new vault has a Store in iCloud toggle; avoid syncing the same vault across multiple services; Working Copy works for Git on iOS, and some of its features require a paid in-app purchase (read 2026-11-06 from the official obsidianmd/obsidian-help repo)
- Read Obsidian’s write-up (help.obsidian.md)
Obsidian: Community plugins: Settings, Turn on community plugins, Browse, Install, Enable; community plugins run third-party code (read 2026-11-06 from the official obsidianmd/obsidian-help repo)
- Read Obsidian’s write-up (help.obsidian.md)
Obsidian: Commercial license: Obsidian is free to use; commercial licenses are optional (read 2026-11-06 from the official obsidianmd/obsidian-help repo)
- Read Obsidian Git plugin’s write-up (github.com)
Obsidian Git plugin: README: mobile support is experimental and very unstable; mobile uses isomorphic-git, with no SSH, limited repo size, and possible crashes on clone or pull; features include auto commit-and-sync on a schedule and auto-pull on startup (read 2026-11-06)
- Read Obsidian Git plugin documentation’s write-up (publish.obsidian.md)
Obsidian Git plugin documentation: Getting Started, Mobile: do not select Store in iCloud; GitHub needs a personal access token with Metadata read and Contents and commit status read and write; enter the username and a secret under Identity; leave Advanced alone; run Clone an existing remote repo with the https URL ending in .git; wait for the restart popup; Working Copy can do the first clone and is a paid app (read 2026-11-06 from docs/Getting Started.md in the plugin's GitHub repo)
- Read Obsidian Git plugin documentation’s write-up (publish.obsidian.md)
Obsidian Git plugin documentation: Conflict resolution: open source control view, Keep ours, Keep theirs or Keep both, Mark resolved, then Commit; avoid force pushing (read 2026-11-06 from the plugin's GitHub repo)
- Read GitHub’s write-up (docs.github.com)
GitHub: Fine-grained tokens: Settings, Developer settings, Personal access tokens, Fine-grained tokens, Generate new token; pick an expiration; Only select repositories; choose the minimal permissions; treat tokens like passwords; a token goes in place of the password for Git over HTTPS (read 2026-11-06 from the official github/docs repo; docs.github.com itself could not be opened from the session)
- Read GitHub’s write-up (docs.github.com)
GitHub: A token is revoked when it reaches its expiration date and cannot be restored; a new token is needed (read 2026-11-06 from the official github/docs repo)
- Read GitHub’s write-up (docs.github.com)
GitHub: Create a repository from the plus menu, New repository; choose visibility; optionally add a README (read 2026-11-06 from the official github/docs repo)
- Read GitHub’s write-up (docs.github.com)
GitHub: Private repositories are accessible only to the owner and people given access; GitHub Free includes unlimited private repositories with a limited feature set (read 2026-11-06 from the official github/docs repo)
Common questions
- Does the Obsidian Git plugin work on iPhone?
- Yes, but its own docs call mobile support experimental and very unstable. It is slower than on a computer, limits repo size, and can crash during a clone or pull on some phones. A small vault of text notes has the best chance.
- Why not store the vault in iCloud?
- The Git plugin's docs say not to pick Store in iCloud on iOS, and Obsidian's help warns against syncing one vault with two services. Obsidian's help says syncing one vault with two services can cause conflicts or corruption, and Git keeps its own history inside the vault folder.
- What permissions does the GitHub token need?
- Only the vault repo, with Contents and Commit statuses set to Read and write, the two the plugin's docs list. GitHub adds Metadata read access by itself. Set an expiry about 90 days out and paste the token only into the plugin's secret field.
- Is Working Copy free?
- Obsidian's help says some Working Copy features need a paid in-app purchase, and pushing from inside it needs its paid Pro upgrade. The price is Not stated in sources. In the fallback above, Working Copy only does the first clone and the Git plugin does the syncing.
Free kit by email
Get the free kit by email
The starter pack and the Portable AI Office, sent to your inbox. New setups by email after that. Unsubscribe any time.
What to do next
- Sync an Obsidian vault on a computer
Keep the same second-brain vault on a Mac or Windows computer, cloned with GitHub Desktop and synced by Obsidian's Git plugin every 30 minutes.
- How to give your AI bot a long-term memory with an Obsidian vault
Replace fuzzy in-chat “memory” with inspectable Markdown files: the bot appends a daily note and decision log to a Git-backed vault; you review in Obsidian; a weekly routine sorts an Inbox folder into PARA (Projects, Areas, Resources, Archive).
- Make AI write in your voice
Paste 10 to 20 pieces of your own writing, get a one-page voice profile of habits and banned phrases, and save it where each bot reads standing instructions.
Have a setup that works? Submit it. We credit sources and write it up in plain language.