by coherence-wizard
Organize, summarize, split, merge, and refine notes with Ollama and bulk file tools.
Coherence Wizard
Organize, summarize, split, merge, and refine notes in Obsidian. Coherence Wizard combines bulk file tools with optional AI processing through Ollama.
Install
Requires Obsidian desktop 1.13.0 or later. Mobile is not supported.
Install from the Obsidian community directory, or search for Coherence Wizard in Settings → Community plugins → Browse.
For manual installation:
- Download
main.js,manifest.json, andstyles.cssfrom the latest release, or download and extractcoherence-wizard-0.0.36.zip. - Put those three files in
<your vault>/.obsidian/plugins/coherence-wizard/(use your configured settings folder if it differs from.obsidian). - Restart Obsidian, open Settings → Community plugins, and enable Coherence Wizard.
Back up your vault and try the tools on copied notes before running bulk operations.
Get started
Open Settings → Coherence Wizard to configure the tools. Use the command palette, a file or folder's context menu, or the Open dashboard command to start a workflow. Review each dialog's options before running it.
For AI tools, install Ollama, download a model appropriate for your hardware, and run the server. Set the Ollama URL (default http://localhost:11434) and select an installed model in each tool. Ollama and models are installed separately; the plugin never installs them. File operations do not require Ollama.
The example dictionaries and folder names are generic. Replace them with your own categories and aliases in settings. In Parse and Copy, enter lines such as Work: #work or Ideas: #ideas and select a destination folder. In the censor dictionary, use Example Name, Example Variant = Alias.
Tools
- Summarizer: adds or replaces summaries and can generate filenames. Review overwrite and rename options.
- Wisdom and Generalizer: create rewritten notes using Ollama prompts.
- Atomizer: splits notes by headings, dates, or dividers.
- Categorizer: adds categories as tags or backlinks, with optional moves and copies.
- Chrono Merge: merges related notes, then sends source notes to the configured trash after saving the result.
- Concatonizer: combines files into a single document.
- Parse and Copy: copies matching content into category folders; repeated runs can append content again.
- Smart Move: merges folder contents into a destination. Conflicting file names get a numeric suffix; existing destination files are preserved.
- Date Fix: changes filenames to a configured date format.
- YAML Template: applies frontmatter keys and ordering.
- Deduplication: finds matching files and lets you send selected duplicates to trash.
- Rating: writes an AI-generated rating to frontmatter.
- Censor and Distill: replace configured terms or produce revised text for review. These tools do not guarantee anonymization; inspect their output before sharing.
Some tools modify existing notes or previously generated output. There is no plugin-wide undo or automatic backup. Trash follows Obsidian's configured deletion preference; a failed batch can leave some operations completed.
Privacy and network use
AI requests send note content, filenames included in prompts, instructions, and applicable dictionary text to the Ollama URL you configure. Model lists are also requested from that endpoint when relevant settings or dialogs are opened. With a local server and local models, processing stays on that computer. A remote server or cloud-backed model can send this data elsewhere; its operator controls handling and retention.
The plugin has no analytics, telemetry, advertising, remote images, account requirement, or paid features. It does not access files outside the vault. Settings and user dictionaries are saved locally in the plugin's data.json; do not include that file when sharing the plugin. The release contains generic examples only.
Build and check
Use Node.js 22 or later:
npm ci
npm run lint
npm run build
npm test
build includes TypeScript checking and produces main.js. Tests exercise collision handling and save-before-trash ordering using a simulated vault. Lint uses Obsidian's recommended rules; one advisory remains for the existing tabbed settings interface, which does not expose individual settings to Obsidian's newer settings search.
GitHub Actions checks pushes and pull requests. To release a future version, update manifest.json, package.json, the lockfile, and versions.json; push a tag matching the version exactly, without a v prefix. The release workflow checks version consistency and attaches the three installable files and a ZIP.
Support and license
If you find the plugin useful, you can support development. Donations are optional.
Report reproducible problems through GitHub issues. Use example notes and remove personal information from reports.
MIT license. Coherence Wizard is an independent community project.
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.