@walterra/pi-graphviz

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

Installation

``bash
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.

$3

| 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) |

$3

`dot
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