See your code.
Not just write it.

Architecture docs, generated by AI, for humans.

oh-my-mermaid viewer

Works with your favorite AI coding tools

Claude CodeCursorWindsurfGitHub CopilotAny MCP Client

The problem

Vibe coding has a blind spot.

You move fast

AI writes code faster than you can think. Modules pile up. Dependencies multiply.

Architecture drifts

Nobody updated the diagram. Nobody knows what connects to what anymore.

You lose the map

Your own codebase becomes a black box. Debugging becomes guessing.

How it works

Three steps. That's it.

01

Setup once

Install the CLI and register Claude Code skills. It scans your project and generates structured Mermaid diagrams.

$ npm i -g oh-my-mermaid && omm setup
02

AI keeps it fresh

Two Claude Code skills — /omm-scan and /omm-push — let AI analyze your code and write diagrams directly.

Claude Code
>/omm-scan
03

View and share

View locally or push to cloud. Share with your team via workspaces. Drill into any diagram, see diffs.

$ omm view

Everything you need to keep the map.

Living diagrams

Every diagram is plain text (.mmd). Committed to git. Diffable. Reviewable.

Cross-diagram links

Reference another diagram with @class-name. Click to drill down. Navigate with breadcrumbs.

Claude Code skills

/omm-scan and /omm-push ship as Claude Code skills. AI writes diagrams, CLI owns the files.

Cloud push & share

Push your architecture to the cloud. Share read-only links with stakeholders or embed in docs.

Team workspaces

Create organizations, invite editors, manage seats. Everyone sees the same living architecture.

Real-time viewer

File watcher + SSE means the browser updates the moment you save a diagram.

Quick start

Get started in seconds.

Global
$ npm install -g oh-my-mermaid
or
One-shot
$ npx oh-my-mermaid setup

Full command reference.

omm setupRegister skills with Claude Code and AI tools
omm listList all architecture classes
omm show <class>Print all fields for a class
omm diff <class>Show diagram diff from previous version
omm refs <class>Show which classes reference this one
omm viewStart the local web viewer on :3000
omm pushPush .omm/ to cloud
omm pullPull .omm/ from cloud
omm sharePrint the shareable URL
omm org listList your organizations