A markdown editor with an MCP server and a trust-but-verify agent sandbox
SoloMD is a local-first markdown editor that bundles an MCP server so Claude, Cursor, or Codex can read and write your vault—while forcing every agent edit onto a branch you accept or reject.
What it does
SoloMD is a local-first markdown editor built on Tauri 2 and Vue 3 that sits on top of a plain folder of .md files. It offers WYSIWYG live editing with wikilinks, backlinks, semantic search, and Pandoc export, plus a right-side panel for chatting with your vault through any of 14 BYOK AI providers. Every save auto-commits via vendored libgit2, and a bundled solomd-mcp binary exposes the vault to external MCP clients like Claude Code or Cursor.
The interesting bit
The app treats agent writes like unmerged PRs: every AI edit lands on its own AutoGit branch with a hard write cap, and you accept or reject it before it touches your working tree. You can also schedule declarative YAML recipes to run on cron or on-save triggers, with full replayable traces—turning a notes folder into a personal automation engine that still keeps your keys and index offline.
Key highlights
- ~15–32 MB universal binary, MIT-licensed, no subscription; AI keys and embeddings stay in the OS keychain and local index.
- Bundled
solomd-mcpserver exposes 13 tools over stdio (5 SoloMD-only, such asautogit_rollbackandsync_status), read-only by default with opt-in--allow-write. - v4.6 adds a knowledge-graph layer: typed frontmatter, relationship graphs, saved filtered views, and tldraw whiteboards stored inside Markdown code fences.
- 14 AI providers including first-class Ollama auto-detect, plus a per-provider token cost meter.
- Desktop (macOS, Windows, Linux) and native iPad support, with cloud-folder detection for Dropbox or iCloud session restore.
Verdict
Grab it if you want an Obsidian-like vault with a built-in agent panel and an MCP backdoor for external LLM clients. Skip it if you are looking for a managed cloud service or a dead-simple, non-AI editor.
Frequently asked
- What is zhitongblog/solomd?
- SoloMD is a local-first markdown editor that bundles an MCP server so Claude, Cursor, or Codex can read and write your vault—while forcing every agent edit onto a branch you accept or reject.
- Is solomd open source?
- Yes — zhitongblog/solomd is open source, released under the MIT license.
- What language is solomd written in?
- zhitongblog/solomd is primarily written in TypeScript.
- How popular is solomd?
- zhitongblog/solomd has 578 stars on GitHub.
- Where can I find solomd?
- zhitongblog/solomd is on GitHub at https://github.com/zhitongblog/solomd.