Oh-my-mermaid: AI-Driven Architecture Diagrams for Codebases

Repositoryoh-my-mermaid/oh-my-mermaidTool

Oh-my-mermaid (omm) is a CLI tool and AI skill that analyses complex codebases to generate hierarchical architecture documentation powered by Mermaid diagrams.

Key points

  1. Addresses the black-box problem caused when AI writes code faster than humans can understand it
  2. Installs via npm and integrates as a skill into AI coding assistants such as Claude Code
  3. Uses the /omm-scan skill to recursively generate perspectives on structure, data flows, and integrations within a local .omm directory
  4. Stores element-level metadata including descriptions, Mermaid diagram files (.mmd), context, constraints, concerns, and notes
  5. Includes an interactive local viewer (omm view) and optional cloud synchronisation via ohmymermaid.com

Why it matters

As AI code generation accelerates, software architecture risks becoming opaque. Oh-my-mermaid provides structured, visual documentation generated by AI to keep system designs transparent and navigable for human engineers.

Analysis

Targeted at developers using AI coding tools, the TypeScript project provides a clean bridge between code generation and architecture comprehension. With nearly 2,500 GitHub stars, an MIT licence, an active npm release, and cloud integration, it shows solid community traction and practical utility.

Found in

Summary generated by AI (Gemini 3.8 Flash, 9 October 2026). It may contain errors – the original source is authoritative.

Similar in content, found by the AI search.

  • Repository:tt-a1i/archify

    Archify: Interactive Architecture and System Diagrams for AI Coding Agents

    Archify is an open-source Node.js rendering and validation engine designed as a skill for coding agents like Cursor, Claude Code, Codex CLI, and OpenCode. Agents produce a typed JSON Intermediate Representation (IR), which Archify deterministically compiles into self-contained, interactive HTML, SVG, and media exports.

    45.5kstarsJavaScript

    AI & LLMs· Tool

  • X post:Marco Ramilli

    Archify: Interactive Architecture Diagrams via AI Agents

    Marco Ramilli highlights Archify, an open-source skill for coding agents like Claude Code, Cursor, and Codex that turns codebases or system concepts into interactive HTML diagrams.

    1.1kbookmarks80.3kviews

    AI & LLMs· Tool

  • Link:tt-a1i.github.io

    Archify: Generate Interactive Technical HTML Diagrams from Plain English

    Archify is an open-source agent skill that generates interactive, self-contained HTML architecture diagrams directly from natural language prompts. It supports five diagram types, four visual presets, and sharp multi-format exports with zero external dependencies.

    AI & LLMs· Tool

  • X post:也无风雨也雾晴

    Archify: AI Agent Skill for Interactive Architecture Diagrams Hits #1 on GitHub Trending

    The creator of Archify celebrated reaching #1 on GitHub Trending. The open-source project acts as a skill for AI coding assistants like Cursor, Claude Code, Codex CLI, and OpenCode, deterministically compiling typed JSON from agents into interactive, self-contained HTML system diagrams.

    5.1kbookmarks625.2kviews

    AI & LLMs· Tool

  • Repository:anthropics/claude-code

    Claude Code: Terminal-Based Agentic Coding Tool

    Claude Code by Anthropic is an agentic coding tool that operates in the terminal. It understands codebases, executes routine development tasks, explains complex code, and handles Git workflows using natural language commands.

    144.1kstarsPython

    AI & LLMs· Tool

Let's talk about your project

Locations

  • Mattersburg
    Johann Nepomuk Bergerstraße 7/2/14
    7210 Mattersburg, Austria
  • Vienna
    Ungargasse 64-66/3/404
    1030 Wien, Austria

Parts of this content were created with the assistance of AI.