mingzeng21/dsh-obsidian
Connect dsh to a local Obsidian vault: search, read, write, move, and trash notes through obsidian_* tools.
dsh-obsidian connects DeepSeek Harness to a local Obsidian vault. Because a vault is just a folder of Markdown files, the agent can search, read, write, move and trash notes directly with no MCP server and no OAuth. On startup the plugin resolves the vault root (an explicit vaultPath wins, else it auto-detects from obsidian.json) and mounts 12 obsidian_* tools covering search, read, write, append, move, delete and backlink lookups. It is safe by default: deletes move notes into .trash/ (reversible), paths cannot escape the vault root, and .obsidian/ is never touched. When useCli is on and the CLI is detected, property:set/property:remove delegate to it and everything else stays on FsAccess; any CLI failure silently falls back to FsAccess.
Install
dsh plugin --profile web add dsh-obsidianThe npm package dsh-obsidian 0.2.6 was re-verified live on 2026-10-01 with its repository field back-linking to mingzeng21/dsh-obsidian. No MCP server or OAuth is involved.
Compatibility
Node >= 22.12.0; the README verifies against dsh v0.1.7-rc.2. Reads/writes the vault filesystem directly -- no Local REST API community plugin and no standing MCP server.
Details
- Repo: mingzeng21/dsh-obsidian
- Category: Tools & Capabilities
- Stars: 0
- Version: npm dsh-obsidian 0.2.6 (registry re-verified 2026-10-01); MIT
- Last push: 2026-09-12
- First seen: 2026-08-16
Recent updates
The README documents the zero-server filesystem approach, the safe-by-default rules (reversible .trash/ deletion, path containment, untouched .obsidian/), the vault-root resolution order, the 12 obsidian_* tools, and the useCli delegation/fallback behaviour.
FAQ
- How do I install dsh-obsidian?
- dsh plugin --profile web add dsh-obsidian; the npm package 0.2.6 was re-verified on 2026-10-01.
- Does it need an MCP server or OAuth?
- No -- the README says it reads/writes the vault filesystem directly, with no Local REST API plugin and no standing MCP server.
- Is deletion safe?
- Yes -- deletes move notes into .trash/ (reversible), paths can't escape the vault root, and .obsidian/ is never touched.
Alternatives
zhaoscsc/dsh-wikilink · havingautism/dsh-notebooks · fff122/dsh-research-notes