Skip to content

Search setups and tools

Type a few words to search.

Browse all setups

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.

For small-business owners who already sync the vault on a phone, or plan to, and want the same notes on a computer · 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 keep my business second brain in an Obsidian vault that syncs between my phone, my computer and a private GitHub repo. Write a simple folder structure and starter notes I can paste in. Plain Markdown, short notes, no plugins needed.

Write:
1. A 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, and a one-line habit: open Obsidian, let it pull, then edit.

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.
Open in ChatGPT

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 Pack
  • Free 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.

  • Pull on startup: 2 new notes from the iPhone
  • Auto commit-and-sync: log/log.md, decisions/decisions.md
  • Conflict in facts/business-facts.md: kept both, merged by hand

3 steps

  1. Copy the prompt.
  2. Paste it into ChatGPT.
  3. Fill in the [brackets], then read the answer before you send or use it.

Quick answer

Install GitHub Desktop, sign in through the browser, and clone the vault repo into a normal folder, not inside iCloud Drive, OneDrive or Dropbox. Open that folder in Obsidian with Open folder as vault and add the Git plugin with pull on startup and auto commit-and-sync every 30 minutes. The plugin runs the computer's own Git, so install Git as well; its sign-in helper logs in through the browser, so there is no token to manage. GitHub is the hub: pull before editing, let auto-sync push, and merge conflicts by hand.

How do you set it up?

Skip this if

  • The only copy of the vault would sit inside iCloud Drive, OneDrive or Dropbox.
  • The notes would hold client personal details, passwords or card numbers.

Done after day one

A note edited on the computer shows up on GitHub and, after the next pull, on the phone.

Tools

  • A Mac or Windows computer
  • GitHub Desktop, signed in to the GitHub account that owns the vault repo
  • Git, plus Git Credential Manager (included in Git for Windows)
  • Obsidian and its community plugin named Git

Steps

  1. Install GitHub Desktop and sign in. Mac: GitHub Desktop menu, Settings, Accounts, Sign Into GitHub.com. Windows: File, Options, Accounts, Sign Into GitHub.com. Click Continue With Browser and approve in the browser. GitHub Desktop handles the login, so no token is needed.
  2. On GitHub, open the vault repo, click Code, then Open with GitHub Desktop. Click Choose and pick a normal folder such as Documents, not inside iCloud Drive, OneDrive or Dropbox, then click Clone. Obsidian's help warns against syncing one vault with two services.
  3. Install Git as well. The Git plugin's docs say GitHub Desktop alone is not enough, because the plugin runs the computer's own Git. Windows: install Git for Windows with the default settings; it includes Git Credential Manager. Mac: per GitHub Docs, install Git and Git Credential Manager with Homebrew.
  4. Install Obsidian from obsidian.md/download. In the vault switcher, choose Open folder as vault and pick the folder GitHub Desktop cloned.
  5. Open Settings, turn on community plugins, then Browse. Search for Git, install the plugin named Git, and enable it. In its settings, turn on Pull on startup and set Auto commit-and-sync interval (minutes) to 30.
  6. Run Git: Commit-and-sync once from the command palette. The first time, Git Credential Manager opens a browser window to sign in to GitHub. Approve it once and Git remembers the login.
  7. Day to day, GitHub is the hub. Pull before editing (pull on startup does this when Obsidian opens), let auto-sync push, and let one device finish syncing before editing the same note on another.
  8. If a conflict is flagged, open source control view, use Keep both on each block, edit the two versions into one note by hand, select Mark resolved, then Commit. Never force push to get past it.
  9. Fallback if the plugin cannot sign in: sync with GitHub Desktop instead. Click Fetch origin and Pull origin before editing, then commit and click Push origin when done.

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?

ResearchedDrafts for you

Research · Intermediate · Small business

Last updated: · Last reviewed:

Before you use this

Who it is for: Small-business owners who already sync the vault on a phone, or plan to, and want the same notes on a computer. GitHub Desktop handles the GitHub login, so there is no token to create on the computer.

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.

Reviewed Nov 6, 2026

Time saved (estimate)
Not measured yet
Difficulty
Intermediate
Tools needed
Obsidian, GitHub Desktop, Git, 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. GitHub Desktop, Git and the Git plugin: price Not stated in sources.

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.

  • The plugin cannot run Git. GitHub Desktop alone is not enough; install Git for Windows, or Git on a Mac.
  • The clone landed inside iCloud Drive, OneDrive or Dropbox. Move it out: clone again into a plain folder and open that one as the vault.
  • Push rejected because the remote has newer commits. Pull first. The plugin's docs say a rejected push alone is not a conflict.
  • A conflict after editing the same note on two devices. Use Keep both, merge the text by hand, Mark resolved, then Commit.

What tips make it smoother?

  • Set up the phone first if it holds the notes, push them, then clone on the computer, so both start from the same copy.
  • The 30-minute timer carries across sessions: the plugin's docs say that if Obsidian closes early, commit-and-sync runs the next time it opens. Run Git: Commit-and-sync by hand before switching devices.

Where do the claims come from?

Summaries use public sources linked below, not independent verification. How setups are picked.

  • Read GitHub’s write-up (docs.github.com)

    GitHub: GitHub Desktop sign-in: Mac, GitHub Desktop menu, Settings, Accounts, Sign Into GitHub.com; Windows, File, Options, Accounts; Continue With Browser; GitHub Desktop uses short-lived tokens (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: Cloning to GitHub Desktop: sign in first, open the repo, Code, Open with GitHub Desktop, Choose a local folder, Clone (read 2026-11-06 from the official github/docs repo)

  • Read GitHub’s write-up (docs.github.com)

    GitHub: Push origin sends local commits to GitHub; Fetch origin and Pull origin bring in remote commits (read 2026-11-06 from the official github/docs repo)

  • Read GitHub’s write-up (docs.github.com)

    GitHub: Git Credential Manager signs in through a browser window, so no personal access token is needed; Git for Windows includes it; on a Mac, install Git and Git Credential Manager with Homebrew (read 2026-11-06 from the official github/docs repo)

  • Read Obsidian’s write-up (help.obsidian.md)

    Obsidian: Install Obsidian on Windows and macOS from obsidian.md/download (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: Open folder as vault uses an existing folder as the vault (read 2026-11-06 from the official obsidianmd/obsidian-help repo)

  • Read Obsidian’s write-up (help.obsidian.md)

    Obsidian: Avoid syncing the same vault across multiple services to prevent data conflicts or corruption (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 (read 2026-11-06 from the official obsidianmd/obsidian-help repo)

  • Read Obsidian Git plugin documentation’s write-up (publish.obsidian.md)

    Obsidian Git plugin documentation: Installation: installing GitHub Desktop is not enough on Windows, regular Git is needed, with Git Credential Manager; Mac needs Git installed (read 2026-11-06 from docs/Installation.md in the plugin's GitHub repo)

  • Read Obsidian Git plugin’s write-up (github.com)

    Obsidian Git plugin: README: automatic commit-and-sync on a schedule, auto-pull on startup, conflict resolution in the editor with keep either or both versions (read 2026-11-06)

  • Read Obsidian Git plugin documentation’s write-up (publish.obsidian.md)

    Obsidian Git plugin documentation: Conflict resolution: Keep both, edit into one note, Mark resolved, then Commit; a rejected push alone is not necessarily a conflict; avoid force pushing (read 2026-11-06 from the plugin's GitHub repo)

Common questions

Does the computer need a GitHub token?
No. GitHub Desktop signs in through the browser, and Git Credential Manager does the same for the Git the plugin uses. GitHub's docs say Git Credential Manager means no personal access token to create or store.
Why install Git if GitHub Desktop is already there?
The Git plugin runs the computer's own Git. Its docs say GitHub Desktop alone is not enough on Windows, and a Mac needs Git installed too.
Can the vault live in iCloud Drive, OneDrive or Dropbox?
Not for this setup. Obsidian's help warns against syncing one vault with more than one service. Git is already the sync, so the vault folder stays outside cloud folders.
What happens when the phone and the computer change the same note?
Git flags a conflict on the next pull. In the plugin's source control view, use Keep both, edit the two versions into one note, select Mark resolved, then Commit. The plugin's docs warn against force pushing to get past it.

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 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.

  • 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.