Vault Audit AI

by Zinvernix
5
4
3
2
1
Score: 55/100

Description

Local vault checks, semantic search, connection review and spaced repetition for Obsidian.

Reviews

No reviews yet.

Stats

32
stars
3,228
downloads
3
forks
140
days
1
days
1
days
158
total PRs
10
open PRs
1
closed PRs
147
merged PRs
0
total issues
0
open issues
0
closed issues
589
commits

Latest Version

2 days ago

Changelog

Veynrel 2.4.0

A redesigned Obsidian workspace for understanding your vault, finding notes by meaning, exploring connections, and taking deliberate actions on your notes.

What's new

  • Overview: a compact home for vault findings, semantic search, tool shortcuts, bulk audit, and Recall.
  • Vault Check: inspect broken links and supported organization findings, see the source note, filter results, and prepare supported fixes.
  • Semantic exploration: distinct Map, Families, Notes & Pairs, Neighborhood, Connection Opportunities, Global Focus, and Similar Notes views. Semantic similarity is a suggestion to review—not proof of a duplicate.
  • Floating actions: an optional draggable toolbar inside Obsidian for style suggestions, flashcard generation, tags, atomization, and semantic search. Style edits show a preview before Apply and support native editor Undo/Redo for the supported path.
  • Tools and Bulk Audit: a redesigned tool selector and clearer entries for Bulk Audit, Deep Audit, atomization, and MOC preparation; individual operations retain their own safeguards.
  • Recall: offline practice of existing Markdown flashcards, with optional, consent-driven card generation.
  • Safer streaming: when a user switches to another note, the former note's streaming operation is cancelled so that late tokens are not inserted into the new note.

Changes from 2.3.1

  • Veynrel Studio and its online Community catalog are temporarily hidden. Previously saved recipes, journals, and other user data are retained. Their write-confirmation flow must be reviewed before re-enabling Studio.
  • Excalidraw diagram generation has been retired. Existing diagrams are not deleted.

Privacy and data safety

Local vault checks and manual Recall don't require a model or API key. Semantic indexing and generative operations use the configured provider only when explicitly initiated; remote endpoints may receive selected note content or queries. Review every proposed change before applying it. There is no universal Undo for Bulk Audit, Deep Audit, MOC, or atomization.

Installation and compatibility

  • Requires Obsidian 1.13.7 or newer for 2.4.0. The earlier 2.3.1 release remains available for older supported versions through the compatibility index.
  • Existing plugin ID: ai-knowledge-hub. Do not create a second plugin directory named veynrel.
  • Back up your vault and .obsidian/plugins/ai-knowledge-hub/ (including data.json), semantic indexes, Recall state, and journals before upgrading.
  • Update via Obsidian Community plugins once available, or install main.js, manifest.json, and styles.css from this same release into the existing plugin folder.
  • If you need to roll back after Recall's persisted data is migrated, restore the complete matching pre-upgrade backup, not only the old plugin binary. Preserve post-upgrade note changes separately.

Known limitations

  • A cold-start graph on a 10,000-note vault may report stale metadata before Obsidian finishes preparing its cache. In the tested control, manually refreshing the graph after cache readiness represented all 10,000 paths. The cold-start failure is not considered fixed.
  • Global semantic focus retains an explicit limit of 500 eligible documents; oversized requests are refused rather than silently sampled.
  • Resume Batch and the R07 text-portrait feature are deferred; an interrupted batch cannot resume automatically.
  • Physical mobile devices, screen readers, all themes/OSes, physical GPU/IME, and real-provider semantic quality have not been fully verified.
  • The Studio Community document-ownership bug remains a reactivation blocker; the affected UI is disabled in this release.

Full guides, source, and verification: README · 2.4.0 technical notes · Issues.

README file from

Github

Veynrel — Your notes. Connected.

Veynrel

Understand your vault. Find ideas by meaning. Make changes on your terms.

Veynrel is an Obsidian plugin for local vault checks, semantic search and exploration, safe note actions, and spaced repetition. Start with the overview, investigate a finding, or open a tool directly from your note.

Install in Obsidian · Get started · Explore the tools · Privacy · Releases · Report an issue

At a glance

Open Veynrel → Overview to see your vault's current findings, semantic index status, Recall queue and the main tools. The figures are observations from your own vault; missing data is shown as missing, not scored as healthy.

Veynrel overview in Obsidian, using synthetic test notes

Recorded in Obsidian using synthetic notes. Counts in the screenshot are not benchmarks or results from a user's vault.

What you can do

Area Purpose Needs an AI provider?
Overview A compact starting point for checks, search, tools and Recall No
Vault Check Inspect broken wiki-links and supported structural findings; filter, open evidence and prepare fixes No for local checks
Semantic search Find passages by meaning, even when they use different words Yes: a configured embedding model (local Ollama or a remote provider)
Semantic exploration Explore the map, overlapping families, note pairs, neighborhoods, possible connections, global focus and similar notes Requires an existing semantic index for semantic results
Tools & Bulk Audit Choose supported note actions, Deep Audit, atomization and MOC preparation Depends on the action
Recall Practice existing Markdown flashcards using FSRS-based scheduling No; generation of new cards requires a configured model

Review relationships instead of guessing

Semantic similarity is an invitation to inspect a pair, not proof of a duplicate, topic or error. The semantic area has seven separate entry points: Map, Families, Notes & Pairs, Neighborhood, Connection Opportunities, Global Focus, and Similar Notes. Structural Markdown links and semantic proximity are shown as different evidence. Global focus keeps its documented computation limit rather than silently sampling a subset.

Neighborhood results with evidence excerpts from synthetic notes

Work from the note you are editing

Enable the optional Veynrel floating actions command to open a movable toolbar inside Obsidian. It includes style suggestions with preview → apply → native undo, flashcard generation, tags, atomization and semantic search. The toolbar remembers the originating editor and selection; switching notes does not authorize writing to the new one.

Floating toolbar in Obsidian on a synthetic note

The ring-shaped Tools selector shows an explanation before opening an operation. Bulk Audit, Deep Audit, atomization and MOC retain distinct execution and confirmation flows; they do not all share a universal Undo guarantee.

Get started

  1. Open Obsidian's Command palette and choose Veynrel: Open Veynrel, or use the Veynrel ribbon action.
  2. On Overview, open Check and run a local vault check. A model/API key is not needed.
  3. Select a finding to inspect its source note. Supported changes open a separate preparation/confirmation flow.
  4. To search by meaning, configure an embedding provider in Settings → Veynrel and explicitly build the first index. Search queries use the configured provider; indexing may send note chunks to that provider.
  5. To use the floating toolbar, invoke its show/hide command while a Markdown note is active. No shortcut is assigned automatically.

Recall without AI

Put manually authored cards in a Markdown note under a Flashcards heading:

## Flashcards
What does a cache store?::Reusable results.
When does a cached value expire?::When its source changes.

Then open Recall from Overview to practice. The generated-card workflow is optional and asks before calling a model or modifying the note.

Privacy and control

  • Local Health, link structure and Recall can work without an AI provider. Opening Overview does not automatically scan all notes, build embeddings or issue a model request.
  • Embeddings are generated by the endpoint you configure. A remote provider may receive note chunks and queries; a local model can keep inference on your device.
  • Generative actions require explicit initiation and have operation-specific preview, confirmation and recovery rules. Source changes are checked before supported edits. AI suggestions are not factual verification.
  • No built-in telemetry is used to track your vault activity. An optional Companion connection is a separate opt-in integration.
  • Models or providers may charge for requests even if you cancel locally. Review your provider's privacy and billing terms before sending private notes.

Provider and privacy details · Safety, history and recovery

Install

This guide describes the 2.4.0 release candidate. Check the published releases for the version currently distributed.

Obsidian Community directory

In Obsidian, open Settings → Community plugins → Browse, search for Veynrel, then install and enable it. If the directory is still processing a new release, check the GitHub releases for its published status.

Manual installation

Download main.js, manifest.json and styles.css from the same GitHub release. Place them in the existing plugin directory:

<your-vault>/.obsidian/plugins/ai-knowledge-hub/

Keep the existing data.json, semantic indexes, Recall data and operation journals. Back up the plugin data and vault before upgrading; do not delete the folder or rename it to veynrel. The plugin ID remains ai-knowledge-hub.

Compatibility: The 2.4.0 candidate requires Obsidian 1.13.7 or newer. The compatibility index retains 2.3.1 for older hosts down to 1.8.7. Mobile remains eligible under the manifest. Current native evidence focuses on Obsidian 1.13.7 on Linux desktop; it does not establish physical mobile, every theme, screen reader or operating system support.

What's temporarily unavailable

Studio and its online Community catalog are hidden in this version while that experience is reconsidered. Existing Studio recipes and stored user data are not intentionally removed. The earlier Excalidraw diagram generator is also retired; existing drawings are yours and remain untouched. These features may appear in older screenshots and guides, but they are not current entry points.

The header art is retained from an older release and still mentions Editable diagrams; that label is historical and does not describe the current feature set.

Contribute and support

Found a broken link, unexpected AI behavior or a difficult workflow? Open a GitHub issue with steps to reproduce, Obsidian version and a sanitized screenshot. Please don't upload private notes, credentials, API keys or personal vault indexes.

Contributing · Security · Support · License (MIT) · Release history