Mermaid in the terminal shows why agents need plain outputs

Simon Willison found xai-grok-markdown/src/mermaid.rs while exploring the newly open-sourced Grok CLI codebase. The file is a self-contained Rust renderer that turns Mermaid diagrams into Unicode box art, and Willison turned it into a small browser tool via WebAssembly.

Grok CLI shipped a diagram renderer instead of another chat panel

The practical trick is modest but useful: a Mermaid diagram becomes plain text rather than an image. That means it can live in a terminal, an issue, a log or a review thread without needing a browser or a rendering service.

This is not a major product launch. It is a small code discovery from Grok CLI, but it exposes a more interesting pattern: open-source agent tools often reveal their real workflow assumptions in tiny utilities, not in announcement copy.

Developers need diagrams that can be reviewed like code

Mermaid already works as a bridge between documentation and visualization. When an agent can emit it as stable text, the diagram moves from presentation into the working loop. It can be created during a refactor, stored next to a change and discussed in review.

That matters for teams asking agents to explain architecture, not just write code. An output that can be diffed, quoted and archived has more operational value than a polished image trapped in a sandbox.

A clean box drawing still can describe the wrong system

The weak point is not rendering. An agent can draw flawless box art while misunderstanding the codebase. Text improves portability, not truth.

That makes this kind of tool useful as review material rather than authority. The diagram should be evidence in a discussion, not a stamp of correctness.

The next signal is whether agent runtimes make text artifacts standard

The thing to watch is whether agentic IDEs and CLI tools start producing text-native artifacts that can be tested, versioned and pushed through CI. If they do, the shift will be quiet but important: fewer flashy panels, more work products humans can actually inspect.

Lilith's verdict

The interesting part of grok-mermaid is not the diagram. It is the image of an agent leaving a readable sketch on the review table, where humans can argue with it.