obsidian-ai-curator: Instructions file for Claude Code

Obsidian AI Curator Project Instructions

This document provides context for AI assistants and developers working on the Obsidian AI Curator project - an AI-powered system that actively manages and consolidates notes in an Obsidian vault.

Project Vision

This project enables AI to be a true research partner and knowledge curator:

• Active Curation: AI proactively finds, consolidates, and organizes scattered knowledge
• "Tetris for Knowledge": Like pieces falling into place, fragments combine into coherent notes
• Research Partnership: AI understands your research context and actively helps build knowledge

How It Works

graph TB
    subgraph "Claude Desktop/Code"
        AI[AI Assistant]
    end
    
    subgraph "MCP Server"
        Tools[Tool Suite]
        Cache[Vault Cache]
        API[API Client]
    end
    
    subgraph "Obsidian"
        Plugin[AI Curator Plugin]
        Vault[Your Notes]
    end
    
    AI -->|MCP Protocol| Tools
    Tools --> Cache
    Tools --> API
    API -.->|HTTP| Plugin
    API -->|File System| Vault
    Plugin -->|Native API| Vault
    
    style AI fill:#e1bee7,stroke:#4a148c,stroke-width:2px,color:#000
    style Tools fill:#c5cae9,stroke:#1a237e,stroke-width:2px,color:#000
    style Vault fill:#c8e6c9,stroke:#1b5e20,stroke-width:2px,color:#000
    style Plugin fill:#fff9c4,stroke:#f57f17,stroke-width:2px,color:#000
    style Cache fill:#e0e0e0,stroke:#424242,stroke-width:2px,color:#000
    style API fill:#e3f2fd,stroke:#0d47a1,stroke-width:2px,color:#000

1. MCP Server provides tools for searching, reading, and writing notes
2. Obsidian Plugin adds native API access for better performance and accuracy
3. AI Integration enables Claude to understand vault structure and suggest improvements
4. Git Integration tracks changes and enables safe experimentation

Key Components

1. MCP Server (src/mcp-server.js): Core tool interface for vault operations
2. Obsidian Plugin (obsidian-ai-curator-plugin/): API server and consolidation UI
3. Tool Suite (src/tools/): Specialized tools for search, write, tags, projects, etc.
4. Obsidian API Client: Auto-detects and uses plugin when available