OBSICLAUDE

pending

by CRtheHILLS

AI-powered vault assistant with 20 tools — Magic Write, agentic loops, drag & drop, vault health diagnostics. Claude actually touches your vault.

★ 1 starsUpdated 21d agoMITDiscovered via Obsidian Unofficial Plugins
View on GitHub

✨ OBSICLAUDE

Your vault. Claude's magic.


Version Obsidian Claude License


The first Obsidian plugin that lets Claude actually touch your vault.
Not just chat — create · edit · move · search · organize · analyze
All through natural conversation. 20 tools. Zero dependencies.


Get Started → · Features · Magic Write · Tools · Install



🧠 Why OBSICLAUDE?

❌ Other AI plugins

You: "Organize my notes"
Bot: "Here are some tips for organizing..."

They read and chat. That's it.

✅ OBSICLAUDE

You: "Organize my notes"
Claude: *finds orphans → reads each → categorizes
        → creates index → adds wikilinks*
        Done! Created "Index" with 23 links.

It thinks, acts, and does the work.

OBSICLAUDE runs an agentic loop — the same ReAct (Reason + Act) pattern behind AI coding assistants like Cursor and Claude Code. Claude picks a tool, observes the result, and repeats — autonomously — until the job is done.


🪄 Magic Write

The fastest way to create notes in Obsidian.

Click Magic Write on the welcome screen → a guided modal appears:

StepWhat you do
📝Describe what you want written
🎨Pick a style — each one generates different structure, frontmatter, and tone
📂Choose a folder to save
🔗Attach references — browse your vault, pick notes/folders as source material
✨Click "Write it" — Claude creates, formats, links, and opens the note

8 Writing Styles — Each One Different

StyleFrontmatterStructureTone
📄 Notetags, date, aliasesClean headings, TL;DRDirect, personal
✍️ Blog Posttags, author, status, category, descriptionHook → Sections → TakeawaysEngaging, authoritative
📋 Summarytags, source, status: summaryOverview → Bullets → Key Takeaways (≤500 words)Neutral, dense
👥 Meetingtags: [meeting], attendees, status: actionableAgenda → Decisions → - [ ] Action ItemsFactual, brief
📖 How-totags: [guide], difficulty, estimated-timePrerequisites → Numbered Steps → TroubleshootingImperative ("Click", "Run")
🔬 Researchtags: [research], questionResearch Q → Findings → Analysis → Open QuestionsAcademic but readable
🎭 Creativetags: [creative], mood, inspirationFree-form, poetry OKLiterary, sensory
🗺️ MOCtags: [MOC, index], scopeOverview → Categorized [[wikilinks]]Navigational hub

⚡ Features

🤖 Agentic Loop

20 tools · up to 15 iterations
Claude autonomously plans and executes multi-step operations

🌊 Real-Time Streaming

Token-by-token with live indicator
See what Claude is doing — which tools, how long, what phase

📎 Drag & Drop

Files + entire folders
5 resolution methods ensure it works everywhere

🔍 Vault Overview

Structure scan · Tag health
Health Score (A–F) with prioritized action plan

⚡ Slash Commands

8 instant actions
/explore /analyze /tags /orphans /recent /search /duplicates /links

🛑 Stop & Follow-Up

ESC to interrupt · queue follow-ups
Send corrections while Claude is still thinking

🧩 Multi-Model

Sonnet · Opus · Haiku
Switch mid-conversation from the header

🌍 Auto Language

Write in any language
Claude responds in your language automatically

🔒 Privacy First

Direct to Anthropic · no telemetry
Your API key, your data, zero middlemen


🔧 Vault Tools (20)

ToolWhat it doesToolWhat it does
📝create_noteCreate with frontmatter & wikilinks📖read_noteRead content & metadata
✏️edit_noteReplace, append, prepend, find-replace🗑️delete_noteSafe trash
📦move_noteMove or rename📂list_filesBrowse vault tree
📁create_folderNew folders🔍search_notesFull-text search
🏷️get_frontmatterRead YAML metadata🏷️set_frontmatterUpdate metadata
🔗get_backlinksWho links TO this note🔗get_outgoing_linksLinks FROM this note
📊analyze_vaultFull vault statistics👻find_orphan_notesUnlinked notes
💡suggest_linksAI link recommendations🏷️batch_frontmatterBulk metadata update
👯find_duplicate_notesSimilar note detection📌get_active_noteCurrently open note
📂open_noteOpen in editor🏷️get_all_tagsTag usage stats

🏗️ Architecture

  You say something
       ↓
┌──────────────────────────┐
│   Claude thinks & plans  │
│          ↓               │
│   Picks a tool ──────────│──→  20 vault tools
│          ↓               │
│   Observes the result    │
│          ↓               │
│   Done? Or loop? ────────│──→  up to 15 iterations
└──────────────────────────┘
       ↓
  Final response ✨

Tech stack: Obsidian API + Anthropic API. That's it. No LangChain, no vector DB, no local model, no dependencies.


⚔️ vs. The Competition

FeatureOBSICLAUDECopilotSmart ConnectionsText Generator
Agentic tool use20 tools❌❌❌
Create/edit/move notes✅❌❌Append only
Magic Write (guided)✅ 8 styles❌❌❌
Multi-step automation15 iterations❌❌❌
Real-time streaming✅✅❌✅
Drag & drop context✅ Files+Folders❌❌❌
Vault health check✅ A–F Score❌❌❌
Orphan/duplicate finder✅ Built-in❌Similarity❌
Batch frontmatter✅❌❌❌
Follow-up queue✅❌❌❌
Model switchingS/O/HGPT onlyVariesVaries
PrivacyDirect to APIDirectLocalVaries

📦 Installation

⚡ Quick Install (BRAT)

1. Install BRAT plugin → Settings → Add Beta Plugin
2. Enter: CRtheHILLS/obsiclaude
3. Enable OBSICLAUDE → Set your Anthropic API key

🔧 Manual Install

Download main.js + styles.css + manifest.json from Releases → copy to .obsidian/plugins/obsiclaude/ → enable → set API key.

🛠️ Build from Source

git clone https://github.com/CRtheHILLS/obsiclaude.git
cd obsiclaude && npm install && npm run build

🚀 Quick Start

StepAction
1️⃣Click the ✨ sparkle icon in the left ribbon
2️⃣Get your API key at console.anthropic.com
3️⃣Paste it in OBSICLAUDE settings
4️⃣Click Magic Write or just start chatting

No config files. No YAML setup. No templates. Just works.


🗺️ Roadmap

  • 📋 Community plugin store submission
  • 🧩 Template system for workflows
  • 🕸️ Canvas/graph view integration
  • 🎤 Voice input support
  • 🔌 Plugin API for custom tools
  • 📊 Vault analytics dashboard

🤝 Contributing

Contributions welcome! PRs, bug reports, feature requests — all appreciated.

fork → git checkout -b feature/amazing-thing → commit → PR

Found a bug? Open an issue.


⬆ back to top

Built with ☕ and obsession by CRtheHILLS

MIT License © 2026


If OBSICLAUDE helps you, consider giving it a ⭐ — it helps others discover it!

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.