zhitongblog/solomd

What it solves

SoloMD is a local-first Markdown editor designed specifically for AI agents. It bridges the gap between static note-taking and active AI automation by providing a dedicated surface for agents to read, write, and manage your knowledge base without compromising user control or data privacy.

How it works

SoloMD operates as a layer on top of your local Markdown files. It integrates three core components:

1. The Editor: A WYSIWYG editor with standard note-taking features (wikilinks, backlinks, semantic search).
2. The Agent Surface: An integrated panel for streaming chat-with-vault interactions and "recipes"—declarative YAML jobs that can be triggered by events like saving a file or a specific schedule.
3. The MCP Endpoint: A bundled Model Context Protocol (MCP) server that allows external AI clients (like Claude Desktop or Cursor) to interact with your vault using a set of specialized tools.

To ensure safety, all agent writes are performed on separate AutoGit branches, requiring the user to accept or reject the changes before they are merged into the main branch.

Who it’s for

It is for users who want an AI-powered knowledge base that remains entirely local and private, as well as developers who want to use AI agents to automate tasks within their personal notes (e.g., daily summaries, TODO extraction).

Highlights

• Agent-Native Workflow: Integrated agent panel with streamed chat and tool-call cards.
• Scheduled Recipes: Automate vault maintenance with YAML-based jobs (e.g., weekly reviews, citation cleanup).
• MCP Integration: Bundled MCP server with 13 tools for external LLM client access.
• Local-First Privacy: No hosted servers; API keys are stored in the OS keychain, and data stays on the machine.
• Safety Rails: AutoGit branch sandboxing and write-caps to prevent runaway AI loops.
• Knowledge Graph: Properties inspector, typed relationships, and a relationship graph for structured data management.