Neptunus

Bekijk Mermaid-diagrammen native op macOS. Je AI-agent pusht ze naar een echt venster zodat jij ze kan reviewen.

Downloaden

v0.1.0 · macOS 15+ · Apple Silicon

Je agent roept preview_mermaid aan, Neptunus opent het diagram in een echt venster, en jouw Approve of Deny gaat terug naar de agent.

Zie wat je AI-agent voorstelt

Wie met AI-agents werkt, verzamelt veel Mermaid-diagrammen: schema's, flows, sequenties. Hoe groter ze worden, hoe moeilijker de ruwe broncode leest en hoe sneller je het overzicht kwijt bent. Neptunus toont ze zoals je ze echt zou zien, zodat je het diagram van je agent in één oogopslag checkt en goedkeurt of afwijst zonder je editor te verlaten.

Credit-ledger.mmd Een Mermaid-flowchart van een credit ledger, gerenderd door Neptunus
Ledger ER.mmd Een Mermaid-ER-diagram van dezelfde ledger, gerenderd door Neptunus

Echte Mermaid, volledig offline

Diagrammen renderen met de meegeleverde mermaid.js in een native WKWebView. Geen CDN, geen internet nodig. Flowcharts, sequence-, ER- en state-diagrammen en de rest, licht of donker, net als je Mac.

Je agent pusht, jij reviewt

Een lokale MCP-server biedt de tool preview_mermaid aan. Je AI-agent stuurt een diagram rechtstreeks naar de app; in review-modus wacht hij op jouw Approve of Deny en krijgt hij het antwoord terug.

Bekijken, of naast elkaar bewerken

Open een bestand in .mmd of plak de broncode. Wissel tussen een rustige preview en een gesplitste weergave met een live editor die opnieuw rendert terwijl je typt.

Zoomen, verschuiven, exporteren

Pas het diagram aan het venster aan of zoom tot 800%. Shift-scroll en Space-drag zoals op een echt canvas, en exporteer daarna elk diagram naar SVG, PNG of PDF.

Altijd één toetsaanslag weg

Neptunus zit in de menubalk en blijft draaien, zodat agents de app altijd kunnen bereiken. Het Dock-icoon verschijnt alleen als er een venster open is, en de app werkt zichzelf bij op de achtergrond.

Een echte macOS-app

Swift en SwiftUI, documentgebaseerd, gesigneerd en genotariseerd. Open en bewaar bestanden in .mmd en .mermaid zoals elk ander document.

Voeg de MCP-server toe

Installeer de app in /Applications, laat hem draaien en voeg daarna de MCP-server toe aan je agent.

Claude Code (CLI)
claude mcp add -s user neptunus -- "/Applications/Neptunus.app/Contents/MacOS/neptunus-mcp"
Codex (CLI)
codex mcp add neptunus -- "/Applications/Neptunus.app/Contents/MacOS/neptunus-mcp"

In de app staat onder Settings → MCP een Copy-knop met jouw exacte pad, plus een snippet voor .mcp.json voor Cursor en Claude Desktop.

Changelog

Elke release, nieuwste eerst.

  1. 0.1.0

    Initial release

    • Document-based app for `.mmd` / `.mermaid` files plus pasted source, with a menu bar item that keeps it running after windows close.
    • Diagram rendering with vendored mermaid.js 11.15.0 in a `WKWebView`, fully offline, with a custom light/dark theme that follows your preference.
    • Preview/split toggle: look at the diagram, or edit the source alongside a live render (150 ms debounce).
    • Zoom and fit: fills the window by default, manual zoom to 800% via slider and 50/100/200/400/800% presets, Shift + scroll to zoom, and Space + drag to pan. Crisp vector SVG.
    • Local MCP server: agents connect via the bundled `neptunus-mcp` helper over a `0600` unix socket and call `preview_mermaid` to render a diagram here. `wait_for_review` blocks until you accept or reject and returns the verdict.
    • Settings → MCP: live server status, a Restart control, connected clients, the helper path, and copy-paste `claude mcp add` / `.mcp.json` snippets. The menu bar mirrors the status.
    • Export the diagram to SVG, PNG, or PDF.
    • Dock icon only while a window is open; otherwise menu-bar-only, still running.
    • Automatic updates via Sparkle.