Obsidian

Give your Obsidian vault an agent that actually knows your notes, powered by Hindsight. The plugin syncs your vault into a Hindsight bank and adds a chat panel whose answers are grounded on your notes — and cite them.

Why this matters​

Obsidian is where your knowledge lives. Vector-search plugins can find related notes, but they can't reason across them, remember what you asked, or keep a running synthesis as your vault grows. Hindsight adds that layer:

• Recall is faster and more accurate than text search.
• Reflect reasons over your whole vault to answer a question, and shows the notes it used.
• Mental models (on the roadmap) keep living summaries of your vault that refresh as you write.

Source of truth stays in Obsidian​

A hard rule of this integration: Hindsight never becomes a second source of truth. Sync is one-way (Obsidian → Hindsight), every answer cites the note it came from so you can fix things at the source, and chat conversations are not stored by default. Edit a note, and Hindsight reconverges on the next sync.

What it does​

• Incremental vault sync — notes are retained as Hindsight documents. Edits upsert, deletes remove. A content hash means unchanged notes are skipped.
• Implicit scoping — every note is auto-tagged on ingest with its vault, folder (and sub-folders), and created/updated dates. You never think about scope until you recall — then filter by any combination via Hindsight's tag_groups. Multiple vaults share one bank and stay separable by their vault: tag.
• Same data from UI and API — the Obsidian chat panel and your automations (n8n, Hermes, ...) hit the same bank with the same tags, so they see the same scoped view.
• Grounded chat — a side panel that answers questions over your notes via Reflect, with collapsible citations (click to open the source note) and a reasoning disclosure.
• Manual or automatic — sync on every edit, or run Sync vault now on demand.

Scoping​

Recall/reflect (from the UI or an API call) can filter by any combination of:

Your own frontmatter tags/aliases are carried through too.

Installation​

✨ Recommended: Hindsight Cloud — sign up free, get an API key, and skip self-hosting.

While the plugin is in beta it installs via BRAT: add the repository vectorize-io/hindsight-obsidian (the dedicated plugin repo BRAT installs from) and enable it in Settings → Community plugins.

Self-hosting alternative — run Hindsight locally:

pip install hindsight-all
exportHINDSIGHT_API_LLM_API_KEY=your-openai-key
hindsight-api

Configuration​

Open Settings → Hindsight:

Commands​

• Sync vault now — full reconcile (ingest changed notes, prune deleted ones).
• Ingest current note — force-sync the active note.
• Open chat — open the grounded chat panel.