PrivyMermaid (macOS)

Create and repair Mermaid diagrams in a local native macOS workspace.

Overview

PrivyMermaid is a native macOS app for writing, previewing, saving, importing, and exporting Mermaid diagrams. Optional local Ollama integration adds Generate, Fix, and Refactor assistance while keeping diagram content on your Mac.

Features

Diagram editing — Create and edit Mermaid diagrams with live preview
Local storage — Diagrams, settings, and prompt templates saved in Application Support
Ollama integration (optional) — Configure local Ollama endpoint for AI assistance
Import/Export — Uses macOS sandbox "user-selected file" access
No account, no cloud sync — No login required. Data stays entirely local.

Advantages

PrivyMermaid gives you a desktop diagram editor without cloud sync, accounts, analytics, or hosted rendering. Prompt templates, settings, and diagrams stay local, and optional AI traffic goes only to the Ollama endpoint you configure.

Benefits

Produce documentation diagrams faster, repair Mermaid syntax without pasting proprietary architecture into cloud tools, and keep a native editor available even when you are offline.

Requirements

macOS for the native app
Ollama (optional) — Required only for Generate, Fix, and Refactor AI assistance.
PrivyMermaid 1.4.0 or later — Required for the embedded CLI workflow below.

privymermaid-cli Guide

Requires PrivyMermaid version 1.4.0 or above.

Assuming the App is installed at /Applications/PrivyMermaid.app:

1) Copy the embedded CLI

cp "/Applications/PrivyMermaid.app/Contents/MacOS/privymermaid-cli" "/usr/local/bin/privymermaid-cli"

2) Remove the original signature and apply a local ad-hoc signature

codesign --remove-signature "/usr/local/bin/privymermaid-cli"
codesign --force --sign - "/usr/local/bin/privymermaid-cli"

3) Verify

/usr/local/bin/privymermaid-cli --help

If you don't have write permissions for /usr/local/bin, you can use ~/bin instead:

mkdir -p ~/bin
cp "/Applications/PrivyMermaid.app/Contents/MacOS/privymermaid-cli" ~/bin/privymermaid-cli
codesign --remove-signature ~/bin/privymermaid-cli
codesign --force --sign - ~/bin/privymermaid-cli
~/bin/privymermaid-cli --help

Screenshots

PrivyMermaid macOS Main Interface — Native macOS Interface

PrivyMermaid macOS Diagram Editing — Diagram Editing & Preview

PrivyMermaid macOS AI Features — AI Generate & Fix