multi-provider llm chat with vault context injection
Enables freeform conversational chat with LLM models from 15+ providers (OpenAI, Anthropic, Groq, DeepSeek, local Ollama, etc.) by maintaining a provider abstraction layer that normalizes API calls across different chat model interfaces. Context is injected from selected notes, folders, or tags via a context envelope system that prepares markdown content for inclusion in the prompt. The plugin streams responses token-by-token back to the chat UI, maintaining conversation history as persistent markdown notes in the vault.
Unique: Implements a provider abstraction layer (ChatModelProviders enum in src/constants.ts) that normalizes API calls across 15+ heterogeneous LLM providers, allowing users to swap providers without workflow disruption. Context envelope system selectively injects markdown from vault notes/folders/tags, avoiding token limit overflow. Responses streamed directly into Obsidian chat UI with conversation persistence as markdown files.
vs alternatives: Supports more LLM providers natively than Copilot for VS Code (which is OpenAI-only) and maintains local-first option via Ollama, while keeping all chat history in user's vault rather than external cloud storage.
vault-wide semantic search with bm25+ lexical fallback
Provides dual-mode search across the entire vault: BM25+ lexical search (free tier) for keyword-based retrieval and optional embedding-backed vector search (Orama or Miyo) for semantic similarity matching. The indexing system maintains an inverted index of vault notes and can optionally compute embeddings via external providers. When a user queries, the system retrieves relevant notes ranked by relevance and injects them as context into the LLM chat, enabling vault-wide question-answering without manual note selection.
Unique: Implements a hybrid search strategy combining BM25+ lexical indexing (free, fast, keyword-aware) with optional embedding-backed vector search (semantic, requires external API). The indexing system (src/indexing) maintains an inverted index and can optionally compute embeddings via Orama or Miyo. Retrieval results are automatically injected into chat context without user intervention.
vs alternatives: Hybrid BM25+semantic approach is more robust than pure vector search (which fails on exact keyword matches) and more semantically aware than pure lexical search, while remaining free at the BM25 tier unlike competitors requiring embedding APIs.
self-hosted backend replacement for privacy-first deployments
Allows users on the self-host tier to replace Brevilabs-hosted backend services with self-hosted alternatives: Miyo (embedding service), Firecrawl (web scraping and document conversion), and Perplexity (web search). This enables fully local deployments where no data leaves the user's infrastructure, addressing privacy and compliance requirements. Configuration is via settings UI where users provide URLs to their self-hosted services.
Unique: Implements a pluggable backend architecture where Brevilabs-hosted services (Miyo, Firecrawl, Perplexity) can be replaced with self-hosted alternatives via configuration URLs. Users on the self-host tier can deploy their own instances and point the plugin to them, enabling fully local deployments. No code changes required — configuration is via settings UI.
vs alternatives: Enables fully local deployments unlike free/plus tiers which require Brevilabs backend. More flexible than single-provider solutions because users can mix self-hosted and cloud services. Requires premium subscription and operational overhead for self-hosting.
chat persistence and conversation history as markdown notes
Automatically saves chat conversations as markdown files in the vault, with each conversation stored as a separate note containing the full message history (user messages, AI responses, timestamps). Users can browse, search, and reference past conversations like any other vault note. Conversation files are stored in a designated folder and can be organized by date, project, or custom tags.
Unique: Implements automatic conversation persistence by appending each chat message to a markdown file in the vault. Conversations are stored as separate notes with timestamps and can be searched using Obsidian's native search. No external database required — all history is stored as markdown files in the vault.
vs alternatives: More integrated than ChatGPT's conversation history because conversations are stored in the user's vault and searchable. More transparent than cloud-based chat history because users can directly edit and version-control conversation files. Simpler than external conversation databases because it leverages Obsidian's file system.
multi-model provider abstraction with unified api
Implements a provider abstraction layer (ChatModelProviders enum in src/constants.ts) that normalizes API calls across 15+ heterogeneous LLM providers (OpenAI, Anthropic, Groq, DeepSeek, Mistral, Ollama, LM Studio, etc.). The abstraction handles provider-specific authentication, request/response formatting, streaming protocols, and error handling. Users can switch providers in settings without changing their workflow, and the plugin automatically adapts to each provider's capabilities (e.g., function calling, vision, etc.).
Unique: Implements a provider abstraction layer that normalizes API calls across 15+ providers by defining a common interface and provider-specific adapters. Each provider adapter handles authentication, request formatting, streaming, and error handling. The abstraction allows users to switch providers in settings without code changes. Supports both cloud (OpenAI, Anthropic, Groq) and local (Ollama, LM Studio) models.
vs alternatives: Supports more providers natively than most competitors (15+ vs 2-3 for most tools). Includes local model support (Ollama, LM Studio) unlike cloud-only solutions. Abstraction is transparent to users — no code required to switch providers.
streaming response rendering with token-by-token ui updates
Streams LLM responses token-by-token directly into the Obsidian chat UI, rendering each token as it arrives from the provider. This provides real-time feedback to users and reduces perceived latency compared to waiting for the full response. The streaming implementation handles provider-specific streaming protocols (Server-Sent Events for OpenAI, streaming for Anthropic, etc.) and gracefully handles network interruptions.
Unique: Implements token-by-token streaming by handling provider-specific streaming protocols (Server-Sent Events for OpenAI, streaming for Anthropic, etc.) and rendering each token to the chat UI as it arrives. Streaming is transparent to users — no configuration required. Supports cancellation of in-flight requests.
vs alternatives: More responsive than batch response rendering because users see results in real-time. Supports multiple streaming protocols unlike single-provider solutions. Reduces perceived latency compared to waiting for full response.
settings ui with provider configuration and model selection
Provides a comprehensive settings interface where users configure LLM providers (API keys, model names, endpoints), embedding providers, search settings, and plugin behavior. The settings UI includes dropdowns for provider selection, text fields for API keys, and toggles for optional features. Settings are persisted to Obsidian's local storage and validated on save. The UI dynamically shows provider-specific options (e.g., Azure OpenAI requires endpoint URL and deployment name).
Unique: Implements a settings UI that dynamically shows provider-specific options based on the selected provider. Settings are persisted to Obsidian's local storage and validated on save. The UI includes dropdowns for provider/model selection, text fields for API keys and URLs, and toggles for optional features. No code required to configure — all settings are UI-driven.
vs alternatives: More user-friendly than environment variables or config files because settings are managed via UI. Supports provider-specific options (e.g., Azure OpenAI endpoint) unlike generic settings. Integrated into Obsidian's settings panel unlike external configuration tools.
ai-assisted note editing with diff preview and one-click apply
Allows users to request AI-generated edits to notes via a 'Composer' mode that generates suggested changes, displays them as a side-by-side diff, and applies them back to the vault with a single click. The system uses the LLM to generate edited markdown content, compares it against the original note, and renders the diff in the UI. Users can accept or reject changes before they're written back to disk, providing a safety mechanism for AI-assisted writing.
Unique: Implements a Composer mode that generates AI edits, computes a diff against the original note, and renders it in the Obsidian UI with one-click apply/reject. This provides a safety layer between LLM generation and vault persistence — users see exactly what will change before committing. The diff is computed client-side, avoiding round-trips to the LLM.
vs alternatives: Provides explicit diff preview before applying changes, unlike ChatGPT which requires manual copy-paste and comparison. More integrated than external editors because changes are applied directly to vault files with Obsidian's native file system integration.
+7 more capabilities