Skip to main content

Obsidian Wiki

OpenHuman provides bidirectional sync with Obsidian, turning your local note vault into a knowledge source accessible to the agent.

Features​

  • Bidirectional Sync - OpenHuman Memory ↔ Obsidian Markdown
  • Auto Sync - New memories automatically written to wiki
  • Query Writeback - Agent query results can be written back to Obsidian
  • Bidirectional References - Agent memories can be referenced in Obsidian

How It Works​

Obsidian Vault                    OpenHuman Memory Tree
     |                                    |
     |<----------- Bidirectional Sync --->|
     |                                    |
  Markdown Files                   SQLite chunks.db

Configuration​

[obsidian]
enabled = true
vault_path = "/path/to/your/vault"
sync_interval = "5m"
auto_sync = true

Sync Rules​

Memory → Obsidian​

When the agent stores important memories, Markdown files are automatically created:

---
title: User's Design Preferences
created: 2025-05-26
tags: [preference, design]
---

# User's Design Preferences

User prefers a minimalist design style and dark theme.

Source: conversation

Obsidian → Memory​

Content in Obsidian using specific tags will be synced:

---
tags: [openhuman/sync]
---

# My Project Notes

This project uses OpenHuman to manage tasks...

Frontmatter Fields​

FieldDescription
openhuman/syncMark for sync
openhuman/tagsMemory tags
openhuman/importanceImportance score

Use Cases​

Daily Notes​

Tasks in Obsidian daily notes are automatically synced to the agent:

---
tags: [openhuman/sync, daily]
---

# 2025-05-26

- [ ] Complete project documentation
- [ ] Review meeting content

Project Notes​

After project notes are synced, the agent can help you:

  • Track project progress
  • Answer project-related questions
  • Generate project reports

Privacy​

All sync happens locally; the Obsidian vault is never uploaded to any server.

Next Steps​