RenderingAppears in · InlineAdded

Mermaid Inline

Draws Mermaid code blocks in Claude's replies as diagrams.

Mermaid Inline · Effect preview · IllustrationIllustrative
> Add pagination to the order list
⏺ I’ll look at the list component first.
⏺ Here is how an order moves through the backend:
┌────────────┐ ┌────────────┐
│ Storefront │───▶│ Orders API │
└────────────┘ └────────────┘
(drawn as a picture in Ghostty/kitty; illustrative)
❯

Illustration. Actual results depend on the mod, terminal and environment.

Install

/plugin marketplace add dazebug/mermaid-inline
/plugin install mermaid-inline@mermaid-inline
/reload-plugins

Run these commands one at a time in a Claude Code session.

What it accesses

Based on the author’s documentation, checked when listed; use claude plugin validate to check for yourself.

Reads

Yes

Reads terminal config, font headers, some env vars, Claude Code's theme and its own cache.

Writes files

Yes

Writes PNGs and JSON records to ~/.cache/mermaid-inline.

Runs commands

Yes

Runs node bin/render.mjs to render; on macOS may run defaults read for dark mode.

Network

None

Introduction

Mermaid Inline is a Claude Code mod that draws the ```mermaid blocks in Claude's replies in place. In Ghostty, cmux and kitty (outside tmux) it shows pictures via the kitty graphics protocol with labels at text size; elsewhere it uses Unicode box drawing.

It draws flowcharts, sequence, state, class, ER and xychart diagrams; other kinds or unparsable blocks stay code. Math in labels becomes Unicode text, and it works beside LaTeX Inline. Themes and color overrides are available, terminal font and colors are detected automatically, and /mermaid-inline shows its status. Where it draws pictures it adds a short system-prompt section (teach_claude=false turns it off).

Requires Claude Code 2.1.287+ in a terminal, Node.js 18+ with npm, macOS or Linux; it stays out of Desktop, VS Code and claude -p. Per the author it makes no network requests; a local node process renders and caches PNGs in ~/.cache/mermaid-inline. Copying a reply copies placeholders, not the source. Scores are docs-calibrated, not run-tested; preview is illustrative.

Who it is for

  • People who want architecture, flow and sequence diagrams drawn right in the terminal

Requirements

  • Claude Code ≥ 2.1.287
  • Platforms · macOS / Linux
  • Needs Node.js 18+ with npm; pictures need Ghostty, cmux or kitty, not inside tmux.
  • Other terminals get box drawing; no effect in Desktop, VS Code or claude -p.