Vaultend

Focus on writing. Let AI handle the organization.

An AI-powered vault maintenance plugin for Obsidian. Automatically tag, link, and organize your notes — with full privacy control and undo safety.

Table of Contents

• Quick Start
• Features
  • Cost Transparency
  • Note Organizer
  • Organize Folder
  • Organize Tags
  • Vault Maintenance
  • Activity Log
  • Privacy Protection
• Commands
• Settings
• Installation
• Internationalization
• Compatibility
• Known Limitations
• Development
• Contributing
• License

Quick Start

1. Install the plugin (see Installation)
2. Go to Settings → Vaultend → AI Provider
3. Select your provider (OpenAI, Google Gemini, Ollama, or Custom) and enter your API key
4. Open the Command Palette (Ctrl/Cmd + P) and try Organize Current Note

That's it. The plugin is ready to organize your vault.

Features

Cost Transparency

Every AI feature in this plugin shows token usage and estimated cost after each call. No hidden spending — you always know exactly what you're paying for.

This is a deliberate design choice: AI tools should be transparent about resource consumption.

Note Organizer

Analyze the active note with AI — tag and link — all from an interactive modal.

How to use: Open a note → Ctrl/Cmd + P → "Organize Current Note"

This command only appears when a note is actively open in the editor.

The AI will:

1. Suggest tags using a hybrid strategy — strongly-matching existing tags are preferred (per-tag confidence ≥ 0.7), and new tags are freely created when no strong match exists. New tags never semantically overlap with existing ones.
2. Propose links via AI analysis with vault existence validation — only notes that actually exist in your vault are suggested, preventing broken links
3. Summarize the note content for quick reference

Results open in an interactive modal where you can review and edit everything before applying:

Nothing changes until you click Apply All. You're always in control.

Organize Folder

Batch-organize any folder in your vault with AI. Pick a folder, and the plugin suggests tags and links for each note — with full per-note review in a side panel.

How to use:

• Command Palette: Ctrl/Cmd + P → "Organize Folder" → select a folder from the fuzzy search modal
• Context menu: Right-click a folder → "Organize Folder"

How it works:

1. Select a target folder (any folder in your vault)
2. The plugin scans all notes in that folder (progress shown in a side panel with progress bar, counter, and cancel button)
3. Each note gets sent to AI for tagging and link suggestion
4. Results open in a side panel with per-note detail

Result panel features:

Two modes:

• autoApply=off (default): Review each note's suggestions, check/uncheck, then Apply
• autoApply=on: Changes are applied automatically; use Undo to revert any unwanted change

How AI decides tags and links:

• Tags: Hybrid strategy — strongly-matching existing tags are preferred (per-tag confidence ≥ 0.7), new tags are created when no strong match exists. New tags never semantically overlap with existing ones.
• Links: AI analyzes note content and selects related notes from your vault. Every suggested link is validated against actual vault notes — hallucinated links are filtered out.

Organize Tags

Find and merge duplicate tags across your vault using AI-powered similarity detection.

How to use: Ctrl/Cmd + P → "Organize Tags"

How it works:

1. The plugin collects all tags in your vault
2. Stage 1 — String normalization: groups tags that differ only in casing, hyphens, or pluralization (e.g., #project-management vs #ProjectManagement)
3. Stage 2 — AI embedding similarity: detects semantically similar tags across languages (e.g., #meeting-notes vs #회의록)
4. Results open in a side panel showing each duplicate group with the canonical tag and its variants

Result panel features:

Merge replaces all variant tags with the canonical tag across every affected note's frontmatter. Each merge is recorded in the Activity Log with full undo support.

Vault Maintenance

Scan your vault for structural issues and fix them in bulk. No AI required — all detection is local analysis (link graph, file content, keyword matching).

How to use:

• Full vault: Ctrl/Cmd + P → "Run Maintenance"
• Single folder: Right-click a folder → "Scan this folder for maintenance"

Issue Types

Severity Badges & Sorting

Results are sorted by severity (Critical → Warning → Info) so you always see the most urgent issues first. Each section header shows a color-coded badge.

Filtering

Narrow down results in large vaults:

• Severity chips — toggle entire severity levels on/off
• Type chips — toggle individual issue types
• Text search — real-time path-based filtering (type a folder name or note title)

Actions

Each issue has contextual action buttons:

Batch Operations

Select multiple items and act on them at once:

1. Check the Select All checkbox at the top of a section (or check individual items)
2. Click an action button: Archive, Delete, Dismiss, etc.

Undo & Restore

Made a mistake? Every action is recoverable:

• Dismiss: Shows strikethrough text with an inline Undo button — click to restore the item immediately
• Delete: Recorded in the Activity Log with full content backup. Click Restore in the log to bring the note back.
• Archive: Recorded with the destination path. Click Restore in the log to move the note back to its original location.

Automatic Scheduling

Enable in Settings to run maintenance on a timer (default: every 60 minutes). The plugin runs in the background and only notifies you when issues are found.

Activity Log

Track every action the plugin takes — and restore previous states.

How to open: Ctrl/Cmd + P → "Open Maintenance Log"

What gets recorded:

• Note deletions (with previous content for restore)

• Note archival (with destination path for restore)

• Tag additions

• Link removals

• Issue dismissals

• Note classifications

• Restorations (when you use the Restore button)

Restore button: Entries that modified or deleted content show a red Restore button. Click it to revert the note to its state before the action. Archived notes are moved back to their original location. The restoration itself is also logged.

Refresh: Click the ↻ button to reload the latest entries without restarting Obsidian.

Privacy Protection

Fine-grained control over what gets sent to AI. Configure rules in Settings → Privacy.

Content redaction example: Pattern password:\S+ replaces password:abc123 with [REDACTED] before sending. Your original note is never modified. For simple word masking, just type the word (e.g., vaultend) — regex knowledge is not required for basic use.

Key guarantee: Privacy rules run before ANY data leaves your device. AI never sees excluded or redacted content.

Commands

All commands are accessible via Ctrl/Cmd + P (Command Palette).

| Organize Current Note | Tag and link the active note | Yes | | Organize Folder | Select a folder and batch-organize its notes | Yes | | Organize Tags | Find and merge duplicate tags across the vault | Yes | | Run Maintenance | Scan entire vault for issues | Partial | | Scan this folder for maintenance | Right-click context menu | Partial | | Organize Folder (context menu) | Right-click a folder to organize it | Yes | | Open Maintenance Log | Show activity log sidebar | No |

"Partial" means orphan/broken-link/empty/duplicate detection works offline, but missing-tag suggestions require AI.

Settings

Access via Settings → Community Plugins → Vaultend.

Language

AI Provider

Embedding support by provider: All providers support the core features (classification, tagging, organization, maintenance). Embedding-based features (tag similarity ranking, cross-language tag resolution, link suggestions) require a provider with embedding API support.

Provider	Chat/Completion	Embeddings
OpenAI	Yes	Yes
Google Gemini	Yes	Yes
Ollama (Local)	Yes	Yes (requires embedding model, e.g. nomic-embed-text)
Custom	Yes	Depends on endpoint

Note on DeepSeek: DeepSeek was removed in v1.0.2 because it does not provide an embedding API. Since Vaultend relies on embeddings for tag similarity, cross-language tag resolution, and link suggestions, using a provider without embedding support results in degraded functionality. DeepSeek users can use the Custom (OpenAI-compatible) provider option if they only need core features, but embedding-based features will not work.

Changes apply immediately — no restart needed.

Supported Models

The dropdown lists pre-defined models for each provider. You can also select Custom to enter any model ID manually.

Note: Model availability changes over time. If a listed model returns an error, check the official documentation links above for the latest status, or use the Custom option to enter a newer model ID. This list was last updated on 2026-07-15.

Organize Folder

Maintenance

Maintenance scans only Markdown (.md) notes. Non-text files such as Excalidraw and Canvas are automatically excluded.

Privacy Rules

Add rules in the Privacy section. Each rule has:

• Name — descriptive label
• Type — Folder exclude / Tag exclude / Properties exclude / Content redact
• Pattern — the folder path, tag, property key, or regex pattern

Installation

From Community Plugins

1. Open Settings → Community Plugins → Browse
2. Search "Vaultend"
3. Click Install, then Enable
4. Configure your AI provider in Settings

BRAT (Beta Testing)

1. Install BRAT
2. BRAT settings → Add Beta Plugin
3. Enter: dhwang0803-glitch/Vaultend
4. Enable Vaultend in Community Plugins
5. Configure AI provider and API key

Manual

1. Download main.js, manifest.json, styles.css from the latest release
2. Create .obsidian/plugins/vaultend/ in your vault
3. Copy the 3 files into that directory
4. Restart Obsidian → enable the plugin
5. Configure AI provider and API key

Build from Source

git clone https://github.com/dhwang0803-glitch/Vaultend.git
cd Vaultend
npm install
npm run build

Copy main.js, manifest.json, styles.css to your vault's plugin directory.

Mobile

The same 3 files go in .obsidian/plugins/vaultend/.

• With Obsidian Sync: Install on desktop — it syncs automatically
• Android: Internal Storage/Documents/Obsidian/[Vault]/.obsidian/plugins/vaultend/
• iOS: Files app → Obsidian → [Vault] → .obsidian/plugins/vaultend/

Internationalization

Change in Settings → Language. Views update immediately; command palette names update after restart.

Want to contribute a translation? See CONTRIBUTING.md for details.

Compatibility

AI Providers: OpenAI API, Google Gemini API, Ollama (local), Custom (OpenAI-compatible). Embedding-based features (tag similarity, link suggestions) require a provider with embedding support.

Known Limitations

Development

npm run dev        # Watch mode
npm run build      # Production build
npm run lint       # ESLint
npm run test       # Vitest (unit + integration tests)
npm run test:watch # Watch mode tests

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines on translations, bug reports, and pull requests.

License

MIT