Obsidian Vault

The Obsidian Vault Skill connects your existing Obsidian vault to Aori. Aori indexes your Markdown notes and can search them to answer questions, pull relevant context, create new notes, and append content to existing ones.

What Aori Can Do

• Search and read: Aori indexes your vault’s Markdown files. Headings (H2/H3 sections) become searchable knowledge sections.
• Create new notes: Aori can create new .md files in your vault when asked.
• Append to notes: Aori can append content to existing notes, in sections marked <!-- aori:managed -->. It does not rewrite or delete content outside these sections.

What Aori Does Not Do

• Rewrite or delete your manually authored content
• Access files outside the chosen vault folder

Setup

1. Go to Settings → Skills → Obsidian Vault.
2. Tap Choose Vault and select your Obsidian vault folder using the system folder picker.
3. Aori will begin indexing the vault.
4. Once indexed, your notes are available as a knowledge source in all conversations.

Platform support: Desktop (macOS, Windows, Linux) and Android.

How the Index Works

Aori splits your Markdown files into sections at each H2 and H3 heading. Each section is embedded independently using semantic embeddings. When you ask a question, the most relevant sections are retrieved via vector similarity search and included as context for the AI. This approach is called RAG (Retrieval-Augmented Generation).

Privacy

Your Obsidian vault files stay on your device. When you ask a question that requires vault content, the relevant note sections are sent to your chosen AI provider as part of the conversation. Vault contents are never sent to any third party by Aori directly.

Disconnecting the Skill

Go to Settings → Skills → Obsidian Vault and tap Disconnect. Your index is retained — reconnecting the same vault will reuse it. Your vault files are not modified or deleted.