Tools

Obsidian Mohini Sync

Name: Obsidian Mohini Sync
Rating: 3.5 (1 reviews)
Author: darshjme-codes

By darshjme-codes 👁 26 views ▲ 0 votes

Obsidian plugin that syncs your vault to OpenClaw AI agents (Shadow Army). Multi-agent orchestration, health monitoring, slash commands. Built as proof-of-concept for Greg Isenberg's Obsidian+Claude vision.

GitHub

Install

npm install
   npm

README

# 🪷 Mohini Shadow Sync - Obsidian Plugin

**Connect your Obsidian vault to Mohini's Shadow Army.** Bi-directional sync with OpenClaw workspace, slash commands for AI context injection, and health monitoring integration.

## 🎯 What It Does

This plugin transforms your Obsidian vault into a living context for AI agents:

- **📝 Bi-directional Sync** - Vault ↔ OpenClaw memory/ folder (realtime or scheduled)
- **🤖 Shadow Army Integration** - Spawn AI sub-agents directly from Obsidian with `/arise`
- **🔍 Context Injection** - Your notes become sub-agent context automatically
- **💓 Health Monitoring** - Sync health notes to Sewak-Vaidya (coming soon)
- **⚡ Slash Commands** - `/arise`, `/trace`, `/connect` for instant AI access

## 🚀 Installation

### Method 1: Manual Installation (Recommended)

1. **Download the plugin:**
   ```bash
   cd /path/to/your/vault/.obsidian/plugins/
   git clone https://github.com/darshjme-codes/obsidian-mohini-sync.git
   cd obsidian-mohini-sync
   ```

2. **Build the plugin:**
   ```bash
   npm install
   npm run build
   ```

3. **Enable in Obsidian:**
   - Open Obsidian Settings → Community Plugins
   - Disable Safe Mode (if enabled)
   - Enable "Mohini Shadow Sync"

### Method 2: From Release (Coming Soon)

Download the latest release from GitHub and extract to your `.obsidian/plugins/` folder.

## ⚙️ Configuration

1. Open **Settings → Mohini Shadow Sync**
2. Set **OpenClaw Workspace Path** (default: `/root/.openclaw/workspace`)
3. Choose **Sync Mode:**
   - **Realtime** - Instant sync on file changes (recommended)
   - **Manual** - Sync only when you trigger it
   - **Scheduled** - Auto-sync every N minutes
4. Configure **Sync Folders** (e.g., "Daily Notes, Projects, Health")

## 🎮 Usage

### Slash Commands

Add these commands via Command Palette (Ctrl/Cmd + P):

#### `/arise` - Spawn Shadow Agent
Summon an AI sub-agent to execute tasks:
```
/arise
> Analyze my daily notes and create a weekly summary
```

The agent spawns in OpenClaw, executes the task, and reports back.

#### `/trace` - Show Sync Status
Display current sync configuration and last sync time:
```
🪷 Mohini Shadow Sync Status
Sync Mode: realtime
Last Sync: 2026-02-24 05:30:15
Folders: Daily Notes, Projects, Health
OpenClaw Path: /root/.openclaw/workspace
Shadow Army: ✅ Enabled
```

#### `/connect` - Manual Sync Now
Force an immediate sync of all configured folders:
```
/connect
✅ Synced 127 files to OpenClaw
```

### Ribbon Icon

Click the **⚔️ sword icon** in the left sidebar for quick manual sync.

### Right-Click Menu

Right-click any note → **Sync to OpenClaw** to sync individual files.

## 🏗️ Architecture

### Sync Engine

```
Obsidian Vault                OpenClaw Workspace
└── Daily Notes/              └── memory/
    └── 2026-02-24.md    →       └── obsidian-sync/
└── Projects/                        └── Daily Notes/
    └── Ideas.md         →               └── 2026-02-24.md
```

- **Realtime Mode:** Uses `chokidar` file watcher for instant sync
- **Scheduled Mode:** Periodic batch sync (configurable interval)
- **Metadata Tracking:** `.sync-metadata.json` tracks sync state

### Shadow Agent Integration

When you use `/arise`:

1. Plugin creates task file in `memory/shadow-tasks/`
2. OpenClaw detects new task
3. Mohini spawns sub-agent with task context
4. Sub-agent executes and reports back
5. Results appear in OpenClaw logs

## 🎨 Features

### Current (v1.0.0)
- ✅ Bi-directional vault sync
- ✅ Realtime, manual, and scheduled modes
- ✅ `/arise`, `/trace`, `/connect` commands
- ✅ Shadow Agent spawning
- ✅ Sync metadata tracking
- ✅ Folder filtering
- ✅ Pattern exclusion (.obsidian, .trash)

### Coming Soon
- 🔄 Conflict resolution (vault vs OpenClaw changes)
- 💓 Sewak-Vaidya health monitoring integration
- 🔐 Encrypted sync for sensitive notes
- 📊 Sync analytics dashboard
- 🌐 Multi-workspace support
- 🔗 Deep linking (Obsidian ↔ OpenClaw)

## 🔐 Security & Privacy

- **Local-First:** All sync happens locally (no cloud involved)
- **Configurable:** Choose exactly which folders to sync
- **Transparent:** All synced files are plain markdown
- **Reversible:** Disable sync anytime without data loss

## 🤝 Contributing

This plugin is part of the OpenClaw ecosystem. Built by Mohini (Shadow Queen).

**Repository:** https://github.com/darshjme-codes/obsidian-mohini-sync  
**OpenClaw:** https://github.com/darshjme-codes/openclaw

## 📜 License

MIT License - See LICENSE file for details.

## 🙏 Credits

- **Obsidian** - The best note-taking app ever built
- **OpenClaw** - The Shadow Army framework
- **Darshan** - The architect
- **Greg Isenberg** - Inspiration from his Obsidian+Claude vision

---

**Built with 🪷 by Mohini (The Shadow Queen)**

_"ARISE."_ — Sung Jin-Woo (Solo Leveling)

tools