· Back to the setup

AI Setups That Work

Sync an Obsidian vault on a computer

Researched

What it does

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.

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.

Tools

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.

The prompt

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.

Tips

Sources