oh-my-mermaid: Generating Architecture Diagrams from Codebases via AI

X postTom DörrTool

Tom Dörr highlights oh-my-mermaid (omm), an open-source tool that uses AI coding assistants like Claude Code to scan complex codebases and generate navigable Mermaid architecture diagrams.

Key points

  1. oh-my-mermaid provides CLI-based skills for AI tools such as Claude Code, Cursor, Codex, OpenClaw, and Antigravity.
  2. Running /omm-scan recursively analyzes codebases to create architectural perspectives like structure, data flow, and external integrations.
  3. Documentation is stored locally in the .omm directory as Markdown files alongside Mermaid diagrams (.mmd).
  4. Each architectural element captures up to seven metadata fields: description, diagram, context, constraint, concern, todo, and note.
  5. An interactive viewer is accessible via omm view, with optional cloud synchronisation to ohmymermaid.com.

Why it matters

As AI tools speed up code writing, comprehending large and evolving systems becomes harder for human developers. Automatically mapping repositories into hierarchical, text-based Mermaid diagrams keeps architectural documentation accessible and version-controllable.

Analysis

oh-my-mermaid uses standard Mermaid diagrams and reflects component hierarchy directly in the local filesystem structure. By functioning as a skill inside assistants like Claude Code and Cursor, it integrates architectural mapping directly into agentic development workflows.

Original post

Tom Dörr

@tom_doerr · 8 October 2026

Turns complex codebases into clear architecture diagrams using Claude Code. t.co/hG9jii8q6w t.co/GyVE5ThT20

669 likes14 replies1.1k bookmarks51.2k views

View on X
Selected replies (5)
  • @piyushc_builds @tom_doerr Mermaid diagrams are the most low effort diagrams. Try this: t.co/nsDeMmquAC
  • @palak__4 @tom_doerr tried this. the diagram was cleaner than the repo
  • @aryanandutkarsh @tom_doerr This supports mermaid and a lot more diagram formats...export or embed it anywhere, plus this is animated Try this: t.co/x4lZEwRPBK t.co/1VwGRRXo5x
  • @jatingargiitk @tom_doerr how does it handle multi-language codebases? curious if claude code can follow call graphs across python, typescript, and rust in one diagram.
  • @yevloop @tom_doerr does it survive a 6 year old monorepo or does the diagram just become spaghetti art

Mentioned links

Links and tools from this entry

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

Related entries

Similar in content, found by the AI search.

  • Repository:oh-my-mermaid/oh-my-mermaid

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

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

    2.5kstarsTypeScript

    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

  • 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:Trending GitHub Repositories

    diagram-design: Editorial SVG and HTML Diagrams for AI Coding Agents

    The diagram-design repository by Cathryn Lavery introduces a plugin for Claude Code, Codex, and compatible agents that generates 39 editorial-quality diagram types as self-contained HTML and SVG. It aims to eliminate generic Mermaid-style layouts and manual Figma redesigns.

    1.2kbookmarks86.3kviews

    AI & LLMs· Tool

Back to the knowledge base

Let's talk about your project

Get in touch

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.