oh-my-mermaid
CLI + AI coding-tool “skills” that scan a codebase and generate human-readable architecture documentation with Mermaid diagrams, organized into a filesystem tree under `.omm/`. Optionally can link/push the generated architecture to a private cloud for sharing/viewing.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
HTTPS is not explicitly stated, but npm/cloud-style tooling typically uses HTTPS; exact enforcement is not verifiable from provided text. Auth strength/scope granularity are unclear because the auth method and token handling are not documented. The manifest snippet lists only `yaml` and provides no information about dependency security scanning or secret handling practices.
⚡ Reliability
Best When
You want fast, structured architecture documentation from a repository to help humans navigate unfamiliar code.
Avoid When
You cannot or do not want to expose code to any cloud service (if cloud upload/link is used) or you require strict guarantees about accuracy without validation.
Use Cases
- • Generate architecture “perspectives” (structure, data flow, integrations) from an existing codebase
- • Create navigable Mermaid diagram documentation for humans and teams
- • Support AI coding workflows via in-tool skills like `/omm-scan` and `/omm-push`
- • Create shareable architecture snapshots via the ohmymermaid.com viewer
- • Bootstrap architecture docs during onboarding or refactors
Not For
- • Replacing a dedicated architecture review process or authoritative system design documentation
- • Producing legal/compliance-grade documentation without human verification
- • Diagramming proprietary/regulated codebases without confirming data handling and retention policies
- • Acting as a general-purpose diagramming tool independent of codebase scanning
Interface
Authentication
README indicates a cloud feature requiring `omm login && omm link && omm push`, but does not specify auth mechanism (API key vs OAuth), scopes, token formats, or security details.
Pricing
No pricing or billing details provided in the supplied README/manifest content.
Agent Metadata
Known Gotchas
- ⚠ This tool is primarily a CLI + in-AI-tool “skills” workflow; there is no documented programmatic HTTP API in the provided content.
- ⚠ Cloud auth and push behavior are not documented here; agents should not assume network-free operation when `omm push`/cloud linking is used.
- ⚠ Idempotency and retry guidance for operations like scan/update/push are not described in the provided README.
Alternatives
Full Evaluation Report
Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for oh-my-mermaid.
AI-powered analysis · PDF + markdown · Delivered within 30 minutes
Package Brief
Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.
Delivered within 10 minutes
Score Monitoring
Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.
Continuous monitoring
Scores are editorial opinions as of 2026-03-30.