Sync an Obsidian vault

Sync an Obsidian vault

This guide shows you how to bring the notes in an Obsidian vault into Outrun so your AI agents can use them. Outrun has no direct Obsidian connection. Instead, you store the vault in a GitHub repository and connect that repository with the GitHub source.

Before you start

• Your vault is stored in a GitHub repository. One way to do this is the community Obsidian Git plugin.
• The notes you want are on the repository's default branch.
• You can add sources in your Outrun workspace.

Connect the repository

1. In Outrun, go to Sources and select Add Source.
2. On the GitHub card, select Connect.
3. Under 1. Connect GitHub Account, select Install GitHub App and give the app access to your vault repository on GitHub. If an account is already listed, select it.
4. Select Continue, enter a Source Name, then select Continue again.
5. Check the details under 3. Review & Confirm and select Create Source.

Outrun starts copying the repository when you create the source.

What Outrun copies

• Files on each repository's default branch.
• Markdown notes as full text, including front matter and [[wikilinks]] exactly as written. Wikilinks are not resolved into links.
• The path of each file in the repository, so you can filter by folder later.

Outrun does not store text for PDFs, .canvas files or images other than SVG. Files larger than 1 MB are skipped.

Note: Outrun copies your notes when you create the source. Changes you push to GitHub later are not copied automatically.

Make your notes available to agents

1. Go to AI Agents and open the Knowledge tab.
2. Select Create Group to start a new knowledge base.
3. Under Sources, select your vault's GitHub source.
4. Under Data Types, select Files.
5. Optional: under File Types, select .md to include only notes.
6. Optional: in Include Folders, enter comma-separated folder paths, such as notes/, projects/, to include only those folders.
7. Select Continue, name the knowledge base and finish the wizard.

Troubleshooting

A note is missing. Check that it is on the default branch, is smaller than 1 MB, and is inside any folder you entered in Include Folders.

Recent edits are missing. Outrun copied the vault when you created the source. Later pushes are not copied automatically.