Vaultkeeper AI

An AI assistant that actually knows your vault, and never changes a note without showing you first.

Claude · Gemini · OpenAI · Mistral · or your own local model

Vaultkeeper AI lives in your sidebar and works with your notes. Ask it questions about your vault, have it write new notes in the same style as your existing ones, reorganise folders, tag and link things, or plan out big multi-step changes. You stay in control: every edit is shown as a diff you can accept, reject, or send back with feedback, and anything it touches can be restored later.

Why Vaultkeeper?

• It reads your vault, not just your prompt. It searches, reads and lists your notes (including PDFs, Word, PowerPoint, Excel and images) so its answers and new notes fit what's already there.
• Nothing changes behind your back. Proposed edits appear in a side-by-side diff. Accept, reject, or tell it what to fix. Changed your mind later? Restore any file to its previous or original version.
• Use the AI you want. Bring a key for Claude, Gemini, OpenAI or Mistral, or run it fully offline against a self-hosted model server.
• Your private notes stay private. Exclude folders or files with simple patterns and the AI can't see, search, or touch them.

What people use it for

"Add a new item card to /Campaign 1 Items for 'Alchemy Jug'. Match the format used by @Staff of Healing."

"Summarise this week's /Daily Notes and pull out any action items I haven't finished."

"Find every note tagged #project/alpha and build a single overview page linking to them."

"Go through my /Inbox folder, file each note into the right place, and add tags we already use."

"Read the PDF I just dropped into /Papers and write a literature note in my usual template."

See it in action

✅ Review every change before it happens

When the AI wants to create, edit, move or delete something, you get a clear side-by-side diff. Accept it, reject it, or click Suggest changes to send it back with notes. Working on lots of files at once? Review them one by one or accept/reject the rest in bulk.

🔗 Catches broken links before they land

Vaultkeeper checks proposed changes for continuity problems, like wikilinks pointing at notes that don't exist, and flags them right in the review screen so your vault doesn't fill up with dead links.

↩️ Undo anything

Every note the AI creates, edits or deletes (even PDFs and images) can be restored to its previous or original version, straight from the diff viewer.

📋 Planning Mode for the big jobs

For larger tasks, a planning agent explores your vault first, asks clarifying questions if it needs to, and proposes a step-by-step plan. You approve it, reject it, or suggest changes. Then it works through the steps one at a time, with a supervising agent checking each result and adjusting the plan if something unexpected comes up.

⚡ Quick Actions on any note

Right-click (or use the editor toolbar button) for one-click helpers that work on your selection or the whole note:

🧠 It remembers how you work

Tell it your conventions once ("daily notes go in /Journal, use #status/ tags") and it remembers across conversations. Memories live in a plain Markdown file you can read and edit yourself.

🌐 Web search and web pages

Flip on web search per message when you need current information, or let it read a URL you paste and turn it into a note.

📱 Works on mobile

Full functionality on phone and tablet, with touch-friendly approve/reject controls.

Get started in 2 minutes

1. Install: In Obsidian, go to Settings → Community plugins → Browse, search for Vaultkeeper AI, then Install and Enable.
2. Pick a model: In the plugin settings, paste an API key from Anthropic, Google AI Studio, OpenAI or Mistral. Or choose Local and point it at your self-hosted, OpenAI-compatible server (no key needed).
3. Open the chat: Click the Vaultkeeper icon in the left sidebar and start asking.

Tip: Type @ to mention a file, # for a tag, or / for a folder, and the AI gets that context straight away.

It starts in Read-only mode, so it can explore but can't change anything. Switch to Edit mode (pencil icon) when you want it to make changes.

Your data, your rules

• You choose where your notes go. With a cloud provider, the content you share goes directly from Obsidian to that provider, with no middleman server. With a local model, nothing leaves your machine.
• API keys stay in your vault.
• Exclude anything sensitive. Patterns like journal/** or *.secret.md make files completely invisible to the AI: they won't appear in searches and can't be read or modified.
• Conversations are saved locally in your vault.
• Open source and fully auditable.

Cost: The plugin is free. Cloud providers bill you directly for usage at their normal API rates. Local models cost nothing to run.

Full guide

@meeting-notes What action items did we discuss?
#project/alpha Show me all notes about project alpha
/Daily Notes Summarise this week's daily notes

cd /path/to/vault/.obsidian/plugins/
git clone https://github.com/andy-stack/vaultkeeper-ai.git
cd vaultkeeper-ai
npm install
npm run dev     # watch mode
npm run build   # production build
npm test        # Vitest

Feedback & support

Found a bug or have an idea? Open an issue. I read all of them. Pull requests are currently closed (see CONTRIBUTING.md).

If Vaultkeeper saves you time, a ⭐ on GitHub really helps other people find it.

License

MIT