OBSICLAUDE

unlisted

by CRtheHILLS

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

★ 3 starsUpdated 2mo agoMIT

View on GitHub

✨ OBSICLAUDE

Your vault. Claude's magic.

The first Obsidian plugin that lets Claude actually touch your vault.
Not just chat — right-click AI · @ mentions · create · edit · organize · analyze
Editor-integrated AI. 20 tools. Zero dependencies.

Get Started → · What's New · Features · Magic Write · Tools · Install

🆕 What's New in v1.2.0

🖱️ Right-Click AI Menu

Select text in any note → right-click → 5 AI actions directly in editor:

Summarize — condense selected text
Translate — auto-detect Korean/English
Improve — better clarity and flow
Explain — simplify complex text
Ask Claude... — custom prompt

Results inserted directly into your note. No sidebar needed.

⚡ New in This Release

@ Mentions — type @ in chat to search & attach files instantly
Vault Doctor — health diagnosis with auto-fix suggestions
Quick Actions — one-click shortcuts for common tasks
Quick Prompts — saves your frequent prompts, click to reuse
Typing Animation — smooth word-by-word response display
Status Bar — model name + token counter at bottom
Smart Frontmatter — always generates complete, standard YAML
Auto-Continue — long responses continue automatically (no truncation)

🧠 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:

Step	What 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

Style	Frontmatter	Structure	Tone
📄 Note	`tags, date, aliases`	Clean headings, TL;DR	Direct, personal
✍️ Blog Post	`tags, author, status, category, description`	Hook → Sections → Takeaways	Engaging, authoritative
📋 Summary	`tags, source, status: summary`	Overview → Bullets → Key Takeaways (≤500 words)	Neutral, dense
👥 Meeting	`tags: [meeting], attendees, status: actionable`	Agenda → Decisions → `- [ ]` Action Items	Factual, brief
📖 How-to	`tags: [guide], difficulty, estimated-time`	Prerequisites → Numbered Steps → Troubleshooting	Imperative ("Click", "Run")
🔬 Research	`tags: [research], question`	Research Q → Findings → Analysis → Open Questions	Academic but readable
🎭 Creative	`tags: [creative], mood, inspiration`	Free-form, poetry OK	Literary, sensory
🗺️ MOC	`tags: [MOC, index], scope`	Overview → Categorized `[[wikilinks]]`	Navigational hub

⚡ Features

🤖 Agentic Loop

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

🖱️ Right-Click AI

5 editor actions
Select text → right-click → Summarize, Translate, Improve, Explain

📎 Drag & Drop

Files + entire folders
5 resolution methods ensure it works everywhere

🩺 Vault Doctor

Diagnosis + auto-fix
Health Score (A–F) with "Want me to fix this?" prompts

⚡ 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)

	Tool	What it does		Tool	What it does
📝	`create_note`	Create with frontmatter & wikilinks	📖	`read_note`	Read content & metadata
✏️	`edit_note`	Replace, append, prepend, find-replace	🗑️	`delete_note`	Safe trash
📦	`move_note`	Move or rename	📂	`list_files`	Browse vault tree
📁	`create_folder`	New folders	🔍	`search_notes`	Full-text search
🏷️	`get_frontmatter`	Read YAML metadata	🏷️	`set_frontmatter`	Update metadata
🔗	`get_backlinks`	Who links TO this note	🔗	`get_outgoing_links`	Links FROM this note
📊	`analyze_vault`	Full vault statistics	👻	`find_orphan_notes`	Unlinked notes
💡	`suggest_links`	AI link recommendations	🏷️	`batch_frontmatter`	Bulk metadata update
👯	`find_duplicate_notes`	Similar note detection	📌	`get_active_note`	Currently open note
📂	`open_note`	Open in editor	🏷️	`get_all_tags`	Tag 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

Feature	OBSICLAUDE	Copilot	Smart Connections	Text Generator
Agentic tool use	20 tools	❌	❌	❌
Right-click AI menu	5 actions	❌	❌	❌
@ Mentions in chat	✅	✅	❌	❌
Magic Write (guided)	✅ 8 styles	❌	❌	❌
Vault Doctor (auto-fix)	✅ A–F Score	❌	❌	❌
Quick Prompts	✅ Frequency-based	❌	❌	Templates
Create/edit/move notes	✅	❌	❌	Append only
Multi-step automation	15 iterations	❌	❌	❌
Status bar (tokens)	✅	❌	❌	❌
Auto-continue (long text)	✅ Up to 3x	❌	❌	❌
Batch frontmatter	✅	❌	❌	❌
Model switching	S/O/H	GPT only	Varies	Varies
Privacy	Direct to API	Direct	Local	Varies

📦 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

Step	Action
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 (in review)
🖱️ Right-click AI menu (v1.2.0)
⚡ @ Mentions & Quick Prompts (v1.2.0)
🩺 Vault Doctor with auto-fix (v1.2.0)
🎯 Floating AI popup on text selection
🧩 Prompt templates as vault files
🔍 Semantic search (RAG)
🏠 Multi-model support (OpenAI, Ollama)
🕸️ Canvas/graph view integration

🤝 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

_{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.