Oh-my-mermaid is a TypeScript CLI tool that generates architecture diagrams from codebases using AI, presenting perspectives with Mermaid diagrams and documentation. It includes CLI commands, plugin architecture, and cross-tool support.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Oh-my-mermaid is a TypeScript-based CLI tool that analyzes a codebase to generate architecture documentation and Mermaid diagrams. It organizes output as perspectives (structure, data flow, integrations) and nests elements to reflect the filesystem. It provides a viewer and a set of CLI commands to setup, view, configure language, and update.
How it works
The tool analyzes the codebase with AI to produce perspectives, each containing a diagram and documentation fields. Nodes may nest deeper elements, mirrored by the filesystem layout under .omm/. Perspectives include fields such as description, diagram, context, constraint, concern, todo, note. The viewer renders expandable groups for elements with children and nodes for leaf elements.
Getting started
"npm install -g oh-my-mermaid" && "omm setup" and then use the /omm-scan skill in an AI coding tool, followed by "omm view" to view results. Additional CLI usage:
omm setup # Register skills with your AI tools
omm view # Open interactive viewer
omm config language ko # Set content language
omm update # Update to latest version
Supported AI Tools include Claude Code, Codex, Cursor, OpenClaw, and Antigravity, with setup through "omm setup" commands.
Recent releases
- v0.2.0 (2026-03-25): Perspective Class Tree by @hitkoo in pull request #17
- v0.1.8 (2026-03-24): Transition to plugin architecture with multi-platform omm setup by @hitkoo in pull request #1; rename omm serve → omm view
- v0.1.7 (2026-03-24): Transition to plugin architecture with multi-platform omm setup by @hitkoo in pull request #1; rename omm serve → omm view
- v0.1.6 (2026-03-24): Transition to plugin architecture with multi-platform omm setup by @hitkoo in pull request #1; rename omm serve → omm view
Traction
2047 stars, 168 forks, 9 open issues
License
MIT






