WiseMindAI Sync (Obsidian plugin)

Sync Markdown between Obsidian and WiseMindAI on your computer: import notes into WiseMindAI, or write WiseMindAI content back to Obsidian. Data goes through the local API and does not connect directly to the WiseMindAI database.

Before you start

1. Install and launch WiseMindAI, and turn on the local API (default http://127.0.0.1:38221).
2. In Obsidian, install and enable WiseMindAI Sync. If you changed the API port, update the address in the plugin settings.

Plugin installation

Option 1: Obsidian Community Plugins (recommended)

Turn off Safe mode, open Settings → Community plugins, search for WiseMindAI Sync, and install. You can also click the button below to open the community plugin page in your browser and use Add to Obsidian.

Open Obsidian plugin page

Option 2: Manual install (GitHub)

Download the release archive from GitHub, extract it, and copy the plugin files into your vault’s plugin folder. Click the button below to open the releases page.

Open GitHub Releases

1. After extracting, confirm the folder contains main.js, manifest.json, and styles.css (plus any other files included in the release, if present).
2. Create the folder .obsidian/plugins/wisemindai-sync/ in your vault and put the files there (the folder name must match the id in manifest.json).
3. In Obsidian, go to Settings → Community plugins and enable WiseMindAI Sync.

Open the sync console

Use the WiseMindAI Sync icon in the left sidebar, run WiseMindAI Sync: Open sync console from the command palette, or use the entry on the bottom status bar.

Sync workflows

Obsidian → WiseMindAI

1. Set direction to Obsidian -> WiseMindAI.
2. On the left, pick notes or folders; on the right, pick where to save in WiseMindAI (notes, documents, or knowledge base).
3. Optionally enable Overwrite existing, then click Run sync.

The default knowledge base name Obsidian Import can be changed in settings.

WiseMindAI → Obsidian

1. Set direction to WiseMindAI -> Obsidian.
2. Choose the source type (documents / notes / knowledge base) and the items to sync.
3. Choose Obsidian destination folders; optionally use Include folders for hierarchy and Overwrite existing.
4. Click Run sync.

The default write root folder name is WiseMindAI (changeable in settings).

Other features

• Right-click: Send a file, folder, current note, or selected text to WiseMindAI quickly (destination and duplicate rules follow plugin settings).
• Sync presets: Save a scope you use often and run it in one step next time.
• Sync history: Review each run’s outcome and counts.

Duplicates: Modes include Update, Skip, and Create copy; enabling Overwrite existing leans toward update. The plugin writes source markers to help track items across syncs.

Plugin settings (summary)

Item	Default
Local API	http://127.0.0.1:38221
Obsidian write root	WiseMindAI
Default knowledge base name	Obsidian Import
Duplicate handling	Choose in settings

Use Test WiseMindAI connection in settings to verify connectivity.

Privacy

Only connects to 127.0.0.1 on your machine; nothing is uploaded to third-party servers.

FAQ

Cannot connect to WiseMindAI
Make sure the app is running, the local API is on, and the address and port match your settings.

Some Obsidian files are missing
Only Markdown is handled; .obsidian, trash, hidden folders, and oversized files are skipped.

Some WiseMindAI items are missing
Mainly syncs notes, documents, and knowledge base documents that can become Markdown; items without readable body text may not appear.

Will my Obsidian file names change?
Importing into WiseMindAI does not rename original Obsidian files. Writing back to Obsidian creates .md files from WiseMindAI content titles.