@walterra/pi-graphviz

Graphviz chart extension for pi coding agent - render DOT diagrams as inline images

Packages

Package details

extension

Install @walterra/pi-graphviz from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@walterra/pi-graphviz
Package
@walterra/pi-graphviz
Version
0.0.5
Published
Mar 23, 2026
Downloads
39/mo · 6/wk
Author
walterra
License
MIT
Types
extension
Size
42 KB
Dependencies
1 dependency · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions/graphviz-chart/index.ts"
  ],
  "video": "https://www.rafelsberger.at/assets/pi-graphviz-sm-0001.mp4"
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@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.

Compatibility

  • Tested with pi 0.62.0

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