Mermaid
Install Mermaid CLI
Use `npm i -g @mermaid-js/mermaid-cli` so KatanA can detect `mmdc` automatically.
Install and download
Install with Homebrew if you want the shortest path. Use the direct DMG if you prefer manual download.
Two clear paths to get running on macOS.
The install page mirrors the current app repository guidance so the product website stays useful as the first adoption step.
01
Homebrew recommended
02
Direct download supported
03
Gatekeeper note included
homebrew
Homebrew
Recommended when you want the fastest path.
- Recommended install path for most users.
- The app is ready to use immediately after install.
brew tap HiroyukiFuruno/KatanA && brew install --cask katana-desktopmanual
Manual download
- Download the latest DMG from GitHub Releases.
- Drag KatanA Desktop.app into Applications.
- Run the Gatekeeper allowance command once before first launch if needed.
xattr -cr /Applications/KatanA\ Desktop.appupdates
Updating KatanA
- KatanA includes a built-in auto-updater.
- When a new release is available, use the in-app "Update & Restart" action.
- If the app was first installed with Homebrew, the first in-app update detaches Homebrew management to avoid double-management conflicts.
diagram / setup
Optional diagram setup
Extra tooling is only needed for Mermaid and PlantUML workflows.
PlantUML
Install Java runtime
Use `brew install openjdk@25`, then download `plantuml.jar` from the app when opening a PlantUML document.
Draw.io
No extra install
Draw.io diagrams are rendered natively in the current product guidance.
docs / links