v0.4.0 — Worktree-Aware Task Coordination

Worktree-Aware Task Coordination

Run multiple AI agents on the same codebase simultaneously, each in its own git worktree, with the vault coordinating who's working on what.

Added

• Worktree metadata on tasks — claim_task accepts optional worktree_branch and worktree_path parameters to track parallel work across agents
• list_tasks and get_context include worktree info for all active work
• complete_task response includes worktree_branch with a "ready for PR" message
• New TaskFrontmatter fields: worktree_branch, worktree_path
• Multi-Agent Parallel Development section in README with Claude Code --worktree workflow and opencode/Codex manual setup

Fixed

• YAML serialization crash — serializeNote now recursively strips undefined values from frontmatter before passing to js-yaml. This hardening applies to all note writes.

Tests

• 33 new worktree metadata tests (375 total assertions)
• All passing on Ubuntu + Windows, Node 18/20/22

Install

npx mcp-obsidian-vault

Full changelog: https://github.com/t-rhex/obsidian-mcp-server/blob/main/CHANGELOG.md

v0.1.0 — Initial Release

obsidian-mcp-server v0.1.0

MCP server for Obsidian vaults with direct filesystem access and git sync. No Obsidian required.

9 MCP Tools

Tool	Description
read_note	Read content, frontmatter, tags, and file metadata
create_note	Create notes with optional YAML frontmatter
update_note	Replace, append, or prepend content; merge frontmatter
delete_note	Safe delete to .trash/ or permanent
search_vault	Full-text and regex search with timeout protection
list_vault	Browse vault structure with recursive listing
manage_tags	Add, remove, or list tags from frontmatter
daily_note	Get, create, or append daily notes by date
git_sync	Git operations: status, commit, pull, push, sync, init, log, diff, remotes

Highlights

• No Obsidian required — reads and writes markdown files directly on disk
• Git sync — optional auto-commit+push after every write with configurable debounce
• Robust security — path traversal prevention with symlink resolution, atomic writes, no shell injection
• YAML frontmatter — full parse/serialize support with tag extraction (frontmatter + inline #tags)

Quick Start

npm install && npm run build

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": ["/path/to/obsidian-mcp-server/build/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}