OpenSidian

Bridge your Obsidian vault into OpenCode's skill system with SHA-256 version control.

Setup

Add to your opencode.jsonc:

{
  "opensidian": {
    "skillPath": [
      "path/to/obsidian/vault/skills-folder"
    ],
    "docPath": [
      "path/to/obsidian/vault/docs-folder"
    ],
    "docDestPath": ".opencode/opensidian-docs",
    "confirmPush": true,
    "stripFrontmatterKeys": ["metadata"]
  },
  "plugin": [
    "@rdhmuhammad/opensidian"
  ]
}

Config options

| Key | Required | Description | |---|---|---| | skillPath | yes | Folders containing .md skill files with YAML frontmatter | | docPath | no | Folders containing .md documents to sync | | docDestPath | no | Where docs land locally (defaults none, no doc sync) | | confirmPush | no | Require explicit confirm on push (default false) | | stripFrontmatterKeys | no | Extra frontmatter keys to strip on pull (Obsidian keys like tags, aliases are always stripped) |

Skill file format

Each .md file in a skillPath folder requires a name in its YAML frontmatter:

---
name: my-skill
description: What this skill does
---

Skill content here.

Companion folders (same name as the .md file) are copied alongside the skill.

Commands

/opensidian pull

Copies changed or new skills from the vault into .opencode/skills/. Only files with different content (by SHA-256) are pulled.

/opensidian push <skill...>

Pushes local changes back to the vault. Always run with dryRun=true first to preview, then confirm=true to apply.

/opensidian list

Lists all skills found in configured vault folders with their sync status.

/opensidian status

Shows per-skill sync status: up to date, vault ahead, local modified, or conflict.