Install

Build from source

git clone https://github.com/nonatofabio/mindle.git
cd mindle
./build.sh
open build/Mindle.app

Requires macOS 14+ and Xcode Command Line Tools (xcode-select --install).

Setup with Claude Code

claude mcp add mindle /Applications/Mindle.app/Contents/MacOS/mindle-mcp

Restart Claude Code so it handshakes the new server, then ask:

watch my Mindle annotations and answer them

The agent calls wait_for_annotation_event in a loop. You annotate (⌘⇧N for a note, then type, then Return); the agent wakes within a second, reads the surrounding context, and posts a reply in the thread or edits the file and clears the annotation.

Any MCP-aware client works the same way — the tool descriptions carry enough protocol guidance that vanilla agents run the loop without a custom skill.

Workflow

• Tabs and multi-window — open many files in one window (⌘O adds a tab) or pop a new window with ⌘N. Each tab carries its own scroll, theme, font scale, and collaborator registry. ⌘W closes the active tab when more than one is open, otherwise the window.
• Open remote URLs — ⌘⇧L opens any http(s) URL pointing at raw Markdown (a GitHub raw link, a hosted doc) as a tab. Annotations on URL documents persist locally keyed by URL hash, so re-opening the same URL brings the annotations back.
• Open from Clipboard — ⌘⇧V opens the pasteboard contents as a Markdown tab. Use this when the source is behind a login your browser already handles (internal GitLab raw, Confluence, anything auth-walled): copy the raw Markdown there, paste it here. Tabs are content-addressed, so re-pasting identical text re-opens the same tab with its prior annotations.
• File browser — scoped sidebar tree of every .md and .txt in the current folder (⌘⇧F). Never escapes upward.
• Find in document — live search with match count, ⌘F / ⌘G / ⌘⇧G.
• Live reload — external edits (vim, an agent, Dropbox, anything) re-render automatically. Bursty writes are debounced; scroll position is preserved. Sidecar changes (a teammate's annotation arriving via shared folder or git pull) flow in the same way.
• Diff-on-reload — when an external write changes the active file, Mindle renders the change as a Word-style track-changes overlay you can ✓ Keep or ✗ Revert per chunk, or whole-document with ⌘⌥⏎ / ⌘⌥⌫. Diffs run a second pass at word granularity inside each line, so you see just the changed words struck or underlined — not the whole line.
• Collapsible YAML frontmatter — ----delimited blocks at the top of a file collapse behind a small chevron; click to inspect. PDF export force-opens them.
• PDF export — ⌘P produces a paginated Letter-sized PDF with print-styled typography.
• Auto-update — opt-in, off by default. EdDSA-verified binaries via Sparkle. Pre-releases ship on a separate beta channel; flip Mindle → Include Pre-release Updates to opt in.