Vault Chat Agent

approved

by Evgenii Bykovskikh

This plugin has not been manually reviewed by Obsidian staff. Chat with an AI assistant that can search your vault, inspect notes, and prepare edits for review

Updated todayMIT
Install in ObsidianView on GitHub

Vault Chat Agent

AI assistant plugin for working with your Obsidian vault.

What Works

  • One agentic chat with Ask and Edit intents.
  • OpenAI-compatible chat completions via /v1/chat/completions.
  • Provider presets for OpenAI, DeepSeek, OpenRouter, LM Studio, Ollama, and custom endpoints.
  • Local vault indexing across supported text files, Canvas files, and metadata-only attachments.
  • Graph-aware retrieval using note links, backlinks, and neighboring chunks.
  • Read-only agent tools for searching, opening notes, inspecting links, and reviewing the current note.
  • Reviewed edit proposals with patch previews, Apply/Reject, and batch patch support.
  • Realtime re-indexing on vault create, modify, delete, and rename events.

Build

npm install
npm run build

Then copy the contents of dist/ into:

<vault>/.obsidian/plugins/vault-chat-agent/

Enable the plugin in Obsidian community plugin settings, then configure an OpenAI-compatible provider in the plugin settings.

Provider Notes

The plugin calls:

<API base URL>/v1/chat/completions

Remote providers usually need an API key. Local providers such as LM Studio and Ollama can leave the API key empty when using a localhost base URL.

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.