▸ ~/projects/mdow
Mdow: a quiet markdown reader with local AI context
I built Mdow to make local markdown folders easier to read and understand. It combines a focused cross-platform reader with an AI companion that connects to existing OpenCode providers over the Agent Client Protocol.
01 · the problem
Markdown files often contain the durable context behind a project: plans, architecture notes, documentation, and decisions. Editors are optimized for changing those files, but not always for settling in and reading across a folder.
Mdow separates that reading experience from the editor while keeping files local and compatible with the tools developers already use.
02 · the approach
The AI companion is read-only by design. It builds context from the active document, the open folder, and explicitly tagged files, then sends that context through an installed ACP provider. Responses include citations so an answer can be checked against its source.
Because provider access comes from OpenCode, Mdow does not need another model account or a separate API-key workflow. It can use the providers and subscriptions already configured on the machine.
03 · capabilities
- ▸Ask questions about the focused document, an open folder, or explicitly tagged files
- ▸Use existing AI providers configured through OpenCode and ACP
- ▸Follow clickable citations back to the source markdown
- ▸Render code with Shiki and diagrams with Mermaid
- ▸Browse folders, tabs, recents, and document outlines in a focused desktop interface
04 · stack
TypeScript, React, Electron, TanStack, OpenCode ACP, md4x, Shiki, Mermaid, and a separately distributed native macOS beta.