runminton/pi-grok-mermaid

This project is an extension for Pi, a terminal based AI assistant tool, that makes Mermaid diagrams show up as readable Unicode diagrams right inside the terminal, instead of just showing raw diagram code as plain text. Mermaid is a common way of describing charts and flowcharts using simple text syntax, and normally a terminal cannot draw those as pictures, it can only show the underlying code. This extension fixes that specifically for Pi. The actual diagram drawing logic is not new work by this project. It comes from xAI's open source Grok Build tool, which already knows how to turn Mermaid text into box style Unicode art inside its own terminal interface. A separate developer, Simon Willison, pulled that specific piece out of Grok Build and compiled it into a standalone WebAssembly module so it could run anywhere, including in a browser. This project takes that same WebAssembly module and wires it into Pi's terminal display, so what was built for one tool now works inside another. Only the visual display layer of Pi is touched. The underlying assistant messages, saved session files, and how the AI model sees the conversation are left completely unchanged, so nothing about how Pi actually works is affected, only how certain diagrams are drawn on screen. If the diagram cannot be rendered for any reason, Pi simply falls back to showing the code as normal text, so nothing breaks. Supported diagram types include flowcharts, sequence diagrams, state diagrams, class diagrams, and entity relationship diagrams. Diagrams that are too wide for the terminal, or diagram types the underlying renderer does not support, fall back to showing the plain text version framed as a code block. You install it through Pi's own extension system, either from npm or directly from GitHub, then restart or reload Pi. It is written in TypeScript, and the vendored diagram renderer itself is licensed under the Apache 2.0 license, with full attribution details kept in the project's vendor folder.