Mermaid Diagrams
- Desktop, mobile and web
- All plans
What it does
When an agent writes a fenced mermaid block, AgentsRoom draws it as a diagram wherever you read what the agent wrote. A terminal can only print that block as text, so the drawing is done by the app's Markdown reader, from the text, whichever CLI wrote it. The source stays one click away. There is nothing to install or turn on, no skill and no MCP server.
Video (1 min 19 s): Mermaid diagrams, shown in the real app. An agent answers with a flowchart drawn in the conversation, Show code brings its source back, then a Markdown file of the project shows its diagram in the preview.
Where to find it
- In an agent's answer: the floating Conversation button at the top right of the agent's panel. The terminal underneath does not change and still shows the text.
- In a Markdown file: right panel > Files, click the file. A link to the file in the agent's answer, or File > Open File… (Cmd O on macOS, Ctrl O on Windows and Linux), opens the same preview. A file opened in a tab draws its diagrams too.
- Elsewhere: plans in Plan Review, notes, project memory notes, backlog tickets and their comments, and the answers of Ask on the side.
How to use it
- Ask an agent for a diagram in plain words, such as "the login flow as a Mermaid flowchart, left to right".
- Click Conversation to read the answer: the block is a diagram.
- Hover the diagram and click Show code, top right, to read its source. Show diagram brings the drawing back.
An agent writes a diagram line by line: the app waits for the text to hold still before drawing, and keeps the last valid diagram on screen meanwhile.
Settings
None.
Agent tools (MCP)
None. Agents only write the text.
Providers
The diagram is drawn the same way in files, plans, notes and tickets, whichever CLI wrote it. The conversation view exists for the CLIs whose transcript AgentsRoom can read: Claude Code, Codex, Grok Build, Mistral Vibe, oh-my-pi, Pi and Antigravity CLI. With the others, open the Markdown file the agent wrote.
Mobile
Diagrams are drawn in the Conversation view, in side questions and in tickets. Show code sits under the diagram, and a tap opens it full screen with pinch to zoom. A .md file opened in the phone's file viewer still shows as text.
Limits
- The raw terminal of an agent still shows the source.
- A block Mermaid cannot read stays as code, with the line "This diagram could not be drawn: its code is shown instead."
- A very tall diagram, such as a long top-to-bottom flowchart, can be taller than the screen, and Show code at its top right is then out of view until you scroll up. Asking for "left to right" keeps it shorter.
- Diagrams use Mermaid's dark and neutral themes, matched to the light or dark theme of the app, not to your accent color.
- A link inside a diagram opens only an http or https address. A link to a local file does nothing.
- Labels are plain text: HTML and scripts inside a diagram are removed.
- There is no export button. To keep a diagram as a PNG or SVG file, ask the agent to export it with Mermaid's command line tool.
Common questions
- How do I see a Mermaid diagram my agent wrote? The app draws it for you. Click the floating Conversation button at the top right of the agent's panel, or open the Markdown file from the Files tab. Video: https://youtu.be/_Is2i16Rv50
- Can Claude Code render Mermaid diagrams? Not in the terminal, which can only print the block as text. Run the same agent in AgentsRoom and use the conversation view.
- Do I need a Mermaid skill or an MCP server? Not to read the diagrams. A skill can help an agent write valid Mermaid or export an image; AgentsRoom only draws what is already written.
- Which diagram types are drawn? Everything Mermaid 11 draws: flowcharts, sequence, class, state and entity-relationship diagrams, Gantt charts, mind maps, git graphs and the rest of its catalog.
- My diagram shows as code. Why? Its syntax is wrong and the line under it says so. Ask the agent to fix the block: the corrected one is drawn.
- Is there a video that shows it? Yes, 1 min 19 s, in the real app: https://youtu.be/_Is2i16Rv50
Related
- Conversation View: where an agent's answers are drawn.
- File Preview: the Markdown preview of a file, and its PDF export.