← All features

Feature

Mermaid Diagrams.

Write mermaid syntax in a fenced code block and Crit renders it as an SVG diagram - flowcharts, sequence diagrams, state machines, and more.

How it works

1

Fenced blocks tagged with ```mermaid are automatically rendered as SVG diagrams in the browser. No extra tooling or plugins required.

2

Supports flowcharts, sequence diagrams, class diagrams, state diagrams, Gantt charts, ER diagrams, and other mermaid diagram types.

3

Diagrams scale to fit the available width without overflowing the layout.

4

You can still comment on mermaid blocks. Select the block's line range and leave feedback about the diagram's structure or content.

Why this matters

AI agents are capable of producing architecture diagrams, sequence flows, and state machines as Mermaid syntax if you ask them to. That's useful, but raw Mermaid text is hard to review. You can read it, but you can't quickly tell whether the flow makes sense until you see the rendered diagram.

When Crit renders the diagram inline, you can review the visual output and the source simultaneously. If the sequence diagram shows the wrong order of events, you select the relevant lines in the source and leave a comment. The agent gets the comment with line numbers pointing to the exact Mermaid code that needs changing.

This is particularly useful for architecture review at the planning stage. Before an agent writes any code, you can ask it to produce a diagram of the proposed approach, review it in Crit, leave comments, and let it revise before implementation starts. Catching structural issues in a diagram is faster than catching them in code.

How Crit compares

Most markdown editors that support Mermaid (GitHub markdown preview, Notion, HackMD) render diagrams in preview mode, but they don't support inline comments on the source. Dedicated diagramming tools like Miro and draw.io don't accept Mermaid input and aren't designed for the write-review-revise loop with an AI agent.

Try it out

Install Crit and start reviewing agent output in seconds.

$ brew install tomasz-tomczyk/tap/crit
then run
$ crit or crit plan.md

Or download a pre-built binary from GitHub Releases.

More features