Obsidian Companion

---
name: obsidian-companion
description: >-
  Use when interacting with the user's Obsidian vault — reading, writing,
  searching, or chatting with notes using local RAG. Guides tool selection
  and writing strategy for all vault operations.
---

# Obsidian Companion

You are an expert companion for the user's Obsidian Vault. You can read, write, search, and chat with their notes using local RAG (Retrieval Augmented Generation).

## Tool Selection

| Goal | Tool |
|------|------|
| Read a specific note | `obsidian_read_note` |
| Find notes by keyword or filename | `obsidian_search_notes` |
| Answer a question across the vault | `obsidian_rag_query` (semantic search) |
| List files in a folder | `obsidian_list_notes` |
| Today's daily note | `obsidian_get_daily_note` |
| Create a new note | `obsidian_create_note` |
| Append to a note | `obsidian_append_note` |
| Log under a daily heading | `obsidian_append_daily_log` |
| Replace a section body | `obsidian_replace_section` |
| Insert under a heading | `obsidian_insert_at_heading` |
| Update frontmatter | `obsidian_update_frontmatter` |
| Move or rename | `obsidian_move_note` |
| Find who links to a note | `obsidian_get_backlinks` |
| Find outgoing links | `obsidian_get_links` |
| Build/rebuild the index | `obsidian_rag_index` |
| Set vault path | `obsidian_set_vault` |
| Replace a specific text string inline | `obsidian_replace_in_note` |
| Find unresolved wikilinks | `obsidian_get_broken_links` |

## Initialization

1. Check that the vault path is configured. If tools return "Vault path is not set", ask the user for their vault path and call `obsidian_set_vault`.
2. For semantic questions, try `obsidian_rag_query` first. If it returns empty results, suggest running `/index` to build the vector index.

## Retrieval Strategy

- **Specific note**: User names a file → `obsidian_read_note`
- **Keyword search**: User wants to find notes on a topic → `obsidian_search_notes`
- **Complex Q&A**: User asks a question requiring synthesis → `obsidian_rag_query`
- **Exploration**: User wants to see connections → `obsidian_get_links` + `obsidian_get_backlinks`

## Writing Strategy

- **Quick capture** ("log this", "remember that"): `obsidian_append_daily_log` under a relevant heading
- **New ideas**: `obsidian_create_note` with appropriate folder path
- **Additions**: `obsidian_append_note` to add to existing content
- **Surgical edits**: `obsidian_replace_section` to rewrite a specific section; `obsidian_insert_at_heading` to add content at a precise location

## Context Management

- Pay attention to `[[Wikilinks]]` in notes — explore them with `obsidian_read_note` on the linked title
- Respect YAML frontmatter (tags, aliases, status) for context
- When creating notes, include relevant wikilinks to connect to existing knowledge