@walterra/pi-graphviz

Graphviz DOT diagram extension for pi coding agent - render diagrams as inline terminal images.

Installation

pi install npm:@walterra/pi-graphviz

This installs the package globally and adds it to your pi settings.

Features

• DOT Language: Full support for Graphviz DOT syntax
• Auto Install: Graphviz auto-installed via brew (macOS) or apt/dnf (Linux)
• Multiple Engines: dot, neato, fdp, circo, twopi layout engines
• Inline Display: Diagrams render directly in terminals supporting inline images
• SVG/PNG Output: Save diagrams in either format

Tool: graphviz_chart

Renders a Graphviz DOT specification as a PNG image.

Parameters

| Parameter | Type | Required | Description | | ----------- | ------ | -------- | ------------------------------------------------------ | | dot | string | ✅ | Graphviz DOT specification | | engine | string | | Layout engine: dot (default), neato, fdp, circo, twopi | | width | number | | Output width in pixels | | height | number | | Output height in pixels | | save_path | string | | Optional file path (.png or .svg) |

Example

digraph G {
    rankdir=LR;
    node [shape=box style="rounded,filled" fillcolor=lightblue];

    A [label="Start"];
    B [label="Process"];
    C [label="End" fillcolor=lightgreen];

    A -> B [label="step 1"];
    B -> C [label="step 2"];
}

Use Cases

• Architecture diagrams
• Flowcharts
• State machines
• Dependency graphs
• ER diagrams
• Network topologies

Reference Documentation

See graphviz-reference.md for documentation on:

• DOT language syntax
• All node shapes and edge styles
• Clusters and subgraphs
• Layout engines
• Professional theming
• Common patterns

License

MIT