Mindo

Mindo is a local-first AI companion for Obsidian. It can chat with the active note, search the vault, create and edit Markdown notes, run local voice workflows, and maintain a structured Mindo Wiki memory layer.

Repository: https://github.com/TheRofli/mindo

Note: the public product name, repository, Obsidian plugin id, and release folder are now mindo.

Features

• Active-note aware chat with vault and web context.
• Tool routing for opening notes, creating notes, replacing text, undoing changes, and running research workflows.
• Mindo Wiki memory with Raw, Wiki, Schema, Inbox, Prompt Library, and maintenance files.
• Real source references for vault notes and web results.
• Attachments for images, PDF/text files, and dragged files.
• Local STT/TTS helpers for Parakeet/faster-whisper and Silero/Kokoro-style speech workflows.
• Optional Rust sidecar (contex-core) for faster vault search, resolver scoring, and RAG indexing.

Install For Local Testing

1. Copy or clone this repository into your vault plugins folder:

   Vault/.obsidian/plugins/mindo

2. Install dependencies:

   npm install
   

3. Build:

   npm run build
   

4. Enable Mindo in Obsidian community plugins.

Mindo Wiki Initial Build

Open Obsidian's command palette and run:

Mindo: Initialize Wiki

Or open Settings -> Mindo -> Wiki -> Mindo Wiki Initial Build and click Initialize / repair.

This creates or repairs:

• Mindo Wiki/Raw
• Mindo Wiki/Wiki
• Mindo Wiki/Schema
• Mindo Wiki/Inbox
• Mindo Wiki/Wiki/Prompts/Prompt Library.md
• Mindo Wiki/Schema/prompts.jsonl

Development

npm run test
npm run core:test
npm run build
npm run verify

Build the Rust sidecar:

npm run core:build
npm run core:install

Runtime Permissions

Mindo is desktop-only because it can start local helper processes for STT/TTS and the optional Rust search sidecar. That requires Node's child_process module and limited filesystem access for bundled runtime files, local logs, and generated release assets. Local settings and API keys stay in Obsidian's plugin data file and must not be committed.

Package a clean release folder:

npm run package

The release output is written to:

dist/mindo

Publishing

Read the release docs before making the repository public:

• docs/GITHUB_RELEASE_AND_COMMUNITY_SUBMISSION.md
• docs/PUBLICATION_SECURITY.md

Mindo is released under the MIT license. See LICENSE.

Release Notes

For an Obsidian release, upload at minimum:

• manifest.json
• main.js
• styles.css

If you want bundled local acceleration/runtime helpers, include the generated dist/mindo folder contents from npm run package.

Never publish data.json; it contains local settings and API keys.