← all repositories
zhitongblog/solomd

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.

578 stars TypeScript AgentsCoding AssistantsRAG · Search
solomd
Collecting fresh signals — velocity needs a few days of history.
collecting data…
star history

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-mcp server exposes 13 tools over stdio (5 SoloMD-only, such as autogit_rollback and sync_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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.