solomd
zhitongblog · zhitongblog/solomd
A markdown editor with a bundled MCP server, enabling Claude Code, Codex, and Cursor agents to directly manage your knowledge vault.
A markdown editor — and the bridge to your LLM. Local-first, MIT, ~15 MB. Bundled MCP server lets Claude Code / Codex / Cursor drive your vault directly. 14 AI providers BYOK.
Preview
What you can do with it
- Let Claude Code directly update and organize your markdown knowledge base.
- Have an agent generate new notes or expand on existing topics within your vault.
- Use your agent to search and retrieve specific information from your local markdown files.
Safety check
Usable, but read the notes first.
- ●Installer downloads a remote script and pipes it to the shell.
scripts/install-cli.sh
Automated scan of the repo files. Always review code you run.
From the README
SoloMD
The editor where agents live.
🌐 中文 · 日本語 · 한국어 · Deutsch · Français · Español · Português · Italiano · Polski · Nederlands · Türkçe · Svenska · Українська · 🪞 Gitee mirror → (faster downloads from China)
Download the latest release · Launch post · How we built it · Website · Security
⭐ If SoloMD earns a place on your machine, star it on GitHub — it's free, made by one developer, and stars are how other people find it.
🤖 Built and maintained by Claude
SoloMD is written, tested and released almost entirely by Claude Code, Anthropic's coding agent, working under a human maintainer who sets the direction and decides what ships. Issues and pull requests are triaged and answered by Claude as well — the replies you get here are written by an AI, not typed by a person.
We are telling you this for two reasons. You should know what you are trusting with your notes: read the code, it is MIT and all of it is public. And when a reply is confidently wrong — it happens — say so in the thread. That correction is the mechanism.
Your notes live in a folder. SoloMD is the editor on top — with a first-class agent surface inside the editor, and the MCP endpoint Claude Code / Cursor can drive from outside. Same .md files. Chat with your vault. Schedule recipes that run when you're not at the keyboard. Hand the same vault to any MCP client.
Built on Tauri 2 + Vue 3 + CodeMirror 6. Universal macOS dmg ~32 MB. Free, MIT, no subscription, no SoloMD-hosted servers. Your notes, AI keys, embeddings index, and git history all stay on your machine.
New in 4.6 — the knowledge-graph layer
The structural half Obsidian and Tolaria had and SoloMD didn't — now built, and on SoloMD's own warm design system:
- Properties inspector (
⌘⇧I) — edit YAML frontmatter with type/date/status/relation pickers; line-surgical writes preserve your comments, inline arrays and quoting byte-for-byte. - Type-driven sidebar — give a note
type: Projectand its members become a first-class collapsible section with custom icon/colour/columns (types-as-lenses). - Typed relationships —
belongs_to/related_to/hasfrontmatter with automatic inverses, resolved server-side for big vaults. - Relationship graph ("Neighborhood") — per-note explorer of outgoing + inverse links; click to navigate, ⌘-click to pivot.
- Saved filtered views — persistent sidebar views (
.solomd/views/*.yml) with a recursive all/any filter builder (type / status / date / regex). - Inbox workflow —
⌘Emark-organized + auto-advance to inbox-zero. - tldraw whiteboards — Markdown-backed boards (
```tldrawfence), cross-compatible with Tolaria's on-disk format, lazy-loaded so the core stays light.
Plus a unified macOS title bar (traffic lights inline in the toolbar) and a from-scratch design-system + Vue component library. Still ~15–32 MB, still free, still local-first. → Compare vs Obsidian / Typora / Tolaria
Three halves of one product
The editor. WYSIWYG live edit (Typora-style), tabs + split panes, KaTeX + Mermaid, image paste to _assets/, slideshow mode (⌘⌥P), Vim mode, Hunspell + CJK proofread, semantic search (⌘⇧F), wikilinks + backlinks, Pandoc export. CJK encodings (GBK / Big5 / Shift-JIS) auto-detected.
The endpoint. A bundled solomd-mcp binary exposes the same vault to any MCP client — 13 tools out of the box, including 5 SoloMD-only ones (autogit_log, autogit_diff, autogit_rollback, sync_status, share_url) that no other markdown server has. v4.0 adds --workspace path1 --workspace path2 federation — one MCP session, many vaults. Plus a solomd agent CLI that hands off to Claude Code / Codex CLI with the MCP pre-wired.
The agent surface (v4.0). Right-side Agent Panel: streamed chat-with-vault, [[wikilink]] citations, tool-call cards inline, Insert / Copy buttons drop the reply into the active note. Plus declarative recipes as YAML in <workspace>/.solomd/agents/*.yml — cron / on-save / on-commit / on-tag-add / manual triggers. Every agent write lands on its own AutoGit branch you accept or reject before it touches main; write-cap default 5; refuses to start when the working tree is dirty; replayable trace.jsonl per run with read_agent_trace MCP tool.
| Feature | |
|---|---|
| Agent Panel (v4.0) | Streamed chat-with-vault peer to Outline / Backlinks / Tags / History. Tool-call cards expand inline; reply Insert / Copy to active editor; run history persists as plain markdown under .solomd/agent-runs/. |
| Scheduled recipes (v4.0) | YAML jobs in your vault. AutoGit branch sandbox + accept/reject UI before merge. Per-run write-cap (default 5, ceiling 50). 11-recipe cookbook ships in-tree. |
| Replayable trace (v4.0) | trace.jsonl per step (prompt / model_call / tool_call / tool_result / git_commit). Replay-from-step rewinds and re-executes. |
| Workspace federation (v4.0) | solomd-mcp --workspace path1 --workspace path2. One Claude Desktop session, many vaults. MCP profiles UI in Settings → Integrations. |
| Ollama first-class (v4.0) | Auto-detect at localhost:11434. Three model presets (qwen2.5:1.5b/7b/14b). provider: local recipe alias for zero-cloud-cost autonomous loops. |
| AI rewrite, BYOK | 14 providers — OpenAI · Claude · Gemini · DeepSeek · Qwen · GLM · Kimi · Doubao · Sili |