AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
Dev Tooling/
solomd
solomd logo

solomd

Active·★ 1.7k·MIT·Updated 2026-11-17
★ Trending

SoloMD is a Markdown editor whose notes live in an ordinary folder of `.md` files. The README describes three parts. The editor has WYSIWYG live editing, tabs and split panes, KaTeX and Mermaid, Vim mode, semantic search, wikilinks and backlinks, Pandoc export and CJK encoding detection. The endpoint is a bundled `solomd-mcp` binary that exposes the same vault to any MCP client with 13 tools, five of them specific to SoloMD (AutoGit log, diff and rollback, sync status and share URL), and it can federate several vaults in one session. The agent surface, new in v4.0, is a right-side panel for chatting with the vault with wikilink citations and visible tool-call cards.

Agent work is designed to be reviewable. Declarative recipes are YAML files in the vault with cron, on-save, on-commit, on-tag-add or manual triggers. Every agent write lands on its own AutoGit branch that you accept or reject before it reaches `main`, there is a write cap per run (default 5), it refuses to start on a dirty working tree, and each run leaves a replayable `trace.jsonl`. Ollama is detected automatically, and AI rewrite supports 14 providers with your own keys stored in the OS keychain.

The README says it is free, MIT licensed, has no subscription and no SoloMD-hosted servers, and that notes, keys, the embeddings index and git history stay on your machine. The MCP server is stdio only and read-only unless you pass `--allow-write`. Optional GitHub-backed sync can be end-to-end encrypted. A universal macOS build is about 32 MB, and versions for other systems are on the releases page. It was last pushed on 2026-10-13. This review is based on the README and repository data; we have not run it ourselves.

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-11-12.

License
MIT
Latest release
v5.0.19 · 2026-11-11
Last commit
2026-11-11
Contributors
33
Forks
112
Open issues and PRs
42
First published
2026-04-08

Source: GitHub, npm and PyPI public APIs.

#Markdown Editor#AI Agent#Local-first#LLM Integration#Knowledge Base#Version Control#Desktop App
$ Install
$ curl -fsSL https://solomd.app/install.sh | bash
↗ Visit site★ GitHub
01

Features

01Inline Agent Panel with Chat-with-Vault and Tool-call Cards
02Scheduled Agent Recipes with AutoGit Branch Sandbox for safe execution
03Seamless Integration with 14 LLM Providers (BYOK)
04Local-first Data Storage and Enhanced Privacy/Security
05Bundled MCP Server for External LLM Client Integration
02

Why choose it

+Notes stay as plain `.md` files in a folder, with a bundled MCP server (13 tools) for Claude Code, Cursor and other clients
+Agent writes go to their own AutoGit branch you accept or reject, with a per-run write cap and a replayable trace
+Scheduled recipes in YAML, Ollama auto-detection and 14 AI providers with your own keys in the OS keychain
+MIT license, no subscription; MCP is read-only by default; last push 2026-10-13
03

Trade-offs

!The big feature set (agent panel, recipes, sync, share, REST API) is new in v4.0, so expect some rough edges
!Cloud AI providers receive the note text you send them, and only the Ollama route avoids that
!`--allow-write` and scheduled recipes let agents change your notes, so keep the write cap low and review each AutoGit branch
04

Maintenance check

ActiveChecked: 2026-11-12
Last commit
2026-11-11
Commits, last 90 days
100+
Releases, last 90 days
30
Latest release
v5.0.19 (2026-11-11)
Open issues
42
Recent issues with at least one comment
24/30
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 24, 31, 29, 21, 101, 40, 181, 24, 23, 17, 27, 18

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

Most discussed open issues

  • #156 为什么编辑模式 没得预览模式好看呢8 comments · 2026-07-13
  • #57 [Feature Request] 实时编辑模式下即时渲染表格/公式/Mermaid + 侧边栏模块自定义布局6 comments · 2026-05-08
  • #318 Toolbar layout: tabs in the title bar, icon+label mode, less duplication with the menu bar3 comments · 2026-09-21
  • #181 AUR package solomd-bin submitted3 comments · 2026-07-29
  • #152 [Feature]: Attach another files besides images3 comments · 2026-07-10

Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.

05

Compatibility

macOS
Platform
Verified via docs
Windows
Platform
Verified via docs
Linux
Platform
Verified via docs
iPad/iOS
Platform
Verified via docs
Android
Platform
Verified via docs
Markdown
Format
Verified via docs
06

Quick start

1
$ curl -fsSL https://solomd.app/install.sh | bash
07

Use cases

↳Interactive AI assistant for note-taking and content generation.
↳Automating routine documentation tasks like summaries and reviews with scheduled AI recipes.
↳Extending personal knowledge base capabilities to other LLM clients like Claude Desktop or Cursor.
↳Secure and private management of personal or work knowledge vaults with version control and E2EE sync.
↳Generating summarized reviews or refactoring notes directly from the command line with agent prompts.
08

Alternatives

⚡Top VS:
VSRoqer★215→VSowngit★98→VSgit-courer★46→VSagent★1.9k→
dsh-desktop logo
dsh-desktop★ 495
DeepSeek Harness Desktop App: a local AI desktop workspace for DSH Sessions, projects, files, web research, plugins, and Office artifacts.
Roqer logo
Roqer★ 215
An open-source AI agent for Roblox Studio. Builds, scripts, and playtests in your place using your ChatGPT/Claude subscription or custom API.
VSCompare→
owngit logo
owngit★ 98
Self-hosted Git server for home labs and local machines
VSCompare→
git-courer logo
git-courer★ 46
MCP server for Git with local Ollama — zero tokens for git operations
VSCompare→
agent logo
agent★ 1.9k
DevOps agent that won't accidentally tweet your AWS credentials 🦀
VSCompare→
CLAUDE-CERTIFICATIONS logo
CLAUDE-CERTIFICATIONS★ 145
Study guide for all four Anthropic Claude certifications: Associate Foundations (CCAO-F), Developer Foundations (CCDV-F), Architect Foundations (CCAR-F), Architect Professional (CCAR-P). Official exam guides, blueprints with domain weights, cheat sheets, 320 practice questions, three mock exams each, 110 flashcards, and a printable companion.
VSCompare→
skill-of-skills logo
skill-of-skills★ 84
The autonomous discovery engine for AI coding tools. Indexes skills, plugins, MCP servers, agents, and integrations across Claude Code, Codex, Gemini CLI, and more.
VSCompare→
OpenChatCut logo
OpenChatCut★ 3.2k
Local-first conversational AI video editor with a professional multi-track timeline, Agent Skills, MCP integration, and Remotion-powered rendering.
VSCompare→
See all alternatives →

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs04Maintenance check05Compatibility06Quick start07Use cases08Alternatives
zhitongblog /
solomd
↗

MIT Markdown editor on Tauri with an agent panel, scheduled recipes and a bundled MCP server for your notes folder

1.7k112MIT
Last commit1d ago
StatusActive
CategoryDev Tooling
Contributors33
Latest releasev5.0.19
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.