Shared AI brain: Obsidian and GitHub

What does this setup do?

Step up from one bot's memory file to a shared notes folder for a small team, backed up to a private GitHub repository and read by your assistants.

Who is it for?

Small teams that already use Obsidian and want more than one assistant working from the same notes. It is the step-up from the single-bot memory setup. Keep passwords, client records and anything private out of the vault.

How do you set it up?

Tools

• Obsidian
• A private GitHub repository
• The Obsidian Git community plugin
• Claude Code, or another assistant that reads files from a folder

Steps

1. Start with the single-bot setup linked from this page. Move to this one when a team or several assistants need the same notes.
2. Make a private GitHub repository for the vault. Do not put passwords, API keys or client records in it.
3. In Obsidian, install the Git community plugin. Its documentation says you can clone an existing remote repository, or start a new local repository and optionally push it to a remote.
4. Create three files at the top of the vault: an index of folders, a short rules file for how assistants should write notes, and a log of changes.
5. Claude Code reads CLAUDE.md files at the start of every session, per Anthropic's docs. Put a pointer to the rules file in CLAUDE.md so it follows the same rules.
6. For ChatGPT, Grok Bot and Muse, reading or writing the folder directly is Not stated in sources. Paste the rules file into each one's instructions by hand.
7. Back up on purpose. Obsidian's help says syncing is not a backup, so keep the GitHub copy as the backup and review what changed before you accept it.

You are working in our shared notes folder. Read the rules file and the index first.

Task: [for example: add today's call notes to the right client folder]

Rules:
- Write only inside [FOLDER NAME].
- Do not delete or rewrite existing notes. Add a new note or append at the end.
- Add one line to the change log: date, file, what you did.
- Never write passwords, keys, account numbers or client records.
- Show me a list of the files you changed. I will review before it is committed.

Which chat tools work with this prompt?

This prompt needs routines and connectors, so it's written for:

• Obsidian
• GitHub
• Claude Code
• ChatGPT

What tips make it smoother?

• Anthropic's docs say Claude Code can also read AGENTS.md in place of CLAUDE.md.
• Obsidian's help says notes are stored locally by default, so a repository is a second copy, not a mirror.
• Review the commit before you push when an assistant has edited notes.

Where do the claims come from?

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

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

  Obsidian Git plugin documentation: Getting Started: clone an existing remote repository or start a new local one and optionally push to a remote (read 2026-10-31 through a page fetch tool, not a direct browser open)

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

  Obsidian: Back up your Obsidian files: notes are stored locally by default, syncing is not a backup (read 2026-10-31 through a page fetch tool, not a direct browser open)

• Read Anthropic’s write-up (code.claude.com)

  Anthropic: How Claude remembers your project: CLAUDE.md and AGENTS.md files, read at the start of every session, auto memory (read 2026-10-31 through a page fetch tool, not a direct browser open)