Copilot for Obsidian — Documentation

The complete guide to Copilot for Obsidian, from first chat to Agent Mode and self-hosting.


Welcome to the official documentation for Copilot for Obsidian, an AI-powered assistant plugin that brings the power of large language models directly into your note-taking workflow.

Table of Contents

DocumentWhat it covers
Getting StartedInstallation, first-time setup, Quick Chat, Agent Mode, keyboard shortcuts
Quick Chat InterfaceQuick Chat modes, messages, history, settings, and auto-compact
LLM ProvidersAll 16+ supported providers and how to set them up
ModelsWhich chat models ship with Copilot, adding your own, and the default model
Context and MentionsActive note context, @-mentions, URLs, tags, and the web viewer
Custom CommandsCreating and using preset prompts, template variables, Quick Command, Quick Ask
Vault Search and IndexingLexical search, semantic search, index management, exclusions
Agent Mode and ToolsDedicated OpenCode, Claude, and Codex workspace, permissions, skills, and tools
Windows Setup for Agent ModeConnecting OpenCode, Claude Code, or Codex to Agent Mode on Windows
ProjectsFocused Agent Mode and Quick Chat workspaces with isolated context and history
System PromptsCustomizing AI behavior with built-in and custom system prompts
Paid Plans and Self-HostPaid-plan features, memory system, self-host mode, Miyo
Troubleshooting and FAQCommon errors, provider-specific issues, performance, FAQ

Quick Start

  1. Install Copilot from Obsidian Community Plugins
  2. Add a provider under Settings → Copilot → Models (BYOK)
  3. Run Open Copilot Chat Window for Quick Chat, or click the Agent ribbon icon for Agent Mode
  4. Start chatting

For a full walkthrough, see Getting Started.