zhitongblog

A local-first Markdown editor with a built-in MCP server, letting AI agents like Claude Code, Codex, and Cursor drive your vault directly. Supports 14 AI providers BYOK.

v5.0.21
Published at
1d ago
1,575
Stars
3,838
Download
Synced at
23h ago

Latest release

v5.0.21Nov 12, 2026, 04:21 PM
Downloads slow? Switch the source anytime above

README

Project Overview

SoloMD is a local-first Markdown editor and the bridge to your LLM. Your notes live in a folder, with a first-class agent surface inside the editor and an MCP endpoint that external clients like Claude Code/Cursor can drive. Built on Tauri 2 + Vue 3 + CodeMirror 6.

Key Features

  • Knowledge-graph layer: Properties inspector (⌘⇧I) for YAML frontmatter editing, type-driven sidebar, and typed relationships (belongs_to/related_to/has) with automatic inverses
  • 14 AI providers BYOK: Bring your own API keys
  • Built-in MCP server: Lets Claude Code, Codex, and Cursor drive your vault directly
  • Cross-platform: Universal macOS dmg ~32 MB

Target Audience

  • Users who want to integrate AI agents into their note-taking workflow
  • Users managing knowledge with Markdown
  • Teams who prefer local-first, no-subscription solutions

Quick Start

  1. Download the latest release from the Releases page
  2. Install and launch SoloMD
  3. Open an existing notes folder or create a new vault
  4. Configure AI provider API keys
  5. Interact with AI agents inside the editor, or let external agents drive your vault via the MCP server

Core Advantages

  • Local-first: notes, AI keys, embedding index, and git history stay on your machine
  • MIT licensed, no subscription, no SoloMD-hosted servers
  • Built-in knowledge-graph layer for structured note management
  • Open-source and free

System Requirements

  • OS: Cross-platform (macOS, Windows, Linux)
  • Architectures: x86_64, arm64

Release history

Sort